2020-05-14 15:00:31 +02:00
|
|
|
# Sphinx autodoc
|
|
|
|
|
|
|
|
|
|
Pliki źródłowe do generowania automatycznej dokumentacji kodu za pomocą biblioteki Sphinx.
|
|
|
|
|
|
|
|
|
|
## Wymagania:
|
|
|
|
|
```
|
|
|
|
|
Python 3.x
|
|
|
|
|
sphinx: 4.x
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Ręczne budowanie dokumentacji
|
|
|
|
|
Windows:
|
2020-05-14 15:01:43 +02:00
|
|
|
```shell
|
2020-05-14 15:00:31 +02:00
|
|
|
make.bat html
|
|
|
|
|
```
|
|
|
|
|
Linux/MacOS:
|
2020-05-14 15:01:43 +02:00
|
|
|
```shell
|
2020-05-14 15:00:31 +02:00
|
|
|
make html
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Automatyczne budowanie dokumentacji w PyCharm
|
|
|
|
|
W PyCharmie tworzymy nową konfigurację Python docs -> Sphinx. Jako parametr "input" uswiatiamy ścieżkę do tego folderu,
|
|
|
|
|
a output wskazujemy tam, gdzie chcemy otrzymać gotową dokumentację.
|
