Installation

To install [[DokuWiki]] follow these steps

. Download the newest release from http://www.splitbrain.org/go/dokuwiki[] ((The newset release is at the bottom))
. extract the Tarball somewhere below your webserver root
    * ''cd /var/www''
    * ''tar -xzvf /path/to/dokuwiki.tgz''
. create an empty changes log file using the FreeBSD or linux [[man>touch]] command or by uploading an empty file
    * ''touch dokuwiki/changes.log''
. change the initial owner of all extracted [[DokuWiki]] files to that of ''root'' using [[man>chown]] or your FTP program
    * ''chown -R root:root dokuwiki''.  In FreeBSD, you should type chown -R root:wheel dokuwiki'
. make data directories writable by the webserver, this example assumes you run the webserver as user ''httpd'' ((Note: You should always give as few permissions as possible. Just make sure the webserver is able to write the files.))
    * ''chown -R httpd:httpd dokuwiki/media dokuwiki/attic dokuwiki/data''
. make some additional files writable by the webserver
    * ''chown httpd:httpd dokuwiki/changes.log''
    * ''chown httpd:httpd dokuwiki/conf/users.auth''
. edit ''dokuwiki/conf/dokuwiki.php'' (see [[config]]) if you want to change anything within it \\ or (better) create dokuwiki/conf/local.php containing those lines from dokuwiki.php, which you want to change. This way your changes are preserved when overwriting the dokuwiki.php with a new release.
. to check if everything is set up correctly use the ''check'' option like this: \\ http://wiki.splitbrain.org/doku.php?do=check[] ((of course change the URL to your own server))

  * Check the [[security]] page for hotfixes
  * Choose a license for your content -- edit the ''footer.html'' it includes the [[http://creativecommons.org/licenses/by-nc-sa/2.0/|Creative Commons Attribution-NonCommercial-ShareAlike License]] by default
  * Enable Apache URL rewriting in ''.htaccess'' and set the appropriate config option.
  * Change the ''style.css'' to your own ideas
  * Enter a few words how and where you use [[DokuWiki]] in the [[users|userpage]]
  * [[http://freshmeat.net/subscribe/48181/|subscribe]] to DokuWiki at freshmeat.net to stay informed on updates and get a mail whenever a security problem is encountered

  * Create a new (if no locale exists yet) folder under __lang__, as a copy of the en folder. Rename it to your __2-letter ISO code country__ and change the values inside lang.php, as well as translate all raw text files to suit your needs.
  * Edit the __start page__ content to indicate the most important pages of the wiki, sorted by namespace ranking. Works like a homepage for all other major pages of your wiki. Don't forget to describe in one short sentence the main reason and/or objectives behind the deployment of the wiki. This start page should have an __index of all available namespaces__ along with a brief description for each one.
  * Create a list of all available __namespaces__ that describes each namespace, the top level document of each namespace and how to add new documents to each namespace. This helps new users to understand the documentation structure in place, while avoiding a proliferation of similar namespaces just because one user doesn't know that another user has created a namespace to group documents on the same subject.
  * Create a __Quick Syntax__ page tailored to your Wiki's audience. Sometimes people don't want to go through the full syntax page content, they just want to start editing as soon as possible with a minimal set of formatting rules.
  * Add a __Frequently Asked Questions__ (FAQ) page to your wiki. This page will evolve as time goes by and will keep track of most frequent doubts that users put about the wiki site, wiki engine and content.
  * Add a __Suggestions Box__ page to your wiki, so users can post comments or suggestions on how to improve the Wiki.
  * Add a __Rules, Conventions and Policies__ page to your wiki. It should describe the consensual conventions reached by all main content editors and the rules that newcomers must "obey" in order to add/edit content. This should be locked against editing, since it will be a "static" content page.
  * Add a __RSS Feeds__ page to your wiki. It should describe the several options to receive recent changes content through the RSS Feeder, specially if you want to inform about how to receive changes of a namespace only. See the RSS [[wiki:syndication]] page as basis for the content of the page in your site.

  * Add an __Enroll-User__ page that describes a very simple and quick procedure to follow, by visitors that actively participate on the WikiSite. This procedure must explain the Access Control Level concept and how it related to user authentication and authorization.
  * Customize the [[wiki:tips#signature string | signature string]] that users will use for signing their content contributions.