| Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
| slackware:wikinotes [2006/03/28 18:54] – alien | slackware:wikinotes [2006/04/06 08:12] – alien |
|---|
| ==== Installing the dokuwiki tarball ==== | ==== Installing the dokuwiki tarball ==== |
| |
| * Download the latest and greatest DokuWiki archive at the [[http://www.splitbrain.org/projects/dokuwiki|download page]]. | * Download the latest and greatest DokuWiki archive at the [[http://www.splitbrain.org/projects/dokuwiki|download page]]. Dokuwiki comes with a clear [[http://wiki.splitbrain.org/wiki:install|installation]] and [[http://wiki.splitbrain.org/wiki:config|configuration]] pages. This paragraph will recap some of that information. |
| |
| * Unpack the tarball into your Apache DocumentRoot, change to the DocumentRoot directory (by default that is ''/var/www/htdocs'') and create a symbolic link called //dokuwiki// that points to the fresh DokuWiki directory tree: <code>ln -s dokuwiki-yyyy-mm-dd dokuwiki</code>. If you already have a DokuWiki running, better wait with changing the symlink until you're sure you've configured and upgraded everything right. | * Unpack the tarball into your Apache DocumentRoot, change to the DocumentRoot directory (by default that is ''/var/www/htdocs'') and create a symbolic link called //dokuwiki// that points to the fresh DokuWiki directory tree: <code>ln -s dokuwiki-yyyy-mm-dd dokuwiki</code>. If you already have a DokuWiki running, better wait with changing the symlink until you're sure you've configured and upgraded everything right. |
| |
| * Change into the DokuWiki directory and have a look around.\\ The ''conf'' directory is where we will be customizing the new Wiki soon. The ''data'' directory is where all the Wiki content (pages, indexes, archives, media, cache) will be stored. If anything, your Apache webserver //must// be able to write there. The ''conf'' and ''data'' directories are the most important to back up regularly! | * Change into the DokuWiki directory and have a look around.\\ The ''conf'' directory is where we will be customizing the new Wiki soon. The ''data'' directory is where all the Wiki content (pages, indexes, archives, media, cache) will be stored. If anything, your Apache webserver //must// be able to write there. The ''conf'' and ''data'' directories are the most important to back up regularly! |
| | |
| | * Create an empty logfile <code> |
| | touch ./data/changes.log |
| | </code> |
| |
| * Configuration.\\ You can customize the Wiki by overriding any of the values that are found in ./conf/dokuwiki.php. Just run <code> | * Configuration.\\ You can customize the Wiki by overriding any of the values that are found in ./conf/dokuwiki.php. Just run <code> |
| $file = eval('return '.$this->_local_file.';'); | $file = eval('return '.$this->_local_file.';'); |
| |
| </code> Now, with a customized umask like ''$conf['umask'] = '0111';'' the ''local.php'' file will have mode 666, so that even while it is owned by the webserver, you can still edit it.\\ | </code> Now, with a customized umask like ''$conf['umask'] = '0111';'' the ''local.php'' file will have mode 666, so that even while it is owned by the webserver, you can still edit it. These are the settings I use in my Wiki (you can change these using the configuration manager on the __//admin//__ page) <code> |
| | $conf['dmode'] = 0777; |
| | $conf['fmode'] = 0666; |
| | $conf['umask'] = '0111'; |
| | $conf['dmask'] = '0000'; |
| | </code> |
| <note important> You have to take care with the default umask and dmask settings because you will end up with lots of other files and directories that are owned by the webserver and read-only to you. This has the effect for instance, that you cannot delete the ''./data/cache'' directories and files any longer!</note> | <note important> You have to take care with the default umask and dmask settings because you will end up with lots of other files and directories that are owned by the webserver and read-only to you. This has the effect for instance, that you cannot delete the ''./data/cache'' directories and files any longer!</note> |
| |
| <div class="portlet" id="p-logo"> | <div class="portlet" id="p-logo"> |
| </code> | </code> |
| | |
| | * //(28-mar-2006)// the official Monobook template has undergone a couple of changes (some of which are my contributions) and I can now use an (almost) unmodified template. The only modifications are the few lines that need to be added for the [[slackware:wikinotes#pluginblog | blog plugin]] and the boldface tags I removed around the "edit this page" button (IMO, it should only be bold if it is activated by clicking the button). |
| |
| === Plugin: blog === | === Plugin: blog === |
| |
| * //(25-mar-2006)// Because of the bugs in the code, I decided to re-write the plugin almost from scratch. That resulted in a correctly rendering ''<note></note>'' tag, plus notes can be nested now. {{:slackware:dokuwiki-plugin-note-20060325.tar.gz|Download here}}. | * //(25-mar-2006)// Because of the bugs in the code, I decided to re-write the plugin almost from scratch. That resulted in a correctly rendering ''<note></note>'' tag, plus notes can be nested now. {{:slackware:dokuwiki-plugin-note-20060325.tar.gz|Download here}}. |
| |
| |
| ==== Tuning the look and feel ==== | ==== Tuning the look and feel ==== |
| === Adding an editor toolbar button === | === Adding an editor toolbar button === |
| |
| | The //editor toolbar// is the array of buttons that is displayed after you open a Wiki page in edit mode ("edit this page"). It can help you inserting markup tags like italic, bold, hyperlinks, images etc... comfortably.\\ |
| I missed a toolbar button for quickly inserting ''<code></code>'' tags. This is what is needed to add such a button to the toolbar: | I missed a toolbar button for quickly inserting ''<code></code>'' tags. This is what is needed to add such a button to the toolbar: |
| |
| </file> | </file> |
| * Add this text to the english language file ''inc/lang/en/lang.php'' (for other languages the corresponding texts have not yet been updated): <code>$lang['qb_syntax'] = 'Syntax Code';</code> And voilá! | * Add this text to the english language file ''inc/lang/en/lang.php'' (for other languages the corresponding texts have not yet been updated): <code>$lang['qb_syntax'] = 'Syntax Code';</code> And voilá! |
| | |
| | //(06apr2006)// I added another toolbar button, this time to insert %%<key></key>%% tags. The [[http://wiki.foosel.net/snippets/dokuwiki/keyboard?do=show|keyboard plugin]] site has it wrong, the instructions are for the older version of DokuWiki. This is what I had to do: |
| | |
| | * Download the [[http://wiki.foosel.net/download/keyboard.png|toolbar icon bitmap]] (local copy {{slackware:keyboard.png|here}}) This bitmap has a size of 24x24 pixels (the old toolbar button format) but we need a 16x16 pixel bitmap. I used these commands to resize the file: <code> |
| | mv keyboard.png keyboard-24x24.png |
| | convert -size 16x16 keyboard-24x24.png -resize 16x16 keyboard.png |
| | rm keyboard-24x24.png |
| | </code> Then copy the resized icon file into ''./lib/images/toolbar'' |
| | |
| | * Edit ''./inc/toolbar.php'' and add <file> |
| | array( |
| | 'type' => 'format', |
| | 'title' => $lang['qb_keyb'], |
| | 'icon' => 'keyboard.png', |
| | 'key' => 'k', |
| | 'open' => '<key>', |
| | 'close' => '</key>', |
| | ), |
| | </file> at an appropriate place in the toolbar array |
| | |
| | * Add this text to the english language file ''inc/lang/en/lang.php'' (for other languages the corresponding texts have not yet been updated): <code>$lang['qb_keyb'] = 'Mark text as key';</code> |
| | |
