publish-babel.org

   1 #+TITLE: Tools for publishing Org-babel documentation
   2 #+OPTIONS: toc:t h:3 num:nil ^:nil
   3
   4 This file contains the code required to export the documentation of Org-babel.
   5
   6 * org-babel-documentation Project
   7
   8 This defines the =org-babel-documentation= project, for ease of
   9 publishing.  Publish a project with =C-c C-e X=.
  10
  11 #+begin_src emacs-lisp :results silent
  12   (setq org-babel-dir (file-name-directory (or load-file-name buffer-file-name)))
  13   (unless (boundp 'org-publish-project-alist)
  14     (setq org-publish-project-alist nil))
  15   (setq org-publish-project-alist
  16         (cons
  17          `("org-babel-documentation"
  18            :base-directory ,org-babel-dir
  19            :base-extension "org"
  20            :exclude ,(regexp-opt-group '("org-babel.org" "test-export.org" "test-tangle.org" "test-tangle-load.org"))
  21            :publishing-directory ,(expand-file-name "doc" org-babel-dir)
  22            :index-filename "org-babel-worg.org"
  23            :auto-postamble nil
  24            :style "<link rel=\"stylesheet\"href=\"stylesheet.css\"type=\"text/css\">"
  25            :publishing-function (org-publish-org-to-html org-publish-org-to-org)
  26            :plain-source t
  27            :htmlized-source t)
  28          org-publish-project-alist))
  29 #+end_src
  30
  31 * org-babel-documentation stylesheet
  32
  33 Calling =org-babel-tangle= in this file will export the css file for
  34 the Org-babel documentation.
  35
  36 #+begin_src css :tangle doc/stylesheet
  37   #logo {
  38       float:right;
  39   }
  40
  41   #logo #attr {
  42       float:center;
  43       text-align:center;
  44       margin-top:-1em;
  45   }
  46
  47   #subtitle {
  48       float:center;
  49       text-align:center;
  50   }
  51 #+end_src