--- title: 'Traduint Zettlr' url: 'https://hiperterminal.com/david/personal/ca/blog/2021-12-20-traduciendo-zettlr' markdown: 'https://hiperterminal.com/david/personal/ca/blog/2021-12-20-traduciendo-zettlr.md' lang: ca date: '2021-12-20' description: "Com a projecte personal, m'agradaria traduir la documentació d'aquest programari perquè el manual estigui disponible en castellà. Aquí les meves notes sobre aquesta experiència. Zettlr: un editor de markdown Fa uns anys vaig començar a utilitzar Zettlr com a editor de markdown. Per contribuir al…" taxonomy: category: - blog tag: - Zettlr - Castellà - Espanyol - Traducció - Zettelkasten - Manual - 'Zettlr traduït' - 'documentació en espanyol' --- # Traduint Zettlr ## Desembre 20, 2021 Com a projecte personal, m'agradaria traduir la documentació d'aquest programari perquè el manual estigui disponible en castellà. Aquí les meves notes sobre aquesta experiència. --- ## Zettlr: un editor de markdown ![Captura de pantalla de la documentació de Zettlr](https://hiperterminal.com/david/personal/user/pages/img/zettlr.png) Fa uns anys vaig començar a utilitzar Zettlr com a editor de markdown. Per contribuir al seu desenvolupament vull aportar la traducció del seu manual d'ús, per veure si d'aquesta manera la comunitat d'usuaris hispanoparlants creix. ## El repositori a Github ![El repositori de Documentació de Zettlr a Github](https://hiperterminal.com/david/personal/user/pages/img/zettlr-github.png) Perquè aquesta traducció pugui fer-se a diverses mans, la comunitat de Zettlr utilitza un repositori a GitHub. En les seves instruccions diuen que cal clonar el repositori (cosa que vaig fer i ara [es troba en aquest altre lloc](https://github.com/hiperterminal/zettlr-docs)) i allà vaig començar a pujar la versió en castellà de la documentació. El meu [programari de control de versions preferit és Fossil](https://fossil-scm.org/home/doc/trunk/www/index.wiki), cosa que es pot veure en publicacions com l'[Estudi Crews en Detall](https://conector.red/repo/estudiocrews) o [el lloc de Conector](https://conector.red/). Em va costar una mica aprendre els codis per copiar el repositori, pujar les modificacions que proposava i finalment fer un enviament per barrejar els arxius que existien amb els que jo estava afegint en castellà. ## Traduint Zettlr des de Zettlr ![Traduint Zettlr des de Zettlr](https://hiperterminal.com/david/personal/user/pages/img/traduciendo-zettlr.png) Vaig fer servir l'editor de text per fer les traduccions. Una cosa que em va agradar va ser llegir cada una de les seccions i aplicar allò que allà s'explicava per veure com funcionava i alhora provar-ho pel meu compte. He de confessar que l'únic que no vaig poder fer va ser [personalitzar les plantilles dels arxius exportats](https://docs.zettlr.com/en/academic/custom-templates/), això vol dir que quan escric alguna cosa, puc exportar-la en un format (per exemple PDF) però amb diversos estils i plantilles específiques, per exemple utilitzant l'estil [EB Garamond](http://www.georgduffner.at/ebgaramond/) perquè el teu PDF tingui estils d'un llibre del segle XVI, capitalitzant la primera lletra d'un paràgraf. No vaig saber com fer-ho des de Zettlr, però al cap i a la fi sé fer-ho amb Pandoc. Volia que aquest text fes servir llenguatge inclusiu i que alhora tingués una perspectiva decolonial. Em semblava molt estrany, per exemple, que aquest signe "$" es traduís com el signe dòlar, cosa que és una perspectiva molt nord-americana i del Nord global del llenguatge. Vaig usar un castellà molt de Bogotà que pot sonar estrany per a gent de Xile, Argentina o Mèxic però que alhora dóna compte de la riquesa de la nostra llengua. ## Enviant els meus avenços ![Fent un pull request](https://hiperterminal.com/david/personal/user/pages/img/pull-request.png) Al final [vaig fer un *pull request*](https://github.com/Zettlr/zettlr-docs/pull/124) per sol·licitar que la meva traducció s'inclogués al lloc de la documentació de Zettlr. Apareixia un missatge que deia que els canvis que proposava es podien barrejar amb un *Able to merge*, és a dir que allò en què estava treballant no es superposava sobre la feina d'algú altre en aquesta comunitat. Ara només resta esperar que s'aprovi aquesta versió i es publiqui. ## I aquí està ![Documentació de Zettlr traduïda al castellà](https://hiperterminal.com/david/personal/user/pages/img/Zettlr-documentacion-traducida.png)Pots [consultar la traducció a Zettlr Docs](https://docs.zettlr.com/) ## Alguns agraïments Tot i que no esperava cap tipus de comentari sobre això, algunes persones van manifestar el seu agraïment, va ser molt bacà. Fins i tot des del compte oficial de Twitter ho van anunciar. > 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/ > > (¡Grandes noticias! @hiperterminal ha pres sobre si mateix la tasca de traduir la documentació completa (!) al castellà, i ara està en línia! Moltes gràcies per tota la teva feina!) 🎉 https://docs.zettlr.com/es/ > > @zettlr el [28 de desembre de 2021](https://twitter.com/zettlr/status/1475814009714712578) Aquí [l'anunci a Discord](https://discord.com/channels/609436111860793355/924305600853200918/925373083550875688). ![Anunci al Discord de Zettlr ](https://hiperterminal.com/david/personal/user/pages/img/zettlr-discord.png "Anunci al Discord de Zettlr") I per aquí [alguns missatges a Telegram](https://t.me/PKM_es/11967). ![Missatges d'agraïment a Telegram](https://hiperterminal.com/david/personal/user/pages/img/zettlr-telegram.png) --- ## Navigation - Parent: [Blog](https://hiperterminal.com/david/personal/ca/blog.md) - Previous: [Bretxa de gènere a Wikipedia — un post a l'IN3](https://hiperterminal.com/david/personal/ca/blog/2022-04-07-wikipedia-gender-bias-in3.md) - Next: [Il·lustració en col·laboració](https://hiperterminal.com/david/personal/ca/blog/2021-12-13-ilustracion-en-colaboracion.md)