DokuWiki

It's better when it's simple

User Tools

Site Tools


template:simple_sidebar

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
template:simple_sidebar [2016-01-30 17:58] – [Sizing the page] turnermmtemplate:simple_sidebar [2023-10-30 23:48] (current) Klap-in
Line 2: Line 2:
  
 ---- template ---- ---- template ----
-description   : Simple Left Sidebar, with Default DokuWiki Look+description   : Simple Left Sidebar, with Previous Default DokuWiki Template Look
 author        : Myron Turner author        : Myron Turner
 email         : turnermm02@shaw.ca email         : turnermm02@shaw.ca
-lastupdate    : 2016-01-30 +lastupdate    : 2017-09-05 
-compatible    : 2009-12-25, Anteater,Rincewind,Angua,Adora Belle,Weatherwax,binky,ponder stibbons,hrun,hrun,detritus+compatible    : Lemming, Anteater, Rincewind, Angua, Adora Belle, Weatherwax, Binky, Ponder StibbonsHrunDetritusElenor of TsortFrusterick Manners
 depends       :  depends       : 
 conflicts     :  conflicts     : 
 similar       :  similar       : 
-screenshot_img: http://www.mturner.org/development/simple_sbar.png+screenshot_img: https://i.imgur.com/LwnCRtC.png
 tags          : sidebar tags          : sidebar
  
Line 16: Line 16:
 bugtracker    : https://github.com/turnermm/simple_sidebar/issues bugtracker    : https://github.com/turnermm/simple_sidebar/issues
 sourcerepo    : https://github.com/turnermm/simple_sidebar sourcerepo    : https://github.com/turnermm/simple_sidebar
-donationurl   # eg. https://www.paypal.com/...+donationurl: http://mturner.org/userfiles/donate.php
 ----  ---- 
  
 +A simple left-hand side bar which retains the look and feel of the original "default" template, which preceded the current "dokuwiki" template. The side bar width is controlled by changing the width of the main page. Instructions are in the style.css file.
  
-A simple left-hand side bar which retains the look and feel of the original "default" template, which preceded the current "dokuwiki" template.  The side bar width is controlled by changing the width of the main page.  Instructions are in the style.css file. +There is also a toggle button above the sidebar for closing and opening it.
- +
-There is also a toggle button above the sidebar for  closing and opening it.+
  
 ===== Download and Install ====== ===== Download and Install ======
Line 29: Line 28:
  
 ==== For earlier Dokuwiki distributions ==== ==== For earlier Dokuwiki distributions ====
