1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
Homepage:
http://www.steve.org.uk/Software/chronicle/
Mercurial Repository:
http://chronicle.repository.steve.org.uk/
Sample Output:
http://www.steve.org.uk/Software/chronicle/demo/
Real World Use:
http://blog.steve.org.uk/
http://blog.mail-scanning.com/
The chronicle blog compiler
---------------------------
Chronicle is a tool which will convert a directory of simple
text files into a static HTML weblog, (or blog if you prefer).
The system is intentionally simple, but it does support:
* Template based output.
* Support for RSS feeds.
* Support for tagged entries.
* Optional support for comments.
Installation
------------
It is possible to run the software without installing it, just
by placing blog entries in the ./blog directory and running
./bin/chronicle.
However it is recommended you install the software system-wide
by running "make install" as root.
This will give you:
/usr/share/chronicle <- The theme directories.
/usr/bin/chronicle <- The main binary.
/usr/bin/chronicle-spooler <- A simple helper.
/etc/chroniclerc <- The global configuration file.
If you wish to customise the templates it is recommended you
make a copy of them with a new name, then edit that copy. This
will prevent changes from being overwritten on upgrade.
The configuration file may be copied to ~/.chroniclerc for
per-user configuration.
Blog Format
-----------
The blog format is very simple. Each file should start like this:
/--
title: The title of my post
date: 12 August 2007
tags: foo, bar, baz
The text of the actual entry goes here.
However much there is of it.
\--
The entries are aided by a pseudo-header. This header contains
entries which are used by Chronicle to build your blog. The entries
themselves are not included in your output HTML.
Title:
This holds the name of the post. ("Subject:" may be used as a synonym.)
If neither "Title" or "Subject" are present the filename itself is
used.
Date:
The date this entry was created. If not present the creation time
of the file is used.
Publish:
If you make use of the spooler, to automatically post pre-written entries
on particular days, this field will specify when an entry is made live.
Tags:
If any tags are present they will be used to categorise the entry.
Entry Cutting
-------------
If you wish you may truncate a long entry via the special <cut> tag,
for example:.
/--------------------------\
This is a line of text
<cut>This is hidden
So is this
</cut>
This is displayed.
\==========================/
Or, with specific test:
/-------------------------------------------------\
This is a line of text
<cut text="Click to read more...">This is hidden
So is this
</cut>
This is displayed.
\=================================================/
Comment Support
---------------
The system supports the submission of user-supplied comments upon
posts, for more details please see the included file COMMENTS.
Bugs?
-----
Please report bugs to the author, where they will be fixed as
quickly as possible.
Steve
--
|
