DocThemes in split format
A theme allows you to specify the page "decorations" which surround the content of a miki page. To create a theme, create the files: * <theme>.header * <theme>.footer * <theme>.css - stylesheet file | A theme allows you to specify the page "decorations" which surround the content of a miki page. To create a theme, create the files: * <theme>.header * <theme>.footer * <theme>.css - stylesheet file |
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" | 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" |
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". | 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". |
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'. | 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'. |
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. | 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. |
Here are some of the variables available, and what they mean: * content_type - specifies the type of page to return (usually text/html) * title - the page title * system_title - the name of the miki site * base_css_url - the base web directory where css files are stored * stylesheet - the name of the css file (default is 'tbwiki.css', but it varies depending on the theme. * login_form - puts a link to the login form, or the name of the currently logged-in user * login_form_nobr - user stuff in a single line * nav_box_sidebar - a sidebar table showing a list of navigation links * nav_bar_bar - a sequence of navigation links * search_form - a table with a search form in it * search_form_nobr - a search form in a single line * toolbox - a sidebard table showing a list of actions you can perform * message - will display a message, usually reflecting the status of the last action performe | Here are some of the variables available, and what they mean: * content_type - specifies the type of page to return (usually text/html) * title - the page title * system_title - the name of the miki site * base_css_url - the base web directory where css files are stored * stylesheet - the name of the css file (default is 'tbwiki.css', but it varies depending on the theme. * login_form - puts a link to the login form, or the name of the currently logged-in user * login_form_nobr - user stuff in a single line * nav_box_sidebar - a sidebar table showing a list of navigation links * nav_bar_bar - a sequence of navigation links * search_form - a table with a search form in it * search_form_nobr - a search form in a single line * toolbox - a sidebard table showing a list of actions you can perform * message - will display a message, usually reflecting the status of the last action performe |