setup
-----
-To set up a directory with symbolic links to the relevant .do files and other
-important files, run ./add_dir.sh DIRECTORY.
+To set up a directory with symbolic links to the relevant files in ./processor/,
+run ./add_dir.sh DIRECTORY.
You can then enter the directory and run redo there. This will generate article
.html files from all .md and .rst files, plus a ./index.html, and a ./feed.xml.
also be generated a .uuid and a .intermediate file; furthermore, files with
metadata used in ./feed.xml and ./index.html will be built and can be edited to
customize the blog: ./url, ./author, ./uuid, ./title.)
+
+bugs
+----
+
+Due to bad shell scripting in ./processor/index.html.do and
+./processor/feed.xml.do (see the FIXME notes there), source files whose names
+contain "$" break the redo processing.
# Iterate through most recent entries (go by lastmod date of source files) to
# build feed head "updated" element, and individual entries.
+# FIXME: This ls parsing is a bad way to loop through the sorted files. Besides,
+# $('\0') is a bashism.
first_run=0
files=`ls -1t *.rst *.md | head -10 | tr '\n' $'\0'`
oldIFS="$IFS"
printf "<title>%s</title>\n</head>\n<body>\n" "$blog_title"
printf "<h1>%s</h1>\n<ul>\n" "$blog_title"
-# Iterate through entries sorted by lastmod of their source files, write entry
-# list.
+# Iterate through entries sorted by lastmod of their source files, write entry.
+# FIXME: This ls parsing is a bad way to loop through the sorted files. Besides,
+# $('\0') is a bashism.
first_run=0
files=`ls -1t *.rst *.md | tr '\n' $'\0'`
oldIFS="$IFS"