Go to file
2009-08-16 03:37:43 +02:00
apps Add rel="nofollow" for links to user loggin page. 2009-08-10 12:34:19 +02:00
bin For HEAD request, only quit after we send the new line that ends the headers section. This was making nginx unhappy. Thanks arg for reporting, tracking it down and fixing this bug! 2009-08-09 18:39:54 +02:00
etc Add example of formatter option using md2html.awk. 2009-07-28 20:48:18 +02:00
lib Start to convert templates to HTML 5 2009-07-19 04:02:30 +02:00
pub Ok, I give up, reverting part of last checking because CSS sucks. 2009-03-07 23:14:33 +00:00
sites Commit documentation changes from the live site. 2009-08-16 03:26:57 +02:00
tpl Fix sitemap.tpl when $sitedir is an absolute path. Thanks again to arg for reporting, tracking, and fixing this bug! 2009-08-09 21:02:42 +02:00
.hgignore Update ignore list, and add a dummy file to sites/ 2008-06-10 16:42:55 +02:00
README Update README 2009-08-05 17:06:25 +02:00

werc - a minimalist document management system
----------------------------------------------

Werc is a content management system and web (anti-)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 werc at your desired location, configure httpd to use
/path-to-your-werc-installation/bin/werc.rc as a cgi-script, it is recommended
that you make wrec.rc handle all non-static files (this can be done by setting
it up as your 404 handler) and setup your virtual hosts to handle static files
by setting the document root for the domain to
/path-to-werc-installation/sites/yourdomain.com/, and create a directory for
your 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 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
(Note that p9p is picky about where it is located, once you run ./INSTALL you
should *not* move it to a different directory without running ./INSTALL again.)

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, maht, yiyus and many others
for their ideas, patches, testing and other contributions.


License
-------

Werc is in the public domain.