changelog shortlog tags branches files raw gz bz2 help

Mercurial > hg > werc / changeset: Commit documentation changes from the live site.

changeset 576: f3802fe8231b
parent 575: b0403bab8800
child 577: 20d3644520b2
child 589: b5361fcdcbec
tag:1.1.1
author: uriel@vm41.cat-v.org
date: Sun, 16 Aug 2009 03:26:57 +0200
files: sites/werc.cat-v.org/development/todo.md sites/werc.cat-v.org/docs/web_server_setup/plan_9_httpd.md sites/werc.cat-v.org/index.md
description: Commit documentation changes from the live site.
     1.1--- a/sites/werc.cat-v.org/development/todo.md	Mon Aug 10 12:34:19 2009 +0200
     1.2+++ b/sites/werc.cat-v.org/development/todo.md	Sun Aug 16 03:26:57 2009 +0200
     1.3@@ -5,7 +5,7 @@
     1.4 * 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**)
     1.5 * Blog:
     1.6 	* Comment threading.
     1.7-	* Some form of pagination (taking advantage of history browsing.)
     1.8+	* Some form of pagination (taking advantage of history browsing.) (**Partially done**)
     1.9 * Sitemaps:
    1.10 	* Index pages should be used for description of directories.
    1.11 	* Cache web sitemap generation. (**Done in RC0**)
     2.1--- a/sites/werc.cat-v.org/docs/web_server_setup/plan_9_httpd.md	Mon Aug 10 12:34:19 2009 +0200
     2.2+++ b/sites/werc.cat-v.org/docs/web_server_setup/plan_9_httpd.md	Sun Aug 16 03:26:57 2009 +0200
     2.3@@ -40,6 +40,13 @@
     2.4 found for this, you will have to keep your site in a sub-directory of the web
     2.5 server root.
     2.6 
     2.7+In your /lib/namespace.httpd you probably will want to add something along the
     2.8+following lines to bind the werc directory into the httpd's namespace:
     2.9+
    2.10+    bind -b /usr/glenda/src/werc/ /usr/web/
    2.11+    bind /usr/glenda/src/werc/bin/ /usr/web/magic/
    2.12+
    2.13+
    2.14 **Notes**: This is experimental and work in progress, there are a couple of issues
    2.15 with the werc code itself that might need fixing, in particular you will need
    2.16 to replace the '%($"extraHeaders%)' in lib/headers.tpl with '% echo
     3.1--- a/sites/werc.cat-v.org/index.md	Mon Aug 10 12:34:19 2009 +0200
     3.2+++ b/sites/werc.cat-v.org/index.md	Sun Aug 16 03:26:57 2009 +0200
     3.3@@ -1,14 +1,16 @@
     3.4-werc - A sane web framework
     3.5-=============================
     3.6+werc - A sane web anti-framework
     3.7+================================
     3.8 
     3.9-Werc is a minimalist web framework built on the Unix and Plan 9 *tool philosophy* of software design.
    3.10+Werc is a minimalist web anti-framework built following the Unix and Plan 9
    3.11+*tool philosophy* of software design.
    3.12 
    3.13-Werc avoids the pain of managing collections of websites and developing web applications.
    3.14+Werc avoids the pain of managing collections of websites and developing web
    3.15+applications.
    3.16 
    3.17 * Database free, uses files and directories instead.
    3.18-* Written using the rc shell, leveraging the standard Unix/Plan 9 command toolkit.
    3.19+* Written using [the rc shell](http://rc.cat-v.org), leveraging the standard Unix/Plan 9 command toolkit.
    3.20 * Minimize tedious work: eg., no need to ever write HTML, use markdown (or any other format) instead.
    3.21-* Very minimalist yet extensible codebase: highly functional core is 150 lines, with extra functionality in modular apps.
    3.22+* Very minimalist yet extensible codebase: highly functional core is 150 lines, with extra functionality in modular [apps](/apps/).
    3.23 
    3.24 
    3.25 Features
    3.26@@ -16,9 +18,9 @@
    3.27 
    3.28 Here are some of the features provided by werc:
    3.29 
    3.30-* Good integration with pre-existing content, you can add HTML or plain text files and they will be seamlessly integrated with the site.
    3.31-* You can use your favorite tools (text editor, file manager, etc) to edit and manage data stored in werc.
    3.32-* Designed to manage any number of 'virtual' domains that share a common style, layout, etc from a single werc installation.
    3.33+* 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.
    3.34+* You can use your favorite tools (text editor, shell, file manager, etc) to edit, manipulate and manage data stored in werc.
    3.35+* Designed to manage any number of 'virtual' domains that share a common style and layout from a single werc installation.
    3.36 * Configuration and customization can be at at any level: global, per-domain-group, domain-wide, directory sub-tree, and single file.
    3.37 * Can trivially run multiple (customized) versions of werc side by side.
    3.38 * Very simple and flexible user management and permissions system.
    3.39@@ -38,24 +40,28 @@
    3.40 Werc can use any HTTP server that can handle CGI, and has been tested with at
    3.41 least Apache, Lighttpd, Cherokee, nhttpd, Hiawatha, and others.
    3.42 
    3.43-Werc uses markdown by default (and the standard Perl markdown is included with the distribution), to format documents, but any other formatting
    3.44-system can be used.
    3.45+Werc uses markdown by default (and the standard Perl markdown is included with
    3.46+the distribution), to format documents, but any other formatting system can be
    3.47+used.
    3.48 
    3.49 
    3.50-Latest Source
    3.51--------------
    3.52+Source
    3.53+------
    3.54 
    3.55-To get a copy of the latest development code using mercurial, do:
    3.56+To get a copy of the latest stable code using mercurial, do:
    3.57 
    3.58 	hg clone http://gsoc.cat-v.org/hg/werc/
    3.59 
    3.60 You can also [browse the online repository](http://gsoc.cat-v.org/hg/werc/).
    3.61 
    3.62+The latest development branch is located at http://gsoc.cat-v.org/hg/werc-dev/
    3.63+
    3.64 
    3.65 Contact
    3.66 -------
    3.67 
    3.68-For questions, suggestions, bugrepports and contributing patches you can join the [werc9 mailinglist](http://groups.google.com/group/werc9).
    3.69+For questions, suggestions, bugrepports and contributing patches you can join
    3.70+the [werc9 mailinglist](http://groups.google.com/group/werc9).
    3.71 
    3.72 On irc, join [#werc](irc://irc.freenode.org/werc) on irc.freenode.org
    3.73 
    3.74@@ -69,7 +75,10 @@
    3.75 License
    3.76 -------
    3.77 
    3.78-Public domain (by default includes markdown.pl which has a different license, but this can be replaced).
    3.79+Public domain, [because so called 'intellectual property' is an oxymoron](http://harmful.cat-v.org/economics/intellectual_property/).
    3.80+
    3.81+(By default includes markdown.pl which has a different license, but this can be
    3.82+replaced).
    3.83 
    3.84 Credits
    3.85 -------