changelog shortlog tags branches changeset files revisions annotate raw help

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

changeset 617: 3ec94c8d3ea2
parent: ce5d401dee62
child: 4b00485ac6f7
author: Uriel <u@berlinblue.org>
date: Tue, 19 Jan 2010 00:32:33 +0000
permissions: -rw-r--r--
description: Documentation updates.
1 Blagh - A Blogging engine for people who hate blogs
2 ===================================================
3 
4 Balgh is werc a werc app that implements a blogging engine.
5 
6 Some features include:
7 
8 * File based, database free.
9 * History browsing.
10 * Atom and RSS feeds.
11 * Server-side feed 'aggregation' (merge multiple blogs into a single one).
12 * Comments using [bridge](../bridge/)
13 * Markdown formatting.
14 
15 Possible alternative names: Blag, Blah, Bragg.
16 
17 Posting
18 -------
19 
20 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`. This script will, optionally, take a file as an argument using the `-f` switch. It will open that file in your `$EDITOR` or create a new temporary file if the `-f` switch is omitted. When you have finished editing the file, the script will call `ispell` (so you may want to install that as well) to check for spelling errors. Once that has completed a new directory structure will be created in your blog's root directory as a hidden folder named after the current year (as detected by `date`). You can inspect this directory structure for continuity and `mv` it to unhide it when you are satisfied. You are encouraged to read the source of that very simple script, and you shall see that it is trivial to create new posts by simply using `mkdir` and `echo`.
21 
22 Configuration options
23 ---------------------
24 
25 This are options you can set in your _werc/config
26 
27 ### `conf_enable_blog` *[blog dirs]*
28 
29 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.
30 
31 Examples:
32 
33  # This will setup a blog in this dir that includes only posts in this dir.
34  conf_enable_blog
35 
36  # This will create a blog that aggregates all the posts in all blog dirs in any users/ sub dir.
37  conf_enable_blog users/*/blog
38 
39 ### `conf_blog_editors`=(*groups or users that will be allowed to make new blog posts*)
40 
41 This is optional and by default set to the 'blog-editors' group.
42 
43 ### `conf_max_lines_per_post=`*[integer]*
44 
45 This option may be added using the patch linked bellow. It defaults to `6` which **should** only include the page heading and the first two paragraphs of each post on the main blogroll(?) page. This is far from complete, but works for me. See it in action at <http://blog.senet.us>
46 
47 [blagh-91a4597480a7-conf\_max\_lines\_per\_post.diff](http://senet.us/blagh-91a4597480a7-conf_max_lines_per_post.diff) (1.2K) (20100114)
48 
49 **Author**: J Thigpen (cdarwin) <darwin@senet.us>
50 
51 See also:
52 
53 * To edit blog posts you can use the functionality provided by [the dirdir app](../dirdir/).
54 * Commenting can be handled by [the bridge app](../bridge/).
55 
56 
57 
58