taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

README (1520B)

      1 This repository contains the documentation for all main GNU Taler components.
      2 
      3 To build things on a Debian (-based) system, install these packages:
      4  - make
      5  - python3-sphinx
      6  - python3-myst-parser
      7  - python3-sphinx-book-theme
      8  - python3-sphinx-design
      9  - python3-sphinxcontrib-mermaid
     10  - graphviz
     11  - texlive-latex-extra
     12  - dvipng
     13 
     14 Then, do "make html" for HTML, "make texinfo" for Texinfo, etc.
     15 (Do "make" w/o a target to see a list of possible targets.)
     16 
     17 The output is in subdir ‘_build’.
     18 
     19 Mermaid diagrams use sphinxcontrib-mermaid (packaged in Debian 13 trixie).
     20 HTML output renders them in the browser using JavaScript from the extension's
     21 default CDN. Mermaid CLI is not needed. Put diagrams inside an "only:: html"
     22 directive and include an equivalent prose description for other output formats.
     23 
     24 
     25 Branch ‘prebuilt’ is special.  Its contents (or a subset) are used as
     26 submodules in other Git repos (e.g., Exchange, Merchant, Sync).
     27 
     28 One approach that works well (so far) for ttn is to do
     29 (presuming that the current directory is named ‘docs’):
     30 
     31  $ cd ..
     32  $ git clone -b prebuilt --reference docs \
     33      git+ssh://git@git.taler.net/docs.git \
     34      docs-prebuilt
     35 
     36 This creates Git repo docs-prebuilt as a peer to the current repo.
     37 
     38 This way, you can build in this directory (i.e., "make man" or whatever)
     39 and then copy to ../docs-prebuilt/man/* what files need to be updated.
     40 In that repo, you can commit changes and push to git.taler.net as normal,
     41 all without having to do "git checkout" in either repo.