Added note about favicon copy; thanks swildner
[ikiwiki.git] / docs / howtos / HowToManageThisSite.mdwn
1 This site is managed using ikiwiki.  
2
3 ## File locations
4
5 * The site is located at `/usr/local/www/www.dragonflybsd.org/`
6 * The checked out copy from Git used to generate the site is at `/usr/local/www/ikiwiki-srcdir/` (commit here)
7 * The bare Git repo for the site is at `/usr/local/www/ikiwiki-repo/` (clone from here)
8 * Source is publically browsable at [gitweb.dragonflybsd.org](http://gitweb.dragonflybsd.org/).
9 * configuration file is at `/usr/local/etc/ikiwiki.setup`.
10 * Page layouts are at `/usr/pkg/share/ikiwiki/templates/` - page.tmpl is probably the one you want.
11 * Stylesheet changes are in `/usr/pkg/share/ikiwiki/basewiki/local.css`.
12
13 ## Making changes
14
15 * All files under `/doc` can be edited by anyone, as can the `/sandbox` page.
16 * Existing developers' accounts can be set to edit the rest of the site; ask on the mailing lists.
17 * Changes to the site config are generated into the site with the command `ikiwiki --setup /usr/local/etc/ikiwiki.setup`.
18 * To create new pages on the web, add a new wiki link and then follow the link.  If you cannot find a good place for the link, use the [[/sandbox]].
19
20 ## Upgrading
21
22 * Back up `/usr/local/www/ikiwiki-srcdir/`, `/usr/local/www/ikiwiki-repo/`, `/usr/pkg/share/ikiwiki/templates/`, and `/usr/local/etc/ikiwiki.setup`.
23 * You will probably need to restore `/usr/pkg/share/ikiwiki/templates/page.tmpl`, `/usr/pkg/share/ikiwiki/basewiki/favicon.ico`, and `/usr/pkg/share/ikiwiki/basewiki/local.css` with the original versions.
24 * Run any ikiwiki transition commands mentioned in the release notes at http://ikiwiki.info/news/ .
25 * Check for any new plugins that could be enabled; place them in the ikiwiki.setup file.
26
27 ## For more information
28
29 * This site contains ikiwiki documentation under /[[ikiwiki]].
30 * Markdown is documented at [daringfireball.net](http://daringfireball.net/projects/markdown/syntax).
31 * ikiwiki is documented at the [ikiwiki site](http://ikiwiki.info/).