= DokuWiki =

== Installation Instructions ==

* Check out [[http://swarm.cs.pub.ro/~razvan/dokuwiki/tutorials/dokuwiki | this tutorial]] describing the DokuWiki installation process.

== Wiki usage ==

Be sure to check out the [[http://www.dokuwiki.org/faq|official faq]] (see the usage section) to get up to speed with basic tasks.

=== Editing the wiki's sidebar ===

After logging in, under the sidebar you should see an 'edit' link (as shown in the picture below):

{{ http://i.imgur.com/zIkW1.png }}

You can then add the links to pages you want displayed in the sidebar manually.

=== Reuse code from an existing wiki page ===

If you see a wiki page that contains elements you want to reuse, you can see the page's sourcecode (in wiki syntax) by clicking the Show Pagesource navigation item.

{{ http://i.imgur.com/OzYvy.png }}

=== Undoing/reviewing recent changes ===

In case you accidentally deleted a page, you can get the source for it back by clicking the Recent Changes navigation item and then diffing the revision you want to see with the current one (which will be blank in the case the page was deleted).

{{ http://i.imgur.com/5jXc1.png }}

{{ http://i.imgur.com/7TQed.png }}

=== Removing a page or namespace ===

To remove a page, simply delete its contents and save it - dokuwiki erases it. If you delete all pages under a namespace, it will be deleted and will not appear in the index.

=== Uploading a file to the wiki ===

To upload any file to the wiki (zip archives, images, source files etc.) you need to be editing a page. You need to click the ''Add images and other files'' menu item.

{{ http://i.imgur.com/oTbT4.png }}

After uploading the file to a certain namespace, you can reference it with the image syntax, even if it is not an image. For example {{:teme:tema3-generator-formulare.zip|Form generator assignment}}.

== Installation issues ==

Trying to redo [[http://swarm.cs.pub.ro/~razvan/dokuwiki/tutorials/dokuwiki|the steps]] I took one year ago, I came across the following problems.

The creole plugin is no longer available at the address in the install script. The version available on the wiki project's site is for the newer version. 

Same thing for the the include plugin, the original location is no longer available and I could not find other versions.

There is no way to upgrade - "Error: this script must be run as root". If you try and do it manually you will break the wiki, so beware. Since the plugins are not to be found, upgrading the script or the docs to work with newer version is advisable.