polybar-dwm/doc
Patrick Ziegler 1168ef36a0
github: Add action to create release archive (#2277)
Whenever a release is published, this action will create a release
archive and update the release body with a download section.

This also integrates the suggestions from #2276

Resolves #2276
2020-12-06 18:16:17 +01:00
..
_static doc: Finish legacy action migration table 2020-11-26 20:53:53 +01:00
dev github: Add action to create release archive (#2277) 2020-12-06 18:16:17 +01:00
man fix(doc): Typo (#2257) 2020-12-01 17:12:02 +01:00
user doc(actions): Point user to doc when using legacy actions 2020-11-26 20:53:53 +01:00
.gitignore
CMakeLists.txt doc: Set SPHINX_BUILD in standalone doc builds 2020-10-03 15:37:17 +02:00
conf.py doc: Allow using rtd theme locally 2020-11-26 20:53:53 +01:00
index.rst doc: Finish legacy action migration table 2020-11-26 20:53:53 +01:00
README.md doc: Update links to https (#2012) 2020-02-21 15:39:39 +01:00

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 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.

Alternatively the documentation can be built without the rest of polybar, for that run cmake only on the doc directory. For example, create a build directory in doc and then run cmake .. in there.

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.