changelog shortlog tags branches changeset files revisions annotate raw help

Mercurial > hg > werc / README

changeset 674: 92f7463dac1a
parent: fb460a671d19
author: stanley.lieber@gmail.com
date: Thu, 10 Aug 2017 21:43:54 -0400
permissions: -rw-r--r--
description: bin/contrib/rc-httpd/handlers/dir-index: use urlencode(1), not urlencode.awk (for now?)
1 werc - a minimalist document management system
2 ----------------------------------------------
3 
4 Werc is a content management system and web (anti-)framework designed to be simple to
5 use, simple to setup, simple to hack on, and not get on the way while allowing
6 users easy customization.
7 
8 For more information see the official website: http://werc.cat-v.org/
9 
10 
11 Installation
12 ------------
13 
14 Requirements:
15 
16 * An http server that can handle CGIs
17 * Plan 9 from User Space: http://swtch.com/plan9port - Or 9base-tip: http://tools.suckless.org/9base
18 
19 Note: Werc by default expects the Plan 9 tools to be installed under
20 /usr/local/plan9/bin/, if you have installed them elsewhere you will need to
21 edit the #! line in bin/werc.rc and customize the $plan9port variable in your
22 etc/initrc.local.
23 
24 
25 Instructions:
26 
27 Untar werc at your desired location, configure httpd to use
28 /path-to-your-werc-installation/bin/werc.rc as a cgi-script, it is recommended
29 that you make werc.rc handle all non-static files (this can be done by setting
30 it up as your 404 handler) and setup your virtual hosts to handle static files
31 by setting the document root for the domain to
32 /path-to-werc-installation/sites/yourdomain.com/, and create a directory for
33 your web site under sites/ where you can start adding content right away.
34 
35 If you will want to allow updates via the web interface (eg., for wiki or
36 comments apps) make sure all files under sites/ are writable by the user your
37 cgi will run as, usually www-data, for example by doing: chown -R :www-data
38 sites/; chmod -R g+w sites/
39 
40 If your Plan 9 from User Space installation is located somewhere else than the
41 standard /usr/local/plan9/ you will need to edit the first line of bin/werc.rc
42 (Note that p9p is picky about where it is located, once you run ./INSTALL you
43 should *not* move it to a different directory without running ./INSTALL again.)
44 
45 For general configuration options copy etc/initrc to etc/initrc.local and
46 customize it as needed. Site (and directory) specific options can be set in a
47 sites/example.com/_werc/config file inside the site's directory. To customize
48 templates and included files you can store your own version of the files in
49 lib/ under sites/example.com/_werc/lib.
50 
51 The source tree for the werc website is included under sites/werc.cat-v.org as
52 an example, feel free to use it as a template for your own site.
53 
54 For more details see the documentation section of the website:
55 http://werc.cat-v.org/docs/
56 
57 
58 Contact
59 -------
60 
61 For comments, suggestions, bug reports or patches join the werc mailing list
62 at: http://werc.cat-v.org or the irc channel #cat-v in irc.freenode.org
63 
64 If you have a public website that uses werc I would love to hear about it and
65 get feedback about you experience setting it up.
66 
67 Thanks
68 ------
69 
70 Garbeam, Kris Maglione, sqweek, soul9, mycroftiv, maht, yiyus, cinap_lenrek,
71 khm and many others for their ideas, patches, testing and other contributions.
72 
73 
74 License
75 -------
76 
77 Werc is in the public domain.