---json
{
    "aliases": [
        { "path": ":docs:theme:theme" }
    ],
    "page_id": "4h63iu5bv3rvsullssr4j",
    "template": "holy"
}
---
====== Theme ======



{{:docs:theme:undraw_dark_mode_2xam.svg?0x300|}}


===== About =====
A ''theme'' designs your entire [[:docs:app:app|website app]].


A theme is composed of:
  * [[:docs:theme:template:template|templates]]. Each template applies to one page and [[docs:theme:element:element|designs a layout]].
  * [[docs:theme:component-stylesheet|component styling]]


You can apply:
  * a [[docs:theme:bootstrap|bootstrap stylesheet]] or create [[howto:bootstrap-custom|create and add your own]].
  * and [[docs:theme:branding-colors|branding colors (primary/secondary)]]

===== Features =====

All themes support the following features:
  * one [[:docs:theme:template:template|template layout]] by page.
  * [[docs:performance:cdn|Serve the Bootstrap files by default from a CDN]]
  * Support [[docs:app:tagline|tagline]]
  * [[docs:styling:scale|Size Scale configuration (font and spacing)]]
  * [[howto:getting_started:6_favicon|Favicon]]: Recognized the [[howto:getting_started:6_favicon|favicons]]  (included ''android-chrome-192x192.png'')
  * [[docs:utility:shortcut]]
  * [[docs:theme:element:railbar|Railbar Menu (Page, User Site) with a private option]]


===== Customization =====

==== Via the Slot System ====

Via the [[:docs:theme:slot:slot|slot system]], you can change the content of [[docs:theme:element:element|template region]] by creating a wiki page with a specific name called a slot.


==== By creating your own theme ====

For more advanced usage, you can:
  * create your own theme,
  * add or customize templates and [[docs:theme:component-stylesheet|components stylesheet]]

[[howto:theme-creation]]






===== Configuration =====

==== How can you choose your theme? ====

You can choose your theme by modifying the ''theme'' value in the [[:docs:app:configuration|app configuration]].


==== Disable ====

You can disable the theme functionality with the [[:docs:app:configuration|configuration]] ''combo-conf-001'' and use the DokuWiki template engine instead.