 |
Commit documentation changes from the live site. - swerc - anselm's simpler wer… |
 |
git clone git://git.suckless.org/swerc |
 |
Log |
|
Files |
|
Refs |
|
README |
|
--- |
|
commit 622f973e61a95f1b55ee27ae7006c1c9737e8015 |
|
parent c332b38890887149483790e5f413e990e29c3a16 |
|
Author: [email protected] <unknown> |
|
Date: Sun, 16 Aug 2009 03:26:57 +0200 |
|
|
|
Commit documentation changes from the live site. |
|
Diffstat: |
|
M sites/werc.cat-v.org/development/t… | 2 +- |
|
M sites/werc.cat-v.org/docs/web_serv… | 7 +++++++ |
|
M sites/werc.cat-v.org/index.md | 41 +++++++++++++++++++----------… |
|
|
|
3 files changed, 33 insertions(+), 17 deletions(-) |
|
--- |
|
diff --git a/sites/werc.cat-v.org/development/todo.md b/sites/werc.cat-v.org/de… |
|
@@ -5,7 +5,7 @@ Plans and ideas for the future |
|
* Canonize and redirect all requests, we already do this for things like missi… |
|
* Blog: |
|
* Comment threading. |
|
- * Some form of pagination (taking advantage of history browsing.) |
|
+ * Some form of pagination (taking advantage of history browsing.) (**P… |
|
* Sitemaps: |
|
* Index pages should be used for description of directories. |
|
* Cache web sitemap generation. (**Done in RC0**) |
|
diff --git a/sites/werc.cat-v.org/docs/web_server_setup/plan_9_httpd.md b/sites… |
|
@@ -40,6 +40,13 @@ incapable of internally remapping the root directory, so unt… |
|
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 is… |
|
with the werc code itself that might need fixing, in particular you will need |
|
to replace the '%($"extraHeaders%)' in lib/headers.tpl with '% echo |
|
diff --git 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 - A sane web anti-framework |
|
+================================ |
|
|
|
-Werc is a minimalist web framework built on the Unix and Plan 9 *tool philosop… |
|
+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 ap… |
|
+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 tool… |
|
+* Written using [the rc shell](http://rc.cat-v.org), leveraging the standard U… |
|
* Minimize tedious work: eg., no need to ever write HTML, use markdown (or any… |
|
-* Very minimalist yet extensible codebase: highly functional core is 150 lines… |
|
+* Very minimalist yet extensible codebase: highly functional core is 150 lines… |
|
|
|
|
|
Features |
|
@@ -16,9 +18,9 @@ Features |
|
|
|
Here are some of the features provided by werc: |
|
|
|
-* Good integration with pre-existing content, you can add HTML or plain text f… |
|
-* You can use your favorite tools (text editor, file manager, etc) to edit and… |
|
-* Designed to manage any number of 'virtual' domains that share a common style… |
|
+* Good integration with pre-existing content, you can add HTML or plain text f… |
|
+* You can use your favorite tools (text editor, shell, file manager, etc) to e… |
|
+* Designed to manage any number of 'virtual' domains that share a common style… |
|
* Configuration and customization can be at at any level: global, per-domain-g… |
|
* Can trivially run multiple (customized) versions of werc side by side. |
|
* Very simple and flexible user management and permissions system. |
|
@@ -38,24 +40,28 @@ is available (this includes Linux, *BSD, OS X and Solaris),… |
|
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… |
|
-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 … |
|
+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 @@ Links |
|
License |
|
------- |
|
|
|
-Public domain (by default includes markdown.pl which has a different license, … |
|
+Public domain, [because so called 'intellectual property' is an oxymoron](http… |
|
+ |
|
+(By default includes markdown.pl which has a different license, but this can be |
|
+replaced). |
|
|
|
Credits |
|
------- |
