Clarify file locations/making changes notes
authorjustin <justin@web>
Wed, 13 Jan 2016 05:25:45 +0000 (05:25 +0000)
committerCharlie Root <root@leaf.dragonflybsd.org>
Wed, 13 Jan 2016 05:25:45 +0000 (05:25 +0000)
docs/howtos/HowToManageThisSite.mdwn

index d1ba338..76d17be 100644 (file)
@@ -2,16 +2,21 @@ This site is managed using ikiwiki.
 
 ## File locations
 
-* `/usr/local/www/ikiwiki-repo.git/` : The bare Git repo for the site. (clone from here)
-* `/usr/local/www/ikiwiki-srcdir/` : The checked out work for site generation. 
-* `/usr/local/www/www.dragonflybsd.org/` Static output from ikiwiki.
+* `/usr/local/www/ikiwiki-repo.git/` : The bare Git repo for the site. (clone from here to work on your own copy to commit back)
+* `/usr/local/www/ikiwiki-srcdir/` : The checked out work for site generation.  Ikiwiki uses this; shouldn't need to be touched. 
+* `/usr/local/www/www.dragonflybsd.org/` Static output from ikiwiki.  This is the final output from site generation.  Any changes will be overwritten on the next generation of the site.
 * Source is publically browsable at [gitweb.dragonflybsd.org](http://gitweb.dragonflybsd.org/).
 * Configuration file is at `/usr/local/etc/ikiwiki.setup`.
+
+## Making changes
+
+* Edit pages directly.
 * Page layouts are at `/usr/local/etc/ikiwiki-templates/` - page.tmpl is probably the one you want.  These are just the overrides from /usr/local/share/ikiwiki/templates.  This affects all pages; the sidebar menu is here.
-* Stylesheet changes are in `/usr/local/share/ikiwiki/basewiki/local.css`.
-* After modifying any of the templates or stylesheet info, regenerate the site with `ikiwiki --setup /usr/local/etc/ikiwiki.setup`.
+* Stylesheet changes go in `/usr/local/share/ikiwiki/basewiki/local.css`.
 * Add images by committing them to the repo.
 
+* After modifying any of the templates or stylesheet info, regenerate the site with `ikiwiki --setup /usr/local/etc/ikiwiki.setup`.
+
 ## Upgrading
 
 * Back up `/usr/local/www/ikiwiki-srcdir/`, `/usr/local/www/ikiwiki-repo.git/`, `/usr/local/share/ikiwiki/templates/`, and `/usr/local/etc/ikiwiki.setup`, just to be safe.