| t | A theme allows you to specify the page "decorations" which surround the content | t | |
| of a miki page. To create a theme, create the files: | | |
| <ul><li><theme>.header | | |
| <li><theme>.footer | | |
| <li><theme>.css - stylesheet file | | |
| </ul> | | |
| <p> | | |
| The default theme for a wiki is specied in the top-level CGI file as the | | |
| string value of config.default_theme. For example: | | |
| config.default_theme="tbwiki" | | |
| <p> | | |
| Users can select a different theme, and this is stored in their account | | |
| data in e.g. data/admin/User1 as the value for "theme". | | |
| <p> | | |
| The list of allowed themes (for user selection) is generated by scanning | | |
| the data/pages directory, and listing all basenames for files ending in | | |
| '.header'. | | |
| <p> | | |
| The format of the header and footer files is raw HTML. You can reference | | |
| some tbwiki system variables, to place items wherever you want on the | | |
| page. The header and footer files go in the data/pages directory, just like | | |
| any other file (this might be a security risk). The stylesheet file goes in | | |
| the 'css' directory. | | |
| <p> | | |
| Here are some of the variables available, and what they mean: | | |
| <ul><li>content_type - specifies the type of page to return (usually text/html) | | |
| <li>title - the page title | | |
| <li>system_title - the name of the miki site | | |
| <li>base_css_url - the base web directory where css files are stored | | |
| <li>stylesheet - the name of the css file (default is 'tbwiki.css', but it varies | | |
| depending on the theme. | | |
| <li>login_form - puts a link to the login form, or the name of the currently logged-in user | | |
| <li>login_form_nobr - user stuff in a single line | | |
| <li>nav_box_sidebar - a sidebar table showing a list of navigation links | | |
| <li>nav_bar_bar - a sequence of navigation links | | |
| <li>search_form - a table with a search form in it | | |
| <li>search_form_nobr - a search form in a single line | | |
| <li>toolbox - a sidebard table showing a list of actions you can perform | | |
| <li>message - will display a message, usually reflecting the status of the last action performe | | |
| </ul> | | |
| <p> | | |