Codice sorgente

Repository del codice sorgente per questa documentazione.

https://spacecruft.org/deepcrayon/transpolibre

Nota, questo è il modo per costruire la documentazione per l’applicazione transpolibre stessa, non il modo per usare transpolibre.

Costruisci la documentazione

Per costruire questa documentazione localmente, fate così.

Installare le dipendenze

Installare le dipendenze, come con Debian:

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

Scarica la documentazione Fonte

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

Configurazione di Python

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

Documentazione Build Aiuto

Per assistenza alla compilazione della documentazione, eseguire:

make help

Questo comando visualizza questo aiuto:

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

Pulito

In questo modo, gli artefatti di build vengono puliti.

make clean

Costruisci la documentazione HTML

Per costruire la documentazione HTML, eseguire:

make index
make html

Il codice HTML risultante sarà in docs/_build/html/ con un file index.html di primo livello che si trova qui: docs/index.html.

Costruisci LaTex PDF

Per costruire un documento PDF da un file LaTeX, prima installate le dipendenze (questo è molto più di quanto necessario):

sudo apt install texlive-full

Quindi costruite i documenti LaTeX e PDF:

make latex

Crea PDF

Per creare un documento PDF da LaTeX:

make pdf

Il PDF risultante sarà qui: docs/_build/latex/en/transpolibre.pdf.

eBook

Per ridurre drasticamente le dimensioni del PDF a 150 dpi per un eBook, eseguire:

make ebook

Il PDF risultante sarà qui: docs/_build/latex/en/transpolibre-ebook-en.pdf.

Prepress

Per ridurre le dimensioni del PDF a 300 dpi per la stampa, eseguire:

make prepress

Il PDF risultante sarà qui: docs/_build/latex/en/transpolibre-prepress-en.pdf.

Compila tutta la documentazione

Per costruire tutta la documentazione, compresi i file HTML e PDF.

make all

Traduzioni

Per informazioni su come aggiornare le traduzioni dei pacchetti, vedere README.md.