aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to 'README')
-rw-r--r--README55
1 files changed, 55 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..baa367a
--- /dev/null
+++ b/README
@@ -0,0 +1,55 @@
+Index:
+
+ 1) Entries
+ 2) Staticpages
+ 3) Comments
+ 4) Linklist
+
+
+1) Entries
+
+To start blogging you just have to open your favorite editor, write your entry
+and save it under entries/. The filename should be like this:
+ (entry title).(suffix)
+The suffix can be set in your configuration file. Default is '.txt'.
+
+While parsing an entry, blogthon places a <br /> behind each line, except for
+lines with <ul>, <li>, <table>, etc... So you don't need to make your own
+layout using <br /> tags. Aside from that you can certainly use <p> elements
+and all other HTML tags.
+
+Time and date of your entry are taken from the timestamp of your file.
+Unfortunately this timestamp changes when you edit your file again. As a
+workaround I use a small shellscript instead of starting vim/emacs/...:
+http://git.fucktheforce.de/?p=xeno;a=blob_plain;f=viod;hb=HEAD
+
+
+2) Staticpages
+
+Staticpages are placed under static/ without a suffix. To sort them, you can
+start the filename with a literal and -. So '01-Foo' will be placed before
+'02-Bar'.
+
+If you want to make a staticpage to be a link to an extern page, you just have
+to place the following content in the first line:
+extern_link: http://your/link.
+
+
+3) Comments
+
+Comments are saved under entries/ like all entries, but with the suffix
+'.comments'. The syntax in this file is like this:
+
+-.Nickname
++.Date
+.some text
+.more text
+
+
+4) Linklist
+
+To add a link to your linklist, just add a line to the linklist file:
+
+http://some/link name of your link
+
+Of course you can use empty lines to split different sorts of links.