-  * Angua: [[https://github.com/turnermm/simple_sidebar/zipball/angua|simple_sidebar_angua.zip]] + 
 +  * Angua: [[https://github.com/turnermm/simple_sidebar/zipball/angua|simple_sidebar_angua.zip]]
   * Anteater: [[http://www.mturner.org/userfiles/simple_sidebar-anteater.tgz|simple_sidebar-anteater.tgz]]   * Anteater: [[http://www.mturner.org/userfiles/simple_sidebar-anteater.tgz|simple_sidebar-anteater.tgz]]
   * Lemming: [[http://www.mturner.org/userfiles/simple_sidebar-lemming.tgz|simple_sidebar-lemming.tgz]]   * Lemming: [[http://www.mturner.org/userfiles/simple_sidebar-lemming.tgz|simple_sidebar-lemming.tgz]]
  
 Refer to [[:template]] on how to install and use templates in DokuWiki. Refer to [[:template]] on how to install and use templates in DokuWiki.
- 
- 
- 
  
 ==== Sizing the page ==== ==== Sizing the page ====
 +
 These instructions apply only to the to distributions post-anteater. These instructions apply only to the to distributions post-anteater.
  
-This template has a left-hand sidebar and a right-hand main page.  The default measurements are set in the file style.ini: +This template has a left-hand sidebar and a right-hand main page. The default measurements are set in the file style.ini: 
-  * %%__page_width__%% = "1000px" ; this is the overall width (main page + sidebar):  +  * ''%%__page_width__ = "1000px" ;%%'' this is the overall width (main page + sidebar): 
-  * %%__right_width__%%  = "80%"  ; this is the width of the right-hand main page, ie.e 80% of total width or 800px  +  * ''%%__right_width__ = "80%"  ;%%'' this is the width of the right-hand main page, i.e 80% of total width or 800px  
-  * %%__top_bar_width__%% = "980px"  ; width of the top bar which goes across top of entire page +  * ''%%__top_bar_width__ = "980px"  ;%%'' width of the top bar which goes across top of entire page 
-  * %%__bottom_bar_width__%% = "770px" ; width of bar that appears on the bottom of the right-hand page     +  * ''%%__bottom_bar_width__ = "770px" ;%%'' width of bar that appears on the bottom of the right-hand page
  
-There is no separate setting for the side bar.  The size of the sidebar is always relative to the main page, so that if the main page is set to 75%, then the sidebar will be 25%.  Using the above values, that would mean that the main page would be 750px wide and the side bar 250px.+There is no separate setting for the side bar. The size of the sidebar is always relative to the main page, so that if the main page is set to 75%, then the sidebar will be 25%. Using the above values, that would mean that the main page would be 750px wide and the side bar 250px.
  
-The top bar and bottom bar sizes are set to fit into the default page layout and may have to be adjusted if the sizes of the  sidebar and main page change.+The top bar and bottom bar sizes are set to fit into the default page layout and may have to be adjusted if the sizes of the sidebar and main page change.
  
-For more information about style.ini, see the [[devel:css#styleini|css page]].+For more information about ''style.ini'', see the [[devel:css#styleini|css page]].
  
 === Setting Up the Sidebar === === Setting Up the Sidebar ===
 +
 The sidebar has two components, the main (top) section, which is required, and the bottom section which is user-defined. The sidebar has two components, the main (top) section, which is required, and the bottom section which is user-defined.
  
-  - **The main section** \\ The sidebar content can be included in either the file sidebar.html or sidebar.php. It has a default set-up, which serves as an example. You can alter this as you need. It uses a default css styling which fits in with the styling of the main page. There is only one proviso, that is, if the text of the sidebar is wider than the sidebar, it will encroach on the main page.  +  - **The main section**\\ The sidebar content can be included in either the file sidebar.html or sidebar.php. It has a default set-up, which serves as an example. You can alter this as you need. It uses a default css styling which fits in with the styling of the main page. There is only one proviso, that is, if the text of the sidebar is wider than the sidebar, it will encroach on the main page. 
-  - **User-defined section** \\ This is a wiki page created in the sidebar namespace with the user's name.  For instance, if the user is jones and there is a page named: ''sidebar:jones'', this page will be displayed beneath the main sidebar section when jones is logged in.  When jones logs off jones's section disappears.  The user-defined section is set to 160px in style.ini.  This may have to be altered if you change the proportions of the page.  If the user-defined sidebar section is wider than the main sidebar section, it will be scrolled.+  - **User-defined section**\\ This is a wiki page created in the sidebar namespace with the user's name. For instance, if the user is jones and there is a page named: ''sidebar:jones'', this page will be displayed beneath the main sidebar section when jones is logged in. When jones logs off jones's section disappears. The user-defined section is set to 160px in style.ini. This may have to be altered if you change the proportions of the page. If the user-defined sidebar section is wider than the main sidebar section, it will be scrolled.
  
-The user-defined sidebar component is not in some of the earlier distributions. +The user-defined sidebar component is not in some of the earlier distributions.
  
 === Configuration Options for Suppressing the Sidebar === === Configuration Options for Suppressing the Sidebar ===
-     - ''sbar_closed'':  a comma-delimited list of pages (namespace:page) where the sidebar will not be open when the page loads + 
-     - ''sidebar_off'': a checkbox which, when checked, suppresses the sidebar for all pages.+  - ''sbar_closed'': a comma-delimited list of pages (namespace:page) where the sidebar will not be open when the page loads 
 +  - ''sidebar_off'': a checkbox which, when checked, suppresses the sidebar for all pages.
 When either of these options is active the toggle button is also turned off. When either of these options is active the toggle button is also turned off.
  
 === Font Size === === Font Size ===
-With changes on December 11 2014, the font-size was increased.  However, if your prefer the smaller size of previous distributions, you can get this by uncommenting the following line in style.css: + 
-<code> +With changes on December 11 2014, the font-size was increased. However, if your prefer the smaller size of previous distributions, you can get this by uncommenting the following line instyle.css'': 
-/* font: 9pt bold Verdana,"Lucida Grande",Lucida,Helvetica,Arial,sans-serif;color:#333333; */ + 
-</code>       +<code css
-You will find it at about line 30.    +/* font: 9pt bold Verdana, "Lucida Grande", Lucida, Helvetica, Arial, sans-serif; color: #333333; */ 
 +</code> 
 + 
 +You will find it at about line 30.
  
 ===== Discussion ===== ===== Discussion =====
Line 77: Line 80:
 ===== Sites using this Template ===== ===== Sites using this Template =====
  
-  * Add yours here   +  * Add yours here 
-  * http://www.mturner.org/fckgLite+  * https://www.mturner.org/fckgLite/doku.php/introduction
  
template/simple_sidebar.1454173088.txt.gz · Last modified: 2016-01-30 17:58 by turnermm

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki