polybar/doc
dvermd 231af35354
feat(ipc): hook, prev, next, reset module actions (#2528)
* WIP ipc actions

* feat(ipc): Add hook, prev, next and reset actions

Closes: #2464

* ipc: format code

* ipc: fix comparison

* Apply suggestions from code review

Co-authored-by: Patrick Ziegler <p.ziegler96@gmail.com>

* ipc: make index 0-based

* ipc: add 0-based indexing breaking change to Changelog

* ipc: restore 1-based index for  and  message

* ipc: fix initial=0 throwing an error

Co-authored-by: Martin Terneborg <martinterneborg@protonmail.com>
Co-authored-by: Patrick Ziegler <p.ziegler96@gmail.com>
2021-10-10 20:22:24 +02:00
..
_static Create default config (#2511) 2021-10-05 13:07:19 +02:00
dev Add items for milestones and readthedocs to release workflow 2021-01-07 20:48:04 +01:00
man Allow running polybar without BAR argument (#2526) 2021-10-07 14:48:47 +02:00
user feat(ipc): hook, prev, next, reset module actions (#2528) 2021-10-10 20:22:24 +02:00
.gitignore build: Allow doc to build as its own project 2019-05-10 08:14:02 +02:00
CMakeLists.txt Create default config (#2511) 2021-10-05 13:07:19 +02:00
README.md refactor(cmake): Allow targets to be enabled individually 2020-12-24 02:20:38 +01:00
conf.py fix(build): Disable sphinx manpage section dirs 2021-05-09 21:28:22 +02:00
config.ini Create default config (#2511) 2021-10-05 13:07:19 +02:00
index.rst Change over all IRC mentions to libera (#2450) 2021-06-16 17:02:58 +02:00

README.md

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.

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.