rougail/docs
2025-11-19 07:57:01 +01:00
..
_static proxymode 2025-02-21 07:23:52 +01:00
ext replace httpx with the requests stdlib 2024-10-16 13:24:14 +02:00
images add image 2025-09-29 16:59:25 +02:00
install update requirements.txt 2025-11-08 10:32:32 +01:00
library added git repo links 2025-11-07 09:05:44 +01:00
tutorial unexisting file (need to raise a warning with extinclude) 2025-11-19 07:57:01 +01:00
user_datas user datas 2025-11-05 08:59:46 +01:00
.gitignore update tutorial 2024-10-14 14:05:23 +02:00
check.rst doc(typo): wrong image relative path 2025-10-27 18:22:40 +01:00
cli.rst add pages 2025-09-29 16:58:12 +02:00
concepts.rst getting started removal 2025-11-06 11:46:31 +01:00
condition.rst feat: suffixes in dynamic family should be a jinja function (#5) 2024-10-14 14:14:00 +02:00
conf.py doc(typo): YAML sphinx coding standards 2025-10-29 17:18:55 +01:00
configuration.rst feat: documentation 2023-12-17 20:42:03 +01:00
developer.rst pre-commit developer docs 2024-10-14 14:14:00 +02:00
dict_convention.rst getting started removal 2025-11-06 11:46:31 +01:00
documentation.rst doc(typo): YAML sphinx coding standards 2025-10-29 17:18:55 +01:00
family.rst proxy mode tutorial 2025-02-20 14:23:34 +01:00
fill.rst feat: number => integer in documentation 2025-10-26 13:31:47 +01:00
gettingstarted.rst getting started removal 2025-11-06 11:46:31 +01:00
index.rst renaming structure files 2025-11-06 11:49:14 +01:00
install.rst third party libraries 2025-11-07 22:02:28 +01:00
Makefile user datas 2025-11-05 08:59:46 +01:00
readme.txt delete httpx requirement 2024-10-16 13:25:30 +02:00
relative_path.rst relative path 2025-10-27 09:20:33 +01:00
requirements.txt feat: documentation 2023-12-17 20:42:03 +01:00
rw_ro_modes.rst add pages 2025-09-29 16:58:12 +02:00
structfile.rst added git repo links 2025-11-07 09:05:44 +01:00
tags.rst feat: tags 2025-10-26 14:31:48 +01:00
variable.rst moving the type definition in the variable's page instead of the tutorial 2025-11-08 09:45:56 +01:00

Building the doc locally
============================

install
---------

First, install a python virtual environment::

    python -m venv .venv
    source .venv/bin/activate

Then install the sphinx libraries::

    ./.venv/bin/pip3 install sphinx
    ./.venv/bin/pip3 install sphinx_rtd_theme
    ./.venv/bin/pip3 install sphinx_lesson


The generatef html output is located in the `docs/build/html` subfolder,
you can modify the target or the output type in the :file:`docs/Makefile`.

scraps
---------

`variable <https://en.wikipedia.org/wiki/Variable_(computer_science)>`_