HOWTO.md

   1 # Este archivo
   2
   3 Es simplemente un volcado del cerebro de Gunnar, siendo hoy el 9 de
   4 junio de 2017, 19:45 GMT-5, para no olvidar el camino ya recorrido.
   5
   6 # ¿Cómo construir este proyecto?
   7
   8 Estamos en las etapas iniciales para echar a andar la infraestructura,
   9 pero ya no quiero que esto viva únicamente en mi computadora personal.
  10
  11 ¿Cómo generé los archivos que estoy subiendo en este momento?
  12
  13 ## Primero, el .odt
  14
  15 No creo que un odt sea la forma ideal para trabajar este proyecto,
  16 pero a partir de las conversaciones que he tenido con Sarah,
  17 probablemente sea lo mejor que tenemos. Preferiría partir del EPUB
  18 oficial, pero la conversión lleva mucho más "ruido".
  19
  20 El .odt que estoy incluyendo aquí lo obtuve de la liga que aparece en
  21 la [página del libro](https://madewith.cc/) como
  22 [versión editable del libro (GDoc)](https://docs.google.com/document/d/1c2BXTQcWZrtW99GlGmv3waXy3AVpV-Biifw4NdDwMZg/edit#heading=h.3s5bd22z8pw5). Sé
  23 que esta _no es estable_ (es siempre la «most up-to-date version»),
  24 asi que me gustaría hacerme de un mejor punto de partida.
  25
  26 ## Conversión a Markdown
  27
  28 Empleo Pandoc:
  29
  30     pandoc -f odt MadewithCreativeCommonsmostup-to-dateversion.odt -t markdown > MadewithCreativeCommonsmostup-to-dateversion.md
  31
  32 ## Extracción de cadenas para la traducción
  33
  34 Para generar un archivo template para Gettext, usé
  35 «[PO for anything](https://po4a.alioth.debian.org/)» (po4a),
  36 particularmente la herramienta `po4a-gettextize`:
  37
  38     po4a-gettextize -f text -m MadewithCreativeCommonsmostup-to-dateversion.md -p MadewithCreativeCommonsmostup-to-dateversion.po -M utf-8
  39
  40 ## Editar el Gettext
  41
  42 Utilicé la herramienta `poedit`, que he usado para traducir
  43 programas. No creo que sea la herramienta definitiva; voy a hablar con
  44 Michal Cihar para pedirle que nos hospede la traducción en
  45 [Weblate](https://weblate.org/en), un servicio de traducción en línea
  46 basado en infraestructura y software libre, y que presenta muchas de
  47 las características que buscamos.