Código fuente

Repositorio del código fuente para esta documentación.

https://spacecruft.org/deepcrayon/transpolibre

Tenga en cuenta que esto es cómo construir la documentación para la propia aplicación transpolibre, no cómo usar transpolibre.

Construir documentación

Para construir esta documentación localmente, haga lo siguiente.

Instalar dependencias

Instale las dependencias, tal como se hace con Debian:

sudo apt update
sudo apt install python-is-python3 python3-pip python3-venv

Descargar documentación Fuente

git clone https://spacecruft.org/deepcrayon/transpolibre
cd transpolibre/

Configuración de Python

python -m venv venv
source venv/bin/activate
pip install -U pip setuptools wheel

Ayuda para la compilación de documentación

Para obtener ayuda sobre la compilación de la documentación, ejecute:

make help

Esto mostrará esta ayuda:

Please use 'make <target>' where <target> is one of
  clean                Remove all build files and directories (including translations)
  all                  Clean and make all targets
  gettext_build        Build localisation strings for translation
  update_locale        Update localisation
  update_locale_<lang> Update localisation for <lang>
  html                 Build the HTML documentation for all languages
  html_<lang>          Build HTML documentation for <lang>
  latex                Build the documentation using LaTeX for all languages
  latex_<lang>         Build the documentation using LaTeX for <lang>
  pdf                  Build the PDF documentation using LaTeX for all languages
  pdf_<lang>           Build the PDF documentation using LaTeX for <lang>
  ebook                Reduce size of PDF for eBook
  prepress             Reduce size of PDF for prepess
  index                Copy static docs/index.html to docs/_build/html/index.html
  translations         Translate from English

Limpio

Limpie los artefactos de compilación de esta manera.

make clean

Generar documentación HTML

Para construir la documentación HTML, ejecute:

make index
make html

El HTML resultante estará en docs/_build/html/ con un archivo index.html de nivel superior ubicado aquí: docs/index.html.

Crear un PDF de LaTex

Para construir un documento PDF a partir de una compilación de LaTeX, primero instale las dependencias (esto es mucho más de lo necesario):

sudo apt install texlive-full

Luego, construya los documentos LaTeX y PDF:

make latex

Crear PDF

Para crear un documento PDF a partir de LaTeX:

make pdf

El PDF resultante estará aquí: docs/_build/latex/es/transpolibre.pdf.

Libro electrónico

Para reducir considerablemente el tamaño del PDF a 150 dpi para un eBook, ejecute:

make ebook

El PDF resultante estará aquí: docs/_build/latex/es/transpolibre-ebook-es.pdf.

Preimpresión

Para reducir el tamaño del PDF a 300 dpi para imprimir, ejecute:

make prepress

El PDF resultante estará aquí: docs/_build/latex/es/transpolibre-prepress-es.pdf.

Generar toda la documentación

Para compilar toda la documentación, incluidos los archivos HTML y PDF.

make all

Traducciones

Consulte «README.md» para obtener notas sobre cómo actualizar las traducciones de paquetes.