Titlebar

As the name suggests, this is the header section that contains the main title.

In the default settings, this is the big blue bar with the site title (“nuropa” for this site) and the site’s tagline underneath:

As with many other components, also this one has multiple customisation options, which are explained here on this page:

What is shown as the main title here is configurable via the “pageheadline” option (“What to show in the headline bar of each page?”).

The default setting is “Site name”, which shows the title specified in the title setting.

An alternative is to use “Page name” which uses the first headline in your page as the title to be shown here. This works similar to DokuWiki’s own useheading mechanics (which should be configured to “always” for consistency).

This will then also hide the first <h1> heading in the page content. It is generally a good practice to start each page with a main headline, but in this case this becomes compulsory.

In case the page title can not be determined, this shows the pageId instead (e.g. “components:titlebar:index”).

The option “Static file” finally allows to use a file hook instead of one of the pre-defined headlines. Use the file name “title.html” to provide a static HTML snippet instead.

For example, the following snippet:

title.html

 <div style="border:red dashed 1px;">
   <h1>Static Headline</h1>
   <p class="tagline">This headline is in a static <abbr>HTML</abbr> file.</p>
 </div>

Will end up looking like this:

Obviously, this makes more sense if it doesn’t just replicate one of the built-in options but if you design a headline that is specific to your site.

The tagline is configured via DokuWiki’s tagline option. It is only used if the Page headline (see above) is configured to show the “Site name” or “Page name”.

Optionally, the site breadcrumbs (both the DokuWiki “breadcrumbs” and what is called in the configuration the “You are here” navigation) can be shown above the main title here.

This is managed via the “youareherepos” configuration option.

• Banner bar