changelog shortlog tags branches changeset files revisions annotate raw help

Mercurial > hg > werc / sites/werc.cat-v.org/index.md

changeset 339: b09bd3c9a8bc
parent: 7c4268db88ec
child: 81798cd8b923
author: uriel@engel.se.cat-v.org
date: Tue, 20 Jan 2009 08:24:36 +0100
permissions: -rw-r--r--
description: More updates to new werc site.
1 werc - A sane web framework
2 =============================
3 
4 Werc is a minimalist web framework built on the Unix and Plan 9 *tool philosophy* of software design.
5 
6 Werc avoids the pain of managing collections of websites and developing web applications.
7 
8 * Database free, uses files and directories instead.
9 * Written using the rc shell, leveraging the standard Unix/Plan 9 command toolkit.
10 * Minimize tedious work: eg., no need to ever write HTML, use markdown (or any other format) instead.
11 * Very minimalist yet extensible codebase: highly functional core is 150 lines, with extra functionality in modular apps.
12 
13 
14 Features
15 --------
16 
17 Here are some of the features provided by werc:
18 
19 * Good integration with pre-existing content, you can add HTML or plain text files and they will be seamlessly integrated with the site.
20 * You can use your favorite tools (text editor, file manager, etc) to edit and manage data stored in werc.
21 * Designed to manage any number of 'virtual' domains that share a common style, layout, etc from a single werc installation.
22 * Configuration and customization can be at at any level: global, per-domain-group, domain-wide, directory sub-tree, and single file.
23 * Can trivially run multiple (customized) versions of werc side by side.
24 * Very simple and flexible user management and permissions system.
25 * Applications can be easily combined: eg., add comments to your blog or wiki by enabling the 'bridge' app; or by enabling the 'diridir' wiki convert any document tree into a wiki.
26 * Can easily write werc 'apps' and extensions in *any* language! (But of course, rc is recommended).
27 
28 Install Requirements
29 --------------------
30 
31 All you need is some Plan 9 commands (cat, grep, sed, rc, etc.), and an HTTP
32 server with CGI support.
33 
34 Werc runs on any Unix-like system where [Plan 9 from User Space](http://plan9.us)
35 is available (this includes Linux, *BSD, OS X and Solaris), and on Plan 9.
36 
37 Werc can use any HTTP server that can handle CGI, and has been tested with at
38 least Apache, Lighttpd, Cherokee, nhttpd, Hiawatha, and others.
39 
40 Werc uses markdown by default (and the standard Perl markdown is included with the distribution), to format documents, but any other formatting
41 system can be used.