|date:||Tue, 28 Jun 2011 01:50:24 +0000|
- Try to explain better that werc expects Plan 9 tools in /usr/local/plan9/bin/
- Note possible bug.
- Other small doc changes.
1 werc - a minimalist document management system2 ----------------------------------------------4 Werc is a content management system and web (anti-)framework designed to be simple to5 use, simple to setup, simple to hack on, and not get on the way while allowing6 users easy customization.8 For more information see the official website: http://werc.cat-v.org/11 Installation12 ------------14 Requirements:16 * An http server that can handle CGIs17 * Plan 9 from User Space: http://plan9.us - Or 9base-5 or later: http://tools.suckless.org/9base19 Note: Werc by default expects the Plan 9 tools to be installed under20 /usr/local/plan9/bin/, if you have installed them elsewhere you will need to21 edit the #! line in bin/werc.rc and customize the $plan9port variable in your22 etc/initrc.local.25 Instructions:27 Untar werc at your desired location, configure httpd to use28 /path-to-your-werc-installation/bin/werc.rc as a cgi-script, it is recommended29 that you make werc.rc handle all non-static files (this can be done by setting30 it up as your 404 handler) and setup your virtual hosts to handle static files31 by setting the document root for the domain to32 /path-to-werc-installation/sites/yourdomain.com/, and create a directory for33 your web site under sites/ where you can start adding content right away.35 If you will want to allow updates via the web interface (eg., for wiki or36 comments apps) make sure all files under sites/ are writable by the user your37 cgi will run as, usually www-data, for example by doing: chown -R :www-data38 sites/; chmod -R g+w sites/40 If your Plan 9 from User Space installation is located somewhere else than the41 standard /usr/local/plan9/ you will need to edit the first line of bin/werc.rc42 (Note that p9p is picky about where it is located, once you run ./INSTALL you43 should *not* move it to a different directory without running ./INSTALL again.)45 For general configuration options copy etc/initrc to etc/initrc.local and46 customize it as needed. Site (and directory) specific options can be set in a47 sites/example.com/_werc/config file inside the site's directory. To customize48 templates and included files you can store your own version of the files in49 lib/ under sites/example.com/_werc/lib51 The source tree for the werc website is included under sites/werc.cat-v.org as52 an example, feel free to use it as a template for your own site.54 For more details see the documentation section of the website:55 http://werc.cat-v.org/docs/58 Contact59 -------61 For comments, suggestions, bug reports or patches join the werc9 list in62 google groups: http://groups.google.com/group/werc9 or the irc channel #plan963 in irc.freenode.org65 If you have a public website that uses werc I would love to hear about it and66 get feedback about you experience setting it up.68 If you want to be notified of new releases see the News section of the website69 or use Freshmeat: http://freshmeat.net/projects/werc/71 Thanks72 ------74 Garbeam, Kris Maglione, sqweek, soul9, mycroftiv, maht, yiyus and many others75 for their ideas, patches, testing and other contributions.78 License79 -------81 Werc is in the public domain.