Static site with TiddlyWiki
Hosting with GitHub
All the dynamic goodness of TiddlyWiki (such as the search, the sidebar, ...) will not be available in the static HTML pages. Thus you must plan a way for the user to navigate the site. For this site, I kept things very simple and created four tiddlers which contains basic lists:
All Tags: <<list-links filter:"[tags!is[system]!has[draft.of]!tag[private]!tag[draft]]">>
You may also want to include some navigation element include in the site template and this can be done like this:
< html from the site template ... > `<$view tiddler="All Tags" format="htmlwikified" />` </ html from the site template ... >
An interesting question is what the landing page of the site (ie.
index.html file) should be. There are many options depending on how you want your site to look like. It could be static text, but in the case of this site, I decided the landing page should be the latest post.
I thus created a simple tiddler
index.html_helper (which I tag as
private) which just shows the latest post:
<$list filter="[!tag[private]!tag[draft]!has[notpost]!has[draft.of]!is[system]sort[created]last]" />
and I use this information during the static pages generation to point
index.html to the right page:
# index.html as a symlink to the latest post tiddlywiki --rendertiddler index.html_helper index.html_helper INDEX=$(sed -ne 's/.*href="#\(.*\)">.*/\1/p' output/index.html_helper) ln -s "$INDEX.html" output/index.html rm output/index.html_helper
Here I am again using a tiny bit of shell along with TiddlyWiki and it seems like a powerful technique.