polybar/doc
patrick96 baed54bc76 doc: Improve tray documentation
Unaware users may be confused by why the tray module is not shown in the
default config and if they add it, they may be confused why only one of
their bars shows the module.
2024-08-01 11:09:46 +02:00
..
_static Document recommendations for nerd fonts 2023-09-30 19:32:48 +02:00
_templates docs: Add banner for 'latest' version 2023-10-23 00:32:46 +02:00
dev Version 3.7.0 2023-11-05 23:36:13 +01:00
man Documentation update for 3.6 2022-03-02 14:58:49 +01:00
migration Write migration guide for the content in custom/text 2023-11-05 22:53:09 +01:00
user doc: Improve tray documentation 2024-08-01 11:09:46 +02:00
.gitignore build: Allow doc to build as its own project 2019-05-10 08:14:02 +02:00
CMakeLists.txt Skip manpage and html doc installation if they weren't generated 2022-03-02 23:46:46 +01:00
README.md refactor(cmake): Allow targets to be enabled individually 2020-12-24 02:20:38 +01:00
conf.py doc: Add sphinx 404 page 2023-10-23 00:32:46 +02:00
config.ini doc: Improve tray documentation 2024-08-01 11:09:46 +02:00
index.rst Document recommendations for nerd fonts 2023-09-30 19:32:48 +02:00
requirements.txt fix(doc): Update vulnerable rtd search extension 2024-01-20 17:53:28 +01: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.