search

godotengine / godot-docs-l10n

Localization of the Godot documentation – Translations should be done on Weblate (see link)
https://hosted.weblate.org/projects/godot-engine/godot-docs/
Other
55 stars 40 forks source link

Update Script: use bash to generate template list #6

Closed Blendify closed 4 years ago

Blendify commented 4 years ago

This simplifies the code and process by not having to build and copy the index.html file

The previous code was also weak because the doc tree in the html file can miss files depending on theme settings such as collapse_navigation and navigation_depth

akien-mga commented 4 years ago

This is not a good change.

I'm parsing index.html not because I couldn't figure out a much cleaner way using bash, but because I want the order to be the one of the table of contents. This way the translation catalog contains all the strings in the same order as the https://docs.godotengine.org/en/stable documentation, which makes it easy for translators to locate pages / translate things in the same order as they read it.

This change would make the order strictly folder/alphabetical based, which is not good.

To be fair, I don't really use this method anymore as I now just sync new templates manually when I update docs. git pull tells me which files have been removed/added and I can then consult the online docs to see where to insert them.