From mboxrd@z Thu Jan 1 00:00:00 1970 From: Karsten Schmidt Subject: [ANN] thi.ng/org-spec template for tech specs & HTML export theme Date: Sun, 31 Jul 2016 13:53:52 +0100 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:45973) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bTqFh-000609-6Y for emacs-orgmode@gnu.org; Sun, 31 Jul 2016 08:53:58 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bTqFe-0005kd-Pl for emacs-orgmode@gnu.org; Sun, 31 Jul 2016 08:53:56 -0400 Received: from mail-io0-x243.google.com ([2607:f8b0:4001:c06::243]:34487) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bTqFe-0005kZ-KZ for emacs-orgmode@gnu.org; Sun, 31 Jul 2016 08:53:54 -0400 Received: by mail-io0-x243.google.com with SMTP id g86so12690399ioj.1 for ; Sun, 31 Jul 2016 05:53:54 -0700 (PDT) List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: emacs-orgmode@gnu.org Hi everyone, this is my first post to this list, but I've been using org-mode daily for the past 3.5 years and can't imagine living without anymore (professionally). Thanks for bringing so much joy to my job! :) My main use case for org-mode has been literate programming[1] and recently also writing lots of technical specification docs, for which I believe org-mode is *perfectly* suited. To give a little back to this amazing group of people, I've just published a skeleton template for writing tech docs and publishing them as HTML. GH project: http://thi.ng/org-spec Demo: http://demo.thi.ng/org-spec The template demonstrates the following features: - Inline, text-based diagramming via Ditaa, Graphviz & PlantUML - Hyperlink abbreviations (incl. presets for GitHub, RFC, W3C, Wikipedia) - Section status flags, tags & custom properties - Tables - Named section IDs for internal x-refs - Footnotes - Automatically updating fields (e.g. publication date) - Automatic updating of document changelog (using selective git commits) - Beautiful, minimal, responsive CSS theme with print support (also for PDF generation) - Basic syntax highlighting of code blocks Hope some of you find this useful! PRs are welcome! Best, K. [1] Several Clojure projects in my thi.ng collection have been developed exclusively in org-mode: http://thi.ng/fabric, http://thi.ng/geom, http://thi.ng/trio to name a few... -- Karsten Schmidt http://thi.ng | http://postspectacular.com | http://toxiclibs.org