Skip to content
Snippets Groups Projects
  1. Feb 07, 2014
  2. Feb 05, 2014
  3. Feb 04, 2014
  4. Feb 03, 2014
  5. Jan 31, 2014
  6. Jan 30, 2014
  7. Jan 28, 2014
  8. Jan 27, 2014
  9. Jan 24, 2014
  10. Jan 17, 2014
  11. Jan 16, 2014
  12. Jan 14, 2014
  13. Jan 13, 2014
  14. Jan 10, 2014
  15. Jan 01, 2014
  16. Dec 31, 2013
  17. Dec 30, 2013
  18. Dec 27, 2013
  19. Dec 26, 2013
  20. Dec 24, 2013
    • Eugine Blikh's avatar
      ### site building · cd4e3270
      Eugine Blikh authored
      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
      cd4e3270
Loading