## Install ikiwiki
-If you're using Debian or Ubuntu, ikiwiki is an `apt-get install ikiwiki` away.
+If you're using Debian or Ubuntu, ikiwiki is an <code><a href="http://www.debian.org/doc/manuals/debian-reference/ch02.en.html#_basic_package_management_operations">apt-get</a> install ikiwiki</code> away.
If you're not, see the [[download]] and [[install]] pages.
+You may also want to try out IkiWiki in a [[container|containers]].
+
## Create your wiki
All it takes to create a fully functional wiki using ikiwiki is running
[[by_hand|byhand]].
"""]]
- % ikiwiki -setup /etc/ikiwiki/auto.setup
+ % ikiwiki --setup /etc/ikiwiki/auto.setup
Or, set up a blog with ikiwiki, run this command instead.
- % ikiwiki -setup /etc/ikiwiki/auto-blog.setup
+ % ikiwiki --setup /etc/ikiwiki/auto-blog.setup
+
+`librpc-xml-perl` and `python-docutils` dependencies are needed.
Either way, it will ask you a couple of questions.
destdir: ~/public_html/foo
repository: ~/foo.git
To modify settings, edit ~/foo.setup and then run:
- ikiwiki -setup ~/foo.setup
+ ikiwiki --setup ~/foo.setup
Done!
After making changes to this file, you need to tell ikiwiki to use it:
- % ikiwiki -setup foo.setup
+ % ikiwiki --setup foo.setup
Alternatively, you can ask ikiwiki to change settings in the file for you:
- % ikiwiki -changesetup foo.setup -plugin goodstuff
+ % ikiwiki --changesetup foo.setup --plugin goodstuff
See [[usage]] for more options.
them and re-checkout from the new repository location.
% rm -rf foo
- % git clone /src/git/foo.git
+ % git clone /srv/git/foo.git
Finally, edit the setup file. Modify the settings for `srcdir`, `destdir`,
`url`, `cgiurl`, `cgi_wrapper`, `git_wrapper`, etc to reflect where
-you moved things. Remember to run `ikiwiki -setup` after editing the
+you moved things. Remember to run `ikiwiki --setup` after editing the
setup file.
## Enjoy your new wiki!
Add yourself to [[IkiWikiUsers]]. And check out
the [[tips]] to find out how to get more out of ikiwiki.
+
+----
+
+_Notes_:
+
+- If you are searching for the file where the users are stored, it's in `your_repository/.ikiwiki/userdb`. The one which is in YOUR REPOSITORY, it cannot be found into your `~/.ikiwiki`.
+- If you want to enable a plugin you **WILL HAVE** to add it to the `add_plugins` array in the `*.setup` file (or to use the `--plugin` switch while calling `ikiwiki`). Uncommenting the plugin options/configuration fields in the setup is not **ALWAYS** sufficient. You have been warned.