Differences

This shows you the differences between two versions of the page.

--- components:titlebar:index [2025/02/18 13:33] – created admin
+++ components:titlebar:index [2025/07/19 14:58] (current) – external edit 127.0.0.1
@@ Line 3: / Line 3: @@
 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.
+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 for other components, also this bar can be configured in many ways, which is explained in this page:
+<figure>{{:components:titlebar:titlebar-default.png?700|Nuropa Titlebar}}<figcaption>The default titlebar for this site</figcaption></figure>
+As with many other components, also this one has multiple customisation options, which are explained here on this page:
+===== Page headline =====
+What is shown as the main title here is configurable via the “''pageheadline''” option (“What to show in the headline bar of each page?”).
+==== Site name ====
+The default setting is “Site name”, which shows the title specified in the ''[[doku>config:title|title]]'' setting.
+==== Page name ====
+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 [[config:useheading|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”).
+==== Static file ====
+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:
+<file html5 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>
+</file>
+Will end up looking like this:
+<figure>{{:components:titlebar:titlebar-static-file.png?700|Nuropa titlebar with static title}}<figcaption>A titlebar with a static title</figcaption></figure>
+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.
+===== Tagline =====
+The tagline is configured via DokuWiki’s ''[[doku>config:tagline|tagline]]'' option. It is only used if the Page headline (see above) is configured to show the “Site name” or “Page name”.
+===== Breadcrumbs =====
+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.
+===== See also =====
+  * [[banner|Banner bar]]