02. Customization

02.01. Site Identity

You can change the logo, favicon and apple touch icon the same way as for the dokuwiki template.

If you enable doLogoChangesByNamespace in the template's configuration, Writr will use the closest logo as the site logo. Namespace Logos can be added using the media library. To show a different logo in a namespace, just make sure to add the custom logo.png in the namespace. This feature is recursive.

Namespace URL

If you enable doLogoLinkChangesByNamespace in the template's configuration, Writr will set the logo's url to the same namespace it found the logo.

Site Title

If you enable doTitleChangesByNamespace in the template's configuration, Writr will set the title found in the closest nstitle.txt page.

Site Tagline

If you enable doTaglineChangesByNamespace in the template's configuration, Writr will set the title found in the closest nstagline.txt page.

This templates supports multiple levels of a navigation. For that to work you need to add a page called topnav and add a list of links to it. (No other content is supported.) The example in the screenshot uses this as the content for the topnav page:

topnav.txt
~~NOCACHE~~
  * [[:start|Home]]
  * [[wiki:DokuWiki]]
    * [[wiki:Syntax]]
  * [[:Sample Page]]

The content of a standard sidebar as configured in Configuration Setting: sidebar will be added between the navigation and the tools list.

02.04. Included Hooks

Include hooks allow you to add additional HTML or PHP to the template without modifying any of the template files themselves. This template supports the same include hooks as the dokuwiki template.

02.05. Color Schemes

The original WordPress theme came with 6 different colour schemes. Those can easily be achieved by changing the theme_color and theme_color_alt values in your local style.ini to the following:

Color Scheme theme_color theme_color_alt
Turquois #1abc9c #16a085
Red #e74c3c #c0392b
Purple #a162ba #8e44ad
Grey #95a5a6 #7f8c8d
Green #2ecc71 #27ae60
Blue #3498db #2980b9

This should actually be done in the styling plugin over the admin interface. No need to go out of your way to edit style.ini.

02.06. Content Width

The width of the content area can be adjusted with the content_width variable in the style.ini. Since DokuWiki version 2015-08-10 “Detritus” you can do that more easily with the styling plugin over the admin interface. This is limited to px size.

Full Width

If you enable makeFullWidth in the template's configuration, Writr will use content_border as the right border of the content.

02.07. ToolBar

If you enable useToolbar in the template's configuration, Writr will use a page called topbar to setup the toolbar. This toolbar support the same formatting as the Navigation topnav page.

topbar.txt
~~NOCACHE~~
  * [[info@domain.com]]

02.08. Tooltips

If you enable useTooltips in the template's configuration, Writr will use create stylish tooltips to replace the default browser tooltips.