Kaynak Kodu

Bu dokümantasyon için kaynak kod deposu.

https://spacecruft.org/deepcrayon/transpolibre

Not: Bu, transpolibre uygulamasının kendisi için belgelerin nasıl oluşturulacağıdır, transpolibre’nin nasıl kullanılacağı değil.

Belgelendirme Oluştur

Bu dokümantasyonu yerel olarak oluşturmak için, şu şekilde yapın.

Bağımlılıkları Yükle

Debian gibi bağımlılıkları yükleyin:

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

Belge Kaynağını İndir

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

Python’u Kurma

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

Belgelendirme Yapı Yardımı

Belgelendirme oluşturma yardımı için:

make help

Bu yardımın gösterilmesini sağlar:

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

Temiz

Bu şekilde temiz yapı kalıntıları.

make clean

HTML Belgelendirme Oluştur

HTML belgelerini oluşturmak için:

make index
make html

Oluşan HTML dosyaları docs/_build/html/ dizininde olacak ve en üst düzey index.html dosyası burada bulunacak: docs/index.html.

LaTex PDF oluştur

Bir LaTeX derlemesinden bir PDF belgesi oluşturmak için, önce bağımlılıkları yükleyin (bu ihtiyaç duyulan şeyden çok daha fazlasıdır):

sudo apt install texlive-full

Sonra LaTeX ve PDF belgelerini oluşturun:

make latex

PDF oluştur

LaTeX’ten PDF belgesi oluşturmak için:

make pdf

Oluşan PDF burada olacaktır: docs/_build/latex/tr/transpolibre.pdf.

E-Kitap

Bir e-Kitap için PDF’nin boyutunu 150 dpi’ye büyük ölçüde küçültmek için:

make ebook

Oluşan PDF burada olacaktır: docs/_build/latex/tr/transpolibre-ebook-tr.pdf.

Prepress

PDF’nin boyutunu yazdırma için 300 dpi’ye indirmek için:

make prepress

Oluşan PDF burada olacaktır: docs/_build/latex/tr/transpolibre-prepress-tr.pdf.

Tüm Belgeleri Oluştur

HTML ve PDF’ler dahil tüm belgeleri oluşturmak için.

make all

Çeviriler

Paket çevirilerinin nasıl güncelleneceğine dair notlar için README.md dosyasına bakın.