Corrected repo-paths
[ikiwiki.git] / docs / howtos / HowToManageThisSite.mdwn
1 This site is managed using ikiwiki.  
2
3 ## File locations
4
5 * `/usr/local/www/ikiwiki-repo.git/` : The bare Git repo for the site. (clone from here)
6 * `/usr/local/www/ikiwiki-srcdir/` : The checked out work for site generation. (commit here)
7 * `/usr/local/www/www.dragonflybsd.org/` Sstatic output from ikiwiki.
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 * After modifying any of the templates or stylesheet info, regenerate the site with `ikiwiki --setup /usr/local/etc/ikiwiki.setup`.
13
14
15 ## Upgrading
16
17 * Back up `/usr/local/www/ikiwiki-srcdir/`, `/usr/local/www/ikiwiki-repo.git/`, `/usr/pkg/share/ikiwiki/templates/`, and `/usr/local/etc/ikiwiki.setup`.
18 * 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.
19 * Run any ikiwiki transition commands mentioned in the release notes at http://ikiwiki.info/news/ .
20 * Check for any new plugins that could be enabled; place them in the ikiwiki.setup file.
21
22 ## Feeds
23
24 * The sidebar on the main page displays recent headlines from the DragonFly BSD Digest.  
25 * Pages are saved to /digest/ and displayed using an 'inline' statement.  
26 * The actual feed information is gathered using an aggregate command, kept here so that instructions and actions are in the same place.
27 * Don't remove the aggregate command from this page unless you have someplace else for it.
28 * Here's the command and output: [[!aggregate  name="DragonFly Digest Feed" dir="digest"
29 feedurl="http://www.shiningsilence.com/dbsdlog/feed"
30 url="http://www.shiningsilence.com/dbsdlog/" updateinterval="1"
31 expireage="7" expirecount="20"]]
32
33 ## For more information
34
35 * This site contains ikiwiki documentation under /[[ikiwiki]].
36 * For document editing, visit [[How to edit pages on dragonflybsd.org|docs/howtos/How_To_Edit_This_Site]]