Wow, David! The ability to toggle back and forth between the English and Spanish versions of a lesson by clicking on the little globe icon at the top and selecting the language from a drop-down menu is amazing!
Will this tool that you built also be able to support multiple languages in the future? On Tue, Aug 28, 2018 at 4:11 AM, DVD PS <[email protected]> wrote: > 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 > > -- > Has recibido este mensaje porque estás suscrito al grupo "Latinoamerica" > de Grupos de Google. > Para cancelar la suscripción a este grupo y dejar de recibir sus mensajes, > envía un correo electrónico a [email protected]. > Para publicar en este grupo, envía un correo electrónico a > [email protected]. > Para ver esta conversación en el sitio web, visita > https://groups.google.com/a/carpentries.org/d/msgid/ > latinoamerica/CAD0QkqXHee-_NYtg6m-3noUyja60vAe2N0L2% > 3DFz5C1BQiMskXQ%40mail.gmail.com > <https://groups.google.com/a/carpentries.org/d/msgid/latinoamerica/CAD0QkqXHee-_NYtg6m-3noUyja60vAe2N0L2%3DFz5C1BQiMskXQ%40mail.gmail.com?utm_medium=email&utm_source=footer> > . > ------------------------------------------ The Carpentries: discuss Permalink: https://carpentries.topicbox.com/groups/discuss/Tdb042c4bc0ecf365-Me6ad9a2c50c543503d3f2d89 Delivery options: https://carpentries.topicbox.com/groups/discuss/subscription
