Mercurial > hg > chronicle
annotate README @ 184:3739e04097da
Mention the other real-world usage
author | Steve Kemp <steve@steve.org.uk> |
---|---|
date | Tue, 01 Apr 2008 22:24:21 +0100 |
parents | df0201e39fed |
children | 82917ab0dff4 |
rev | line source |
---|---|
1 | 1 |
19 | 2 Homepage: |
3 http://www.steve.org.uk/Software/chronicle/ | |
4 | |
65
88f87687b36e
Removed references to the CVS repository and replaced them with Mercurial.
Steve Kemp <steve@steve.org.uk>
parents:
19
diff
changeset
|
5 Mercurial Repository: |
88f87687b36e
Removed references to the CVS repository and replaced them with Mercurial.
Steve Kemp <steve@steve.org.uk>
parents:
19
diff
changeset
|
6 http://chronicle.repository.steve.org.uk/ |
19 | 7 |
69 | 8 Sample Output: |
9 http://www.steve.org.uk/Software/chronicle/demo/ | |
19 | 10 |
109
10797bf26799
Added 'COMMENTS' to the file.
Steve Kemp <steve@steve.org.uk>
parents:
69
diff
changeset
|
11 Real World Use: |
10797bf26799
Added 'COMMENTS' to the file.
Steve Kemp <steve@steve.org.uk>
parents:
69
diff
changeset
|
12 http://blog.steve.org.uk/ |
184
3739e04097da
Mention the other real-world usage
Steve Kemp <steve@steve.org.uk>
parents:
166
diff
changeset
|
13 http://blog.mail-scanning.com/ |
19 | 14 |
109
10797bf26799
Added 'COMMENTS' to the file.
Steve Kemp <steve@steve.org.uk>
parents:
69
diff
changeset
|
15 |
10797bf26799
Added 'COMMENTS' to the file.
Steve Kemp <steve@steve.org.uk>
parents:
69
diff
changeset
|
16 |
184
3739e04097da
Mention the other real-world usage
Steve Kemp <steve@steve.org.uk>
parents:
166
diff
changeset
|
17 The chronicle blog compiler |
1 | 18 --------------------------- |
19 | |
19 | 20 Chronicle is a tool which will convert a directory of simple |
21 text files into a static HTML weblog, (or blog if you prefer). | |
22 | |
23 The system is intentionally simple, but it does support: | |
24 | |
25 * Template based output. | |
26 * Support for RSS feeds. | |
27 * Support for tagged entries. | |
109
10797bf26799
Added 'COMMENTS' to the file.
Steve Kemp <steve@steve.org.uk>
parents:
69
diff
changeset
|
28 * Optional support for comments. |
19 | 29 |
30 | |
1 | 31 |
32 | |
33 Installation | |
34 ------------ | |
35 | |
166
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
36 It is possible to run the software without installing it, just |
19 | 37 by placing blog entries in the ./blog directory and running |
38 ./bin/chronicle. | |
39 | |
40 However it is recommended you install the software system-wide | |
41 by running "make install" as root. | |
42 | |
43 This will give you: | |
1 | 44 |
19 | 45 /usr/share/chronicle <- The theme directories. |
109
10797bf26799
Added 'COMMENTS' to the file.
Steve Kemp <steve@steve.org.uk>
parents:
69
diff
changeset
|
46 /usr/bin/chronicle <- The main binary. |
19 | 47 /etc/chroniclerc <- The main configuration file. |
48 | |
49 If you wish to customise the templates it is recommended you | |
50 make a copy of them with a new name, then edit that copy. This | |
51 will prevent changes from being overwritten on upgrade. | |
52 | |
53 The configuration file may be copied to ~/.chroniclerc for | |
54 per-user configuration. | |
1 | 55 |
56 | |
57 | |
58 Blog Format | |
59 ----------- | |
60 | |
61 The blog format is very simple. Each file should start like this: | |
62 | |
19 | 63 /-- |
1 | 64 title: The title of my post |
65 date: 12 August 2007 | |
66 tags: foo, bar, baz | |
19 | 67 |
68 The text of the actual entry goes here. | |
69 | |
70 However much there is of it. | |
71 \-- | |
72 | |
1 | 73 |
74 The tags are optional, but recommended, similarly the date of the post | |
19 | 75 is used in preference to the current date if none is present. |
1 | 76 |
77 | |
166
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
78 Entry Cutting |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
79 ------------- |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
80 |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
81 If you wish to truncate an entry you may do so via the <cut> tags. |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
82 |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
83 For example: |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
84 |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
85 |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
86 /--------------------------\ |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
87 This is a line of text |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
88 <cut>This is hidden |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
89 So is this |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
90 </cut> |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
91 This is displayed. |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
92 \==========================/ |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
93 |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
94 |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
95 Or, with specific test: |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
96 |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
97 /-------------------------------------------------\ |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
98 This is a line of text |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
99 <cut text="Click to read more...">This is hidden |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
100 So is this |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
101 </cut> |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
102 This is displayed. |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
103 \=================================================/ |
df0201e39fed
Added 'cut' implementation.
Steve Kemp <steve@steve.org.uk>
parents:
109
diff
changeset
|
104 |
109
10797bf26799
Added 'COMMENTS' to the file.
Steve Kemp <steve@steve.org.uk>
parents:
69
diff
changeset
|
105 |
10797bf26799
Added 'COMMENTS' to the file.
Steve Kemp <steve@steve.org.uk>
parents:
69
diff
changeset
|
106 Comment Support |
10797bf26799
Added 'COMMENTS' to the file.
Steve Kemp <steve@steve.org.uk>
parents:
69
diff
changeset
|
107 --------------- |
10797bf26799
Added 'COMMENTS' to the file.
Steve Kemp <steve@steve.org.uk>
parents:
69
diff
changeset
|
108 |
10797bf26799
Added 'COMMENTS' to the file.
Steve Kemp <steve@steve.org.uk>
parents:
69
diff
changeset
|
109 The system supports the submission of user-supplied comments upon |
10797bf26799
Added 'COMMENTS' to the file.
Steve Kemp <steve@steve.org.uk>
parents:
69
diff
changeset
|
110 posts, for more details please see the included file COMMENTS. |
10797bf26799
Added 'COMMENTS' to the file.
Steve Kemp <steve@steve.org.uk>
parents:
69
diff
changeset
|
111 |
10797bf26799
Added 'COMMENTS' to the file.
Steve Kemp <steve@steve.org.uk>
parents:
69
diff
changeset
|
112 |
10797bf26799
Added 'COMMENTS' to the file.
Steve Kemp <steve@steve.org.uk>
parents:
69
diff
changeset
|
113 |
19 | 114 Bugs? |
115 ----- | |
1 | 116 |
19 | 117 Please report bugs to the author, where they will be fixed as |
118 quickly as possible. | |
1 | 119 |
120 | |
121 Steve | |
122 -- |