Friday, September 22, 2023
doc@conference.yunohost.org
September
Mon Tue Wed Thu Fri Sat Sun
        1
2
3
4
5
6
7 8
9 10
11
12
13 14
15
16 17
18
19
20
21
22
23 24
25
26
27
28
29 30
 
             

[15:22:25] <Salamandar> Hey
[15:22:32] <Salamandar> I "migrated" most of the pages to docusaurus
[15:22:48] <Aleks (he/him/il/lui)> 👀
[15:22:58] <Salamandar> except the difficult things (search for files named `_*`, they are excluded by docusaurus)
[15:24:07] <Salamandar> https://salamandar.github.io/yunodocusaurus/docs/
[15:24:53] <Salamandar> For now the 2 things to fix are :
* markdown headers contain a lot of issues we don't care anymore (though, they don't break anything for now…)
* internal links are 100% broken
[15:27:49] <Salamandar> oh sometimes the index is broken too
[15:27:49] <Salamandar> https://salamandar.github.io/yunodocusaurus/docs/contribute/packaging_apps/resources/packaging_apps_helpers/
[15:28:05] <Salamandar> \/detail /detail /detail /detail /detail /detail /detail /detail /detail LOL
[15:29:38] <Aleks (he/him/il/lui)> oopsies
[15:29:49] <Aleks (he/him/il/lui)> yeah that one is autogenerated, it's not a big deal to adapt the format
[15:33:00] <Salamandar> ah !
[15:33:02] <Salamandar> alright
[15:33:07] <Salamandar> I manually fixed it ><'
[15:33:23] <Salamandar> multiselect in vscode is one of its best features
[15:41:41] <Salamandar> well github pages doesn't want to update
[15:41:45] <Salamandar> but here's how it's looking
[15:42:05] <Salamandar> https://aria.im/_matrix/media/v1/download/matrix.org/RczRduEFDaBLJMPfnmxpDimN
[15:42:11] <Salamandar> not fond of the blue color… but CSS will help
[15:42:54] <Aleks (he/him/il/lui)> huhu
[15:42:57] <Aleks (he/him/il/lui)> yeah that's detail
[15:43:35] <Salamandar> I pushed all my work on the docusaurus branch of my repo, if you want to see how the code is looking
[15:44:20] <Salamandar> Ah also, the git repo tree is a bit different. For grav there is a lot of directories with 1 file inside. I moved those "single files" up one level to reduce the number of directories
[15:54:24] <Salamandar> Also this could be used for the search bar: https://github.com/cmfcmf/docusaurus-search-local
[15:54:47] <Salamandar> it allows to specify "word splitting patterns", and `_` is kinda required for the helpers…
[15:55:27] <Salamandar> https://aria.im/_matrix/media/v1/download/matrix.org/BbdINYxDTAbwNZWtGLBfTMbh
[15:57:35] <Salamandar> The only issue I have for now with Docusaurus is that it doesn't seem to allow to fallback on english for pages not translated
[15:57:49] <Salamandar> so you have to duplicate the english pages to the other languages
[15:58:21] <Salamandar> (that could be workaround by not committing those duplicates to git, as Docusaurus provides a command to regenerate them)
[16:05:03] <Salamandar> OK I was completely mistaken about that. Translation works very fine out of the box.