ref: b28035b1b6cc9220c2449d1066fd25606571a69d
parent: 0ff9d7d6ecc1675ef97fbd81d1736f5a3018e2a9
author: uriel <uriel@vm41.cat-v.org>
date: Sat Aug 15 23:26:57 EDT 2009
Commit documentation changes from the live site.
--- a/sites/werc.cat-v.org/development/todo.md
+++ b/sites/werc.cat-v.org/development/todo.md
@@ -5,7 +5,7 @@
* Canonize and redirect all requests, we already do this for things like missing or trailing /, should do the same for /. and /./, etc. Deleting trailing . and , should make pasted urls in emails work as links (**Mostly done in RC1**)
* Blog:
* Comment threading.
- * Some form of pagination (taking advantage of history browsing.)
+ * Some form of pagination (taking advantage of history browsing.) (**Partially done**)
* Sitemaps:
* Index pages should be used for description of directories.
* Cache web sitemap generation. (**Done in RC0**)
--- a/sites/werc.cat-v.org/docs/web_server_setup/plan_9_httpd.md
+++ b/sites/werc.cat-v.org/docs/web_server_setup/plan_9_httpd.md
@@ -40,6 +40,13 @@
found for this, you will have to keep your site in a sub-directory of the web
server root.
+In your /lib/namespace.httpd you probably will want to add something along the
+following lines to bind the werc directory into the httpd's namespace:
+
+ bind -b /usr/glenda/src/werc/ /usr/web/
+ bind /usr/glenda/src/werc/bin/ /usr/web/magic/
+
+
**Notes**: This is experimental and work in progress, there are a couple of issues
with the werc code itself that might need fixing, in particular you will need
to replace the '%($"extraHeaders%)' in lib/headers.tpl with '% echo
--- a/sites/werc.cat-v.org/index.md
+++ b/sites/werc.cat-v.org/index.md
@@ -1,14 +1,16 @@
-werc - A sane web framework
-=============================
-
-Werc is a minimalist web framework built on the Unix and Plan 9 *tool philosophy* of software design.
+werc - A sane web anti-framework
+================================
-Werc avoids the pain of managing collections of websites and developing web applications.
+Werc is a minimalist web anti-framework built following the Unix and Plan 9
+*tool philosophy* of software design.
+Werc avoids the pain of managing collections of websites and developing web
+applications.
+
* Database free, uses files and directories instead.
-* Written using the rc shell, leveraging the standard Unix/Plan 9 command toolkit.
+* Written using [the rc shell](http://rc.cat-v.org), leveraging the standard Unix/Plan 9 command toolkit.
* Minimize tedious work: eg., no need to ever write HTML, use markdown (or any other format) instead.
-* Very minimalist yet extensible codebase: highly functional core is 150 lines, with extra functionality in modular apps.
+* Very minimalist yet extensible codebase: highly functional core is 150 lines, with extra functionality in modular [apps](/apps/).
Features
@@ -16,9 +18,9 @@
Here are some of the features provided by werc:
-* Good integration with pre-existing content, you can add HTML or plain text files and they will be seamlessly integrated with the site.
-* You can use your favorite tools (text editor, file manager, etc) to edit and manage data stored in werc.
-* Designed to manage any number of 'virtual' domains that share a common style, layout, etc from a single werc installation.
+* Good integration with pre-existing content, you can add HTML or plain text files and they will be seamlessly integrated with the rest of the site.
+* You can use your favorite tools (text editor, shell, file manager, etc) to edit, manipulate and manage data stored in werc.
+* Designed to manage any number of 'virtual' domains that share a common style and layout from a single werc installation.
* Configuration and customization can be at at any level: global, per-domain-group, domain-wide, directory sub-tree, and single file.
* Can trivially run multiple (customized) versions of werc side by side.
* Very simple and flexible user management and permissions system.
@@ -38,24 +40,28 @@
Werc can use any HTTP server that can handle CGI, and has been tested with at
least Apache, Lighttpd, Cherokee, nhttpd, Hiawatha, and others.
-Werc uses markdown by default (and the standard Perl markdown is included with the distribution), to format documents, but any other formatting
-system can be used.
+Werc uses markdown by default (and the standard Perl markdown is included with
+the distribution), to format documents, but any other formatting system can be
+used.
-Latest Source
--------------
+Source
+------
-To get a copy of the latest development code using mercurial, do:
+To get a copy of the latest stable code using mercurial, do:
hg clone http://gsoc.cat-v.org/hg/werc/
You can also [browse the online repository](http://gsoc.cat-v.org/hg/werc/).
+The latest development branch is located at http://gsoc.cat-v.org/hg/werc-dev/
+
Contact
-------
-For questions, suggestions, bugrepports and contributing patches you can join the [werc9 mailinglist](http://groups.google.com/group/werc9).
+For questions, suggestions, bugrepports and contributing patches you can join
+the [werc9 mailinglist](http://groups.google.com/group/werc9).
On irc, join [#werc](irc://irc.freenode.org/werc) on irc.freenode.org
@@ -69,7 +75,10 @@
License
-------
-Public domain (by default includes markdown.pl which has a different license, but this can be replaced).
+Public domain, [because so called 'intellectual property' is an oxymoron](http://harmful.cat-v.org/economics/intellectual_property/).
+
+(By default includes markdown.pl which has a different license, but this can be
+replaced).
Credits
-------