Kode Sumber

Repositori kode sumber untuk dokumentasi ini.

https://spacecruft.org/aviation/aircraft-moe

Membangun Dokumentasi

Untuk membangun dokumentasi ini secara lokal, lakukanlah seperti ini.

Instalasi Ketergantungan

Instal dependensi, seperti pada Debian:

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

Unduh Dokumentasi Sumber

git clone https://spacecruft.org/aviation/aircraft-moe
cd aircraft-moe/

Pengaturan Python

python -m venv venv
source venv/bin/activate
pip install -U pip poetry
poetry install
poetry update

Bantuan

Untuk bantuan pembuatan, jalankan:

make help

Ini akan menampilkan bantuan ini:

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

Bersih

Bersihkan artefak pembuatan dengan demikian.

make clean

Membuat Dokumentasi HTML

Untuk membangun dokumentasi HTML, jalankan:

make index
make html

HTML yang dihasilkan akan berada di docs/_build/html/ dengan file index.html tingkat atas yang terletak di sini: docs/index.html.

Membuat PDF LaTex

Untuk membangun dokumen PDF dari pembuatan LaTeX, pertama-tama instal dependensi (ini jauh lebih dari yang diperlukan):

sudo apt install texlive-full jabref

Kemudian buat dokumen LaTeX dan PDF:

make latex

PDF yang dihasilkan akan berada di sini: docs/_build/latex/en/zenithstolch750superdutybuild.pdf.

Buat PDF

Untuk membuat dokumen PDF dari LaTeX:

make pdf

PDF yang dihasilkan akan berada di sini: docs/_build/latex/en/zenithstolch750superdutybuild.pdf.

Buku elektronik

Untuk sangat mengurangi ukuran PDF menjadi 150 dpi untuk eBook, jalankan:

make ebook

PDF yang dihasilkan akan berada di sini: docs/_build/latex/en/zenithstolch750superdutybuild-ebook.pdf.

Pra-cetak

Untuk mengurangi ukuran PDF menjadi 300 dpi untuk pencetakan, jalankan:

make prepress

PDF yang dihasilkan akan berada di sini: docs/_build/latex/en/zenithstolch750superdutybuild-prepress.pdf.

Bangun Segalanya

Untuk membangun semuanya, termasuk HTML dan PDF.

make all

Daftar pustaka

Daftar pustaka dapat diedit dengan jabref, seperti:

jabref docs/_source/aircraft-moe.bib