Membangun Dokumentasi Python di Komputer

Tujuan utama dari penerjemahan berkas ".po" adalah menerjemahkan situs Dokumentasi Python.

Untuk membangun (build) dari berkas-berkas ini agar menjadi dokumentasi lengkap, langkahnya (baru dicoba di sistem operasi Linux dan Mac):

• Ambil skrip pembangun dari git clone git@github.com:python/docsbuild-scripts.git
• Masuk direktori cd docsbuild-scripts
• Buat 3 direktori baru mkdir -p www logs build_root
• Gunakan python terbaru untuk membuat lingkungan virtual python3.7 -m venv build_root/venv/
• Instalasi paket yang dibutuhkan di lingkungan virtual build_root/venv/bin/python -m pip install -r requirements.txt
• Ubah skrip pembangun untuk menambahkan kode terjemahan "id"

LANGUAGES = ["en", "fr", "ja", "ko", "pt-br", "zh-cn", "zh-tw", "id"]
SPHINXOPTS = {
# ... yang ada tidak perlu diubah, tambahkan di akhir, sesuaikan indentasi
    "id": [
        "-D latex_engine=xelatex",
        "-D latex_elements.inputenc=",
        "-D latex_elements.fontenc=",
    ],
}

• Lakukan pembangunan, misalnya untuk branch 3.8 dengan python3.7 ./build_docs.py --quick --build-root build_root --www-root www --log-directory logs --group $(id -g) --skip-cache-invalidation --branch 3.8 --languages id
• Setelah selesai, dokumentasi Python sudah ada di direktori www
• Gunakan fitur web server untuk menelusuri dokumentasi python3.7 -m http.server -d www/
• Buka dokumentasi Python di browser http://127.0.0.1:8000