stanley lieberimport6a3fde711 years agoHistory
75 lines · 2.8 KB · Text
RawDownload
werc - a minimalist document management system---------------------------------------------- Werc is a content management system and web (anti-)framework designed to be simple touse, simple to setup, simple to hack on, and not get on the way while allowingusers easy customization. For more information see the official website: http://werc.cat-v.org/  Installation------------ Requirements: * Plan 9 from User Space: http://plan9.us - Or 9base-5 or later: http://tools.suckless.org/9base* An http server that can handle CGIs Instructions: Untar werc at your desired location, configure httpd to use/path-to-your-werc-installation/bin/werc.rc as a cgi-script, it is recommendedthat you make werc.rc handle all non-static files (this can be done by settingit up as your 404 handler) and setup your virtual hosts to handle static filesby setting the document root for the domain to/path-to-werc-installation/sites/yourdomain.com/, and create a directory foryour web site under sites/ where you can start adding content right away. If you will want to allow updates via the web interface (eg., for wiki orcomments apps) make sure all files under sites/ are writable by the user yourcgi will run as, usually www-data, for example by doing: chown -R :www-datasites/; chmod -R g+w sites/ If your Plan 9 from User Space installation is located somewhere else than thestandard /usr/local/plan9/ you will need to edit the first line of bin/werc.rc(Note that p9p is picky about where it is located, once you run ./INSTALL youshould *not* move it to a different directory without running ./INSTALL again.) For general configuration options copy etc/initrc to etc/initrc.local andcustomize it as needed. Site (and directory) specific options can be set in asites/example.com/_werc/config file inside the site's directory. To customizetemplates and included files you can store your own version of the files inlib/ under sites/example.com/_werc/lib The source tree for the werc website is included under sites/werc.cat-v.org asan 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 ingoogle groups: http://groups.google.com/group/werc9 or the irc channel #plan9in irc.freenode.org If you have a public website that uses werc I would love to hear about it andget feedback about you experience setting it up. If you want to be notified of new releases see the News section of the websiteor use Freshmeat: http://freshmeat.net/projects/werc/ Thanks------ Garbeam, Kris Maglione, sqweek, soul9, mycroftiv, maht, yiyus and many othersfor their ideas, patches, testing and other contributions.  License------- Werc is in the public domain.