ref: 7bcdcf129eb30a187f2d6018151d4aa9cd3b680e
parent: b9c81b93811dd5b10abfdd5bcbb888d276f769d3
author: sl <uriel@engel.se.cat-v.org>
date: Tue Mar 3 07:32:39 EST 2009
Documentation updates.
--- a/sites/werc.cat-v.org/apps/blagh/index.md
+++ b/sites/werc.cat-v.org/apps/blagh/index.md
@@ -14,3 +14,35 @@
Possible alternative names: Blag, Blah, Bragg.
+Posting
+-------
+
+New pots can be created in at least two different ways: using the web interface (if you have logged in and your user or groups are in `$conf_blog_editors`) or from the command line using the script at bin/aux/bpst.rc, as you can see from the source of that very simple script, it is trivial to create new posts by simply using mkdir and echo.
+
+Configuration options
+---------------------
+
+This are options you can set in your _werc/config
+
+### `conf_enable_blog` *[blog dirs]*
+
+Setup a blog in this dir. By default the blog contents will only include posts stored in this dir, if you pass any arguments the posts in the various dirs will be aggregated in this feed.
+
+Examples:
+
+ # This will setup a blog in this dir that includes only posts in this dir.
+ conf_enable_blog
+
+ # This will create a blog that aggregates all the posts in all blog dirs in any users/ sub dir.
+ conf_enable_blog users/*/blog
+
+### `conf_blog_editors`=(*groups or users that will be allowed to make new blog posts*)
+
+This is optional and by default set to the 'blog-editors' group.
+
+See also:
+
+* To edit blog posts you can use the functionality provided by [the dirdir app](../dirdir/).
+* Commenting can be handled by [the bridge app](../bridge/).
+
+
--- a/sites/werc.cat-v.org/apps/bridge/index.md
+++ b/sites/werc.cat-v.org/apps/bridge/index.md
@@ -3,3 +3,11 @@
Bridge is a comments/forum application for werc, which lets people post comments related to any existing document/element.
+
+Configuration options
+---------------------
+
+### `conf_enable_comments` [-n] [*users and groups allowed to comment*]
+
+This will enable comments in this directory and all sub-directories. `-n` enables commenting by unregistered users (their posts will be set aside for review and approval by administrators).
+
--- a/sites/werc.cat-v.org/docs/web_server_setup/nhttpd.md
+++ b/sites/werc.cat-v.org/docs/web_server_setup/nhttpd.md
@@ -1,5 +1,5 @@
-Nhttpd config for werc
-======================
+Nhttpd/Nostromo Web Server Configuration for Werc
+==================================================
Contributed by nsz, thanks!
@@ -54,3 +54,5 @@
SERVER_NAME=$HTTP_HOST
line somewhere at the top of `werc.rc`.
+
+