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          org-publish-project-alist))
  26 #+end_src
  27
  28 * org-babel-documentation stylesheet
  29
  30 Calling =org-babel-tangle= in this file will export the css file for
  31 the Org-babel documentation.
  32
  33 #+begin_src css :tangle doc/stylesheet
  34   #logo {
  35       float:right;
  36   }
  37
  38   #logo #attr {
  39       float:center;
  40       text-align:center;
  41       margin-top:-1em;
  42   }
  43
  44   #subtitle {
  45       float:center;
  46       text-align:center;
  47   }
  48 #+end_src