Hello everyone!! TLDR; see the English/Spanish git-lesson: https://swcarpentry-i18n.github.io/git-novice/ - There are some identified problems, but if you find a new one, please, create an issue <https://github.com/swcarpentry-i18n/carpentry-theme/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc> .
The translation of the lessons is something where I think we can produce much more impact than what we have already achieved. Last year some people from the Latino American community did a great effort and fully translated a few lessons into Spanish <https://github.com/swcarpentry?utf8=%E2%9C%93&q=-es&type=&language=>. However, the way translations are maintained is not optimal while at the same time it doesn't get the same visibility than the English lessons. So, over the last months, I've been working to get something that eases the work of the translators and provides all the languages the same visibility - i.e. one page for all! I have managed to do that as follows: 1.- Create a jekyll theme for the carpentries. Instead of making every lesson to merge with upstream (and solve conflicts), we can use a repository for the theme and keep the lessons clean with only the material. Discussed in styles#229 <https://github.com/carpentries/styles/issues/229>. There it details some advantages. 2.- Modify the English text on that theme to variables/tokens, and include them as assets for each of the language translated. There's a PR to the themed style (carpentry-theme#4 <https://github.com/swcarpentry-i18n/carpentry-theme/pull/4>) 3.- Cleaned the git-lesson of all that's not needed, and create a submodule with the automatically generated material from the translation tool. The original lesson material gets converted into a po file using a tool I've adapted for that purpose <https://github.com/swcarpentry-i18n/po4gitbook>. Such file can be used with translation tools (e.g., poedit, weblate) and the resultant gets converted into markdown. The idea is that such process gets done automatically in Travis once the translations have been accepted by the translation team. I'll keep working on the automated process during the following weeks and show it up once it's completed. An example of the final result is in https://swcarpentry-i18n.github.io/git-novice/ - There are still few issues <https://github.com/swcarpentry-i18n/carpentry-theme/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc>, and there are more little things I keep finding that needs to be improved. But I wanted to let you all know that this is almost there, and by using themes I think it will not oly help the translators but the maintanence of the normal lessons. If you want to give me a hand, don't doubt it for a second! I will really appreciate it. Cheers, David ------------------------------------------ The Carpentries: discuss Permalink: https://carpentries.topicbox.com/groups/discuss/Tdb042c4bc0ecf365-M4af7f5aacb85f87713e0c100 Delivery options: https://carpentries.topicbox.com/groups/discuss/subscription
