1
0
Fork 0
mirror of https://github.com/polybar/polybar.git synced 2024-11-11 13:50:56 -05:00
polybar/doc/README.md
patrick96 2c42bae09f refactor(doc): Use cmake APP_VERSION in conf.py
This also moves the doc generation completely into cmake (no more
Makefile).

To generate the docs the project needs to first be configured and then
`make doc` can be run.

The approach used is leaned on the cmake's project own use of Sphinx:
Utilities/Sphinx/CMakeLists.txt
2019-04-05 23:43:37 +02:00

887 B

Polybar Manual

The official polybar documentation lives here.

The html documentation and man pages are built automatically when you build with cmake (cmake creates the custom target doc).

Preview Locally

The documentation uses Sphinx with the "Read The Docs" theme sphinx_rtd_theme to generate the documentation, so you will need to have those installed.

To generate the documentation you first need to configure polybar the same as when you compile it (cmake .. in build folder). After that you can run make doc to generate all of the documentation or make doc_html or make doc_man to only generate the html documentation or the man pages.

Open build/doc/html/index.html to read the documentation in the browser.

The manual pages are placed in build/doc/man.