Mercurial > hg > chronicle

annotate README @ 184:3739e04097da

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
1
19
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
2 Homepage:
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
3 http://www.steve.org.uk/Software/chronicle/
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
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
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
7
69
e5b192246b68 Mention the demo site.
Steve Kemp <steve@steve.org.uk>
parents: 65
diff changeset
8 Sample Output:
e5b192246b68 Mention the demo site.
Steve Kemp <steve@steve.org.uk>
parents: 65
diff changeset
9 http://www.steve.org.uk/Software/chronicle/demo/
19
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
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
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
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
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
18 ---------------------------
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
19
19
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
20 Chronicle is a tool which will convert a directory of simple
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
21 text files into a static HTML weblog, (or blog if you prefer).
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
22
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
23 The system is intentionally simple, but it does support:
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
24
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
25 * Template based output.
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
26 * Support for RSS feeds.
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
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
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
29
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
30
1
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
31
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
32
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
33 Installation
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
34 ------------
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
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
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
37 by placing blog entries in the ./blog directory and running
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
38 ./bin/chronicle.
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
39
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
40 However it is recommended you install the software system-wide
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
41 by running "make install" as root.
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
42
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
43 This will give you:
1
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
44
19
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
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
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
47 /etc/chroniclerc <- The main configuration file.
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
48
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
49 If you wish to customise the templates it is recommended you
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
50 make a copy of them with a new name, then edit that copy. This
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
51 will prevent changes from being overwritten on upgrade.
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
52
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
53 The configuration file may be copied to ~/.chroniclerc for
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
54 per-user configuration.
1
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
55
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
56
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
57
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
58 Blog Format
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
59 -----------
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
60
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
61 The blog format is very simple. Each file should start like this:
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
62
19
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
63 /--
1
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
64 title: The title of my post
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
65 date: 12 August 2007
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
66 tags: foo, bar, baz
19
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
67
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
68 The text of the actual entry goes here.
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
69
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
70 However much there is of it.
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
71 \--
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
72
1
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
73
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
74 The tags are optional, but recommended, similarly the date of the post
19
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
75 is used in preference to the current date if none is present.
1
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
76
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
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
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
114 Bugs?
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
115 -----
1
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
116
19
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
117 Please report bugs to the author, where they will be fixed as
8af29bfa35b0 2007-08-14 21:13:09 by steve
steve
parents: 1
diff changeset
118 quickly as possible.
1
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
119
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
120
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
121 Steve
bc8961a81af6 2007-08-13 22:53:14 by steve
steve
parents:
diff changeset
122 --