--- title: 'Translating Zettlr into Spanish' url: 'https://hiperterminal.com/david/personal/en/blog/2021-12-20-traduciendo-zettlr' markdown: 'https://hiperterminal.com/david/personal/en/blog/2021-12-20-traduciendo-zettlr.md' lang: en date: '2021-12-20' description: 'As a personal project, I want to translate the documentation of this software to make the manual available into Spanish. Here my notes about this experience. Zettlr: a Markdown editor Some years ago I started to use Zettlr as my default Markdown editor. To contribute with its development I want …' taxonomy: category: - blog tag: - Zettlr - 'Spanish translation' - Translation - Zettelkasten - Manual - 'Zettlr translation' - Documentation - 'Spanish documentation' --- # Translating Zettlr into Spanish ## December 20, 2021 As a personal project, I want to translate the documentation of this software to make the manual available into Spanish. Here my notes about this experience. --- ## Zettlr: a Markdown editor ![Zettlr documentation screenshoot](https://hiperterminal.com/david/personal/user/pages/img/zettlr.png "Zettlr documentation screenshoot") Some years ago I started to use Zettlr as my default Markdown editor. To contribute with its development I want to help with the translation of this manual, to see if this enhance the community of Spanish speakers. ## The Github repository ![The Zettlr documentation repository on Github](https://hiperterminal.com/david/personal/user/pages/img/zettlr-github.png) To write this translations collaboratively, the Zettlr community use a repository on Github. In their instructions says you need to clone the repository (which I did and [now it's available here](https://github.com/hiperterminal/zettlr-docs)) and there I started the Spanish version of the Docs. My [favourite software configuration management (SCM) it's Fossil](https://fossil-scm.org/home/doc/trunk/www/index.wiki), you can find it in my book [Estudio Crews en Detalle](https://conector.red/repo/estudiocrews) or [Fundación Conector's website](https://conector.red/). I was struggling a little bit with the codes to clone a repository, add documents and sent my pull request to merge the existing files with those I added in Spanish. ## Translating Zettlr from Zettlr ![Translating Zettlr from Zettlr](https://hiperterminal.com/david/personal/user/pages/img/traduciendo-zettlr.png) I used this markdown editor to translate it. I really liked to read every single section and then try it to see how does it work. I have to confess that [I couldn't customise templates](https://docs.zettlr.com/en/academic/custom-templates/), that means write something in markdown, and export it into a a specific format (PDF for example) with fixed templates like this one using [EB Garamond](http://www.georgduffner.at/ebgaramond/) to get capital letters following a style of a XVI century book. I have no idea how to do that from Zettlr, but at least I can do it directly from Pandoc. I wanted to do this text using inclusive language because in Spanish you can use a masculine or femenine version of certain sentences, and with a decolonial perspective. For me was very strange that this symbol "$" was named "dollars" instead of "pesos" for example, that was a perspective from the Global north in my humble opinion. I used in general a Spanish from Bogota, that can be different for other Spanish speakers for Chile, Argentina or Mexico but give us a sense of the richness of our language. ## Sending my version ![Haciendo un pull request](https://hiperterminal.com/david/personal/user/pages/img/pull-request.png) At the end [I made my pull request](https://github.com/Zettlr/zettlr-docs/pull/124) to include Spanish to the Zettlr documentation manual. I saw a message saying that my version was *Able to merge*. Now I just have to wait the approval and see it online. ## And here it is! ![Zettlr Docs translated to Spanish](https://hiperterminal.com/david/personal/user/pages/img/Zettlr-documentacion-traducida.png)Now you can [read Zettlr Docs in Spanish](https://docs.zettlr.com/) ## Some thanks from the people I didn't expect any comment regarding to the translation, but some people drop a message and that was very nice, or "bacano" as we say in Bogotá. Even from the official Zettlr account on Twitter was mentioned. > Big news! @hiperterminal has taken on themselves the task to translate the full documentation (!) to Spanish, and it's now live! Thanks so much for all your work! 🎉 https://docs.zettlr.com/es/hanks so much for all your work! 🎉 https://docs.zettlr.com/es/ > > @zettlr on [December 28th, 2021](https://twitter.com/zettlr/status/1475814009714712578) Here [the message on Discord](https://discord.com/channels/609436111860793355/924305600853200918/925373083550875688). ![A message on Discord ](https://hiperterminal.com/david/personal/user/pages/img/zettlr-discord.png "A message on Discord") And here [some messages on Telegram in Spanish](https://t.me/PKM_es/11967). ![From a Telegram group (in Spanish)](https://hiperterminal.com/david/personal/user/pages/img/zettlr-telegram.png) --- ## Navigation - Parent: [Blog](https://hiperterminal.com/david/personal/en/blog.md) - Previous: [Wikipedia gender bias a blog post for the IN3](https://hiperterminal.com/david/personal/en/blog/2022-04-07-wikipedia-gender-bias-in3.md) - Next: [Illustration in collaboration](https://hiperterminal.com/david/personal/en/blog/2021-12-13-ilustracion-en-colaboracion.md)