Shellmiao 9279d1873b Add projects 1 рік тому
..
css 9279d1873b Add projects 1 рік тому
docker 9279d1873b Add projects 1 рік тому
js 9279d1873b Add projects 1 рік тому
theme 9279d1873b Add projects 1 рік тому
README.md 9279d1873b Add projects 1 рік тому
gen_params_doc.py 9279d1873b Add projects 1 рік тому
hook.py 9279d1873b Add projects 1 рік тому
requirements.txt 9279d1873b Add projects 1 рік тому

README.md

Build

prepare

We use setup.py to hook docs generation in readthedocs, just run

python doc/mkdocs/setup.py 

use docker

At repo root, execute

docker run --rm -it -p 8000:8000 -v ${PWD}:/docs sagewei0/mkdocs  

to serve docs in http://localhost:8000

or

docker run --rm -it -p 8000:8000 -v ${PWD}:/docs sagewei0/mkdocs build

to build docs to site folder.

manually

mkdocs-material and servel plugins are needed to build this docs

Fisrt, create an python virtual environment

python3 -m venv "fatedocs"
source fatedocs/bin/activate
pip install -U pip

And then install requirements

pip install -r doc/mkdocs/requirements.txt

Now, use

mkdocs serve

at repo root to serve docs or

use

mkdocs build

at repo root to build docs to folder site

Develop guide

We use mkdocs-material to build our docs. Servel markdown extensions are really useful to write pretty documents such as admonitions and content-tabs.

Servel plugins are introdused to makes mkdocs-material much powerful:

macro extension

include examples

<!-- {% include-examples "<name>" %} -->

extract all components's examples(pipeline, dsl v1, dsl v2) from examples folder

include example

<!-- {% include-example "???" %} -->

extract source code ??? from repo.