स्रोत कोड

इस दस्तावेज़ के लिए स्रोत कोड भंडार.

ध्यान दें, यह 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

LaTex PDF बनाएँ

LaTeX बिल्ड से PDF दस्तावेज़ बनाने के लिए, पहले निर्भरता स्थापित करें (यह ज़रूरत से ज़्यादा है):

sudo apt install texlive-full

फिर LaTeX और PDF दस्तावेज़ बनाएँ:

make latex

PDF बनाएँ

LaTeX से PDF दस्तावेज़ बनाने के लिए:

make pdf

परिणामी पीडीएफ यहां होगी: docs/_build/latex/en/transpolibre.pdf

ईबुक

किसी ई-बुक के लिए PDF का आकार बहुत कम करके 150 dpi करने के लिए, निम्न को चलाएँ:

make ebook

परिणामी पीडीएफ यहां होगी: docs/_build/latex/en/transpolibre-ebook-en.pdf

प्रीप्रेस

छापने के लिए PDF के आकार को 300 dpi तक कम करने के लिए, निम्न को चलाएँ:

make prepress

परिणामी पीडीएफ यहां होगी: docs/_build/latex/en/transpolibre-prepress-en.pdf

सभी दस्तावेज़ीकरण बनाएँ

HTML और PDF सहित सभी दस्तावेज़ीकरण बनाने के लिए.

make all

अनुवाद

पैकेज अनुवादों को कैसे अपडेट किया जाए, इस पर नोट्स के लिए README.md देखें।