Differences

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

--- faq:sidebar [2023-08-15 03:42] – 174.172.238.244
+++ faq:sidebar [2024-07-26 07:18] (current) – old revision restored (2024-06-17 12:26) saggi
@@ Line 1: / Line 1: @@
-https://www.netproportions.com/wiki/doku.php?id=start
 ====== How do I add a sidebar? ======
-If you're using [[template:dokuwiki|the new default template]] (or any other template which supports sidebars out of the box), you already have a sidebar functionality. If you are using a different template, there are basically two ways to add a sidebar functionality:
+If you're using [[template:dokuwiki|the default template]] (or any other template which supports sidebars out of the box), you already have a sidebar functionality. If you are using a different template, there are basically two ways to add a sidebar functionality:
   * Either choose a template which already comes with a sidebar, see [[templatetag>sidebar|templates tagged with 'sidebar']]. (There might be some which are missing the tag, so be sure to check out all of the [[:templates]].)
@@ Line 12: / Line 10: @@
 ===== I have a sidebar functionality. How can I create or edit a sidebar now? =====
-Most templates use a normal wiki [[:page]] called "sidebar" for the sidebar. Some make this configurable, so you can choose the name of the page. (E.g. since Adora Belle there is the [[config:sidebar]] config option which some templates support.) And others have several sidebars, each of which will have their own page, sometimes even depending on namespaces.
+Most templates use a normal wiki [[:page]] called "sidebar" for the sidebar. The name of that page is configurable via the [[config:sidebar]] config option. Some templates may have their own configuration or even have several sidebars - refer to your template's documentation.
 In the most likely event that your sidebar is a page called "sidebar", you just need to [[:page#create_a_page|create it]]. Go to ''%%http://your-wiki.com/doku.php?id=sidebar%%'', click "Create this page", edit the page, save, and you're done. That's it, your saved changes will appear in your sidebar.
-===== How can I have an automatic navigation in my sidebar? =====
-Best install one of the [[plugintag>menu|plugins tagged with 'menu']] or [[plugintag>navigation|plugins tagged with 'navigation']].
+===== My sidebar doesn't update properly or highlights the wrong parts =====
-In many cases you will also need to add the ''%%~~NOCACHE~~%%'' [[:wiki:syntax#control_macros|macro]] when using a plugin which changes the sidebar's appearance per page or namespace.
+If your sidebar contains dynamic elements (e.g. opening of a sub list, like a lot of navigation plugins do), then you may need to add the ''%%~~NOCACHE~~%%'' macro to your page to prevent [[:caching|caching]] of the sidebar.
-===== My sidebar doesn't update properly or highlights the wrong parts =====
-If your sidebar contains dynamic elements (e.g. highlighting of the current page or opening of a sub list, like a lot of navigation plugins do), then you need to add the ''%%~~NOCACHE~~%%'' macro to your page to prevent [[:caching|caching]] of the sidebar.
-*This NOCACHE is no longer needed to fix link highlighting after Hogfather is released, because it has been changed in implementation to use front-end JavaScript highlighting.*
 ===== Sidebar by namespace=====
@@ Line 46: / Line 39: @@
 However, you have to check if your template supports this setting. Bootstrap3, and possibly other templates, extends the namespace capability to other elements of the template (rightsidebar, navbar, pageheader,....). Check the template's configuration options.
-===== The contents of the sidebar remains empty =====
-You have to fill the page "sidebar" with static links and/or navigation plugin calls. In principle, the sidebar page is to edit and to fill like every other wiki page. (One small exception: be aware the ''%%~~NOCACHE~~%%'' option mentioned above.)
 ===== For some users the sidebar does not appear =====