Topbarrr modificat'n

Th' theme comes wit' a reasonably configured topbar.

Nevertheless, yer requirements may differ from this configurat'n. Luckily th' theme got ye covered as th' themebar, its buttons an' th' functionality behind these buttons be fully configur'ble by ye.

Areas

Th' default configurat'n comes wit' three predefined areas that may contain an arbitrary set o' buttons.

• start: shown between menu an' breadcrumb
• end: shown on th' opposite breadcrumb side 'n comparison t' th' start area
• more: shown when press'n th' more button 'n th' topbar

While ye can not add additional areas 'n th' topbar, ye be free t' configure addtional buttons that behave like th' more button, provid'n further user defined areas.

Buttons

Th' theme ships wit' th' follow'n predefined buttons (from left t' right 'n th' screenshot)

• sidebar: opens th' sidebar flyout if 'n mobile layout
• toc: opens th' t'ble o' contents 'n an overlay
• edit: browses t' th' edit'ble plank if th' editURL parameter be set
• print: browses t' th' chapters print'ble plank if print support was activated
• prev: browses t' th' previous plank if there be one
• next: browses t' th' next plank if there be one
• more: opens th' overlay fer th' more area

Not all buttons be displayed at every given time. This be configur'ble (see below if interested).

Redefin'n Areas

Each predefined area an' button comes 'n their own file. By that it be easy fer ye t' overwrite an area file 'n yer installat'n reus'n only th' buttons ye like.

Eg. ye can redefine th' predefined end area by add'n th' file layouts/partials/topbar/area/end.html 'n yer installt'n (not 'n th' theme itself) t' remove all but th' more button.

{{ partial "topbar/button/more.html" (dict
    "page" .
)}}

Defin'n own Buttons

Button Types

Th' theme distingushies between two types o' buttons:

• button: a click'ble button that either browses t' another ship or triggers a user defined script
• area-button: th' template fer th' more button, t' define yer own area overlay buttons

Button Parameter

Screen Widths an' Act'ns

Depend'n on th' screen width ye can configure how th' button should behave. Screen width be divided into three classes:

• s: (controlled by th' onwidths parameter) mobile layout whar' th' menu sidebar be hidden
• m: (controlled by th' onwidthm parameter) desktop layout wit' vis'ble sidebar while th' rrrambl'n area width still resizes
• l: (controlled by th' onwidthl parameter) desktop layout wit' vis'ble sidebar once th' rrrambl'n area reached its maximum width

For each width class, ye can configure one o' th' follow'n act'ns:

• show: th' button be displayed 'n its configured area
• hide: th' button be hidden
• area-XXX: th' button be moved from its configured area into th' area XXX; eg. this be used t' move buttons t' th' more area 'n th' mobile layout

Hid'n an' Disabl'n Stuff

While hid'n a button dependend on th' screen size can be configured wit' th' above described hide act'n, ye may want t' hide th' button on certain other condit'ns aswell.

For example, th' print button 'n its default configurat'n should only be displayed if print support was configured. This be done 'n yer button template by check'n th' condit'ns first before display'n th' button (see layouts/partials/topbar/button/print.html).

Another prefered condit'n fer hid'n a button be, if th' displayed overlay be empty. This be th' case fer th' toc (see layouts/partials/topbar/button/toc.html) aswell as th' more button (see layouts/partials/topbar/button/more.html) an' controlled by th' parameter onempty.

This parameter can have one o' th' follow'n values:

• hide: th' button be hidden if th' overlay be empty
• dis'ble: th' button be disabled if th' overlay be empty

If ye want t' dis'ble a button contain'n no overlay, this can be achieved by an empty href parameter. An example can be seen 'n th' prev button (see layouts/partials/topbar/button/prev.html) whar' th' URL fer th' previous ship may be empty.

Reference

Button

Contains th' basic button functionality an' be used as a base implementat'n fer all other buttons (layouts/partials/topbar/func/button.html). Call this from yer own button templates if ye want t' implement a button wit' no overlay area.

Parameter

Area-Button

Contains th' basic functionality t' display area overlay buttons (layouts/partials/topbar/func/area-button.html). Call this from yer own button templates if ye want t' implement a button wit' an overlay area like th' more button.

Predefined Buttons

Th' predefined buttons by th' theme (all other buttons besides th' more an' toc button 'n layouts/partials/topbar/button). Call these from yer own redefined area templates if ye want t' offer some o' th' default button behavior.

Predefined Overlay-Buttons

Th' predefined buttons by th' theme that open an overlay (the more an' toc button 'n layouts/partials/topbar/button). Call these from yer own redefined area templates if ye want t' offer some o' th' default area button behavior.