ref: 812c550f75aadbea39740d3fe37139f54139efb2
dir: /README/
werc - a minimalist document management system ---------------------------------------------- Werc is a content management system and web framework designed to be simple to use, simple to setup, simple to hack on, and not get on the way while allowing users easy customization. For more information see the official website: http://werc.cat-v.org/ Installation ------------ Requirements: * Plan 9 from User Space - http://plan9.us * An http server that can handle CGIs Instructions: Untar, configure httpd to use bin/werc.rc as a cgi-script, and create a directory for your web site under sites/ where you can start to add content right away. If you will want to allow updates via the web interface (eg., for wiki or comments apps) make sure all files under sites/ are writable by the user your cgi will run as, usually www-data, for example by doing: chown -R :www-data sites/; chmod -R g+w sites/ If your Plan 9 from User Space installation is located somewhere else than the standard /usr/local/plan9/ you will need to edit the first line of bin/werc.rc For general configuration options copy etc/initrc to initrc.local and customize it as needed. Site (and directory) specific options can be set in a sites/example.com/_werc/config file inside the site's directory. To customize templates and included files you can store your own version of the files in lib/ under sites/example.com/_werc/lib The source tree for the werc website is included under sites/werc.cat-v.org as an example, feel free to use it as a template for your own site. For more details see the documentation section of the website: http://werc.cat-v.org/docs/ Contact ------- For comments, suggestions, bug reports or patches join the werc9 list in google groups: http://groups.google.com/group/werc9 or the irc channel #plan9 in irc.freenode.org If you have a public website that uses werc I would love to hear about it and get feedback about you experience setting it up. If you want to be notified of new releases see the News section of the website or use Freshmeat: http://freshmeat.net/projects/werc/ Thanks ------ Garbeam, Kris Maglione, sqweek, soul9, mycroftiv and many others for their ideas, patches, testing and other contributions. License ------- Werc is in the public domain.