mirror of
https://github.com/polybar/polybar.git
synced 2024-11-11 13:50:56 -05:00
c24a6999a4
Each major target of polybar can now be enabled/disabled while configuring (even polybar itself). The cmake code specific to each target will only run if the target is enabled. This allows us to for example just build the documentation without having to run all the cmake code related to compilation or having the polybar dependencies installed (other than sphinx).
19 lines
890 B
Markdown
19 lines
890 B
Markdown
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](https://www.sphinx-doc.org/en/stable/) to generate the documentation, so you will need to
|
|
have that installed.
|
|
|
|
If you build polybar normally while having Sphinx installed during configuration, the documentation will be enabled and
|
|
built as well. Building the documentation can be disabled by passing `-DBUILD_DOC=OFF` to `cmake`.
|
|
|
|
Once configured, all of the documentation can be generated with `make doc` or use `make doc_html` or `make doc_man` to
|
|
only generate the html documentation or the man pages respectively.
|
|
|
|
The HTML documentation is in `doc/html/index.html` in your build directory and the man pages are in `doc/man`.
|