Skip to content
Snippets Groups Projects
Commit cd4e3270 authored by Eugine Blikh's avatar Eugine Blikh
Browse files

### site building

All layouts are in doc/www-data.in/_layout and are written in Jinja1
(django-like templates). All texts are in doc/www-data.in/_texts

Text files contains YAML files with chunks of markdown strings:
```
$module:
    $uno: |
        some text in markdown
    $dos: |
        it may be multiline
    $tres: |
        # header 1
        ```
        may have some embedded code
        ```
        e.t.c
    ...
```
where `$module` is name of layout file, `$uno`, `$dos`, `$tres`... are
name of parts (template parts `{{ $module.$part }}`)
Site still stores files in `doc/www-data` for copying on server.
Also it integrates documentation (only on stable/master branches) into site (still templlates)
Usage of new `extra/static.py`:
```bash
$ cmake . -DENABLE-DOC=TRUE
$ make
$ cd /doc/www-data.in/
$ ../../extra/static.py site `# build site`
$ ../../extra/static.py docs `# embed docs`
```

 ### documentation building

Add `html-saxon-chunk` and `html-chunk` targets for building chunked
html documentation.

`make` in `doc/user` now builds `html-saxon` and `html-saxon-chunk`
targets
parent 66593343
No related branches found
No related tags found
No related merge requests found
Showing
with 299 additions and 126 deletions
Loading
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment