رمز المصدر

مستودع شفرة المصدر لهذه الوثيقة.

https://spacecruft.org/deepcrayon/transpolibre

لاحظ، هذه هي كيفية إنشاء الوثائق لتطبيق transpolibre نفسه، وليس كيفية استخدام transpolibre.

بناء الوثائق

لإنشاء هذه الوثائق محليًا، قم بذلك.

قم بتثبيت التبعيات

قم بتثبيت الإضافات، مثلما هو الحال مع دبيان:

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

تحميل الوثائق المصدر

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

إعداد بايثون

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

بناء الوثائق المساعدة

للحصول على مساعدة في بناء الوثائق، قم بتشغيل:

make help

سيُعرض هذا الدعم:

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

نظيف

قم بتنظيف نتاجات البناء على هذا النحو.

make clean

بناء وثائق HTML

لإنشاء وثائق HTML، قم بتشغيل:

make index
make html

سيكون HTML الناتج في docs/_build/html/ مع وجود ملف index.html في أعلى المستوى هنا: docs/index.html.

بناء ملف PDF من LaTex

لإنشاء مستند PDF من بنية LaTeX، قم أولاً بتثبيت التبعيات (وهو أكثر بكثير مما هو مطلوب):

sudo apt install texlive-full

ثم قم بتجميع وثائق لاتايكس وبي دي اف:

make latex

بناء ملفات PDF

لإنشاء مستند PDF من LaTeX:

make pdf

سيكون ملف PDF الناتج هنا: docs/_build/latex/en/transpolibre.pdf.

كتاب إلكتروني

لتقليل حجم ملف PDF إلى 150 نقطة في البوصة لكتاب إلكتروني، قم بتشغيل:

make ebook

سيكون ملف PDF الناتج هنا: docs/_build/latex/en/transpolibre-ebook-en.pdf.

مرحلة ما قبل الطباعة

لتقليل حجم ملف PDF إلى 300 نقطة في البوصة للطباعة، قم بتشغيل:

make prepress

سيكون ملف PDF الناتج هنا: docs/_build/latex/en/transpolibre-prepress-en.pdf.

بناء جميع الوثائق

لإنشاء جميع الوثائق، بما في ذلك HTML وPDF.

make all

الترجمات

راجع README.md للحصول على ملاحظات حول كيفية تحديث ترجمات الحزمة.