Searchbar

The page searchbar is the section below the site toolbar, containing the site logo and the search field.

In the simplest form, it can look like this:

The site logo on the left-hand side of the search bar can be customised:

Use the Media Manager to upload an PNG or SVG image with the name “logo” (i.e. use “logo.svg” or “logo.png”) to either the root, or to the “wiki” directory.

Or save a static HTML snippet with the name “sitelogo.html” in the wiki’s conf/ directory and change the sitelogo setting (“How should the site logo be displayed?”) to “Static file”.

In either case, please make sure that the dimensions of the logo fit the available space. Use the template image (shown here and by default) as an example.

DokuWiki’s own search functionality is actually pretty good, and already for this reason it should not be hidden away but presented to visitors in the most inviting way.

The search field you see in the middle of the aptly named “Searchbar” is just the “inactive” state of the search widget. The moment the user activates it – typically by clicking into the search field – it changes to take centre-stage on the page:

In this mode, the web page content is overlaid (and blurred), so the user focusses on the search instead (a click to the background, or pressing the Escape key will of course return everything to the normal state).

More information on the search functionality in an upcoming article…