From 0939258be1e7bcf780814d8667f7bf6ca684f673 Mon Sep 17 00:00:00 2001 From: defanor Date: Thu, 26 Apr 2018 02:17:17 +0300 Subject: Add authoring tools --- tools/README | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 tools/README (limited to 'tools/README') diff --git a/tools/README b/tools/README new file mode 100644 index 0000000..c7bf4c9 --- /dev/null +++ b/tools/README @@ -0,0 +1,38 @@ +These are the tools I use for my personal web page authoring. + +The scripts can be improved to process just the modified files (and to +be less hacky in general), the XSLTs can be made more generic, but it +works for now, and is pretty simple. + + +Editing: +- skeleton.xml is the primary skeleton to start with, for *.xhtml + files in ~/homepage/src/. + +This stage is mostly needed to get unified styles, metadata +properties, and other bits in case if I'll change them. The same can +be achieved by processing (X)HTML files, but such a processing may get +tricky, and it's also nicer to have a less verbose skeleton. + +Editing is done with the emacs html-mode, with +. + + +HTML: + +- xml-to-html.sh translates source files into actual (X)HTML in + ~/homepage/ by applying xml-to-html.xsl to them. + + +Atom feed: + +- html-to-atom-dump.xsl dumps HTML files into a single atom feed. +- atom-sort.xsl sorts those by modification date. +- atom-limit.xsl limits them, taking the newest entries. +- html-to-atom.sh finds source files, and pipes them through the + XSLTs. + + +Publishing: + +- publish.sh runs the above two and uploads the files with rsync. -- cgit v1.2.3