1
0
Fork 0
mirror of https://github.com/pgpainless/pgpainless.git synced 2024-12-28 13:57:58 +01:00
pgpainless/docs/README.md

32 lines
940 B
Markdown
Raw Normal View History

2022-07-06 23:56:41 +02:00
# User Guide for PGPainless
Documentation for PGPainless is built from Markdown using Sphinx and MyST.
A built version of the documentation is available on http://pgpainless.rtfd.io/
## Useful resources
* [Sphix Documentation Generator](https://www.sphinx-doc.org/en/master/)
* [MyST Markdown Syntax](https://myst-parser.readthedocs.io/en/latest/index.html)
2022-07-06 23:56:41 +02:00
## Build the Guide
To build:
2022-07-06 23:56:41 +02:00
```shell
$ make {html|epub|latexpdf}
```
2022-09-05 13:28:00 +02:00
Note: Diagrams are currently not built from source.
Instead, pre-built image files are used directly, because there are issues with mermaid in CLI systems.
If you want to build the diagrams from source, you need `mermaid-cli` to be installed on your system.
2022-07-06 23:56:41 +02:00
```shell
$ npm install -g @mermaid-js/mermaid-cli
2022-07-06 23:56:41 +02:00
```
2022-09-05 13:28:00 +02:00
You can then use `mmdc` to build/update single diagram files like this:
```shell
mmdc --theme default --width 1600 --backgroundColor transparent -i ecosystem_dia.md -o ecosystem_dia.svg
```