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 sass :file doc/stylesheet.css :results silent
  37   #logo
  38     float: right
  39
  40   #attr
  41     font-size: 8pt
  42     float: center
  43     text-align: center
  44     margin-top: -1em
  45
  46   #subtitle
  47     float: center
  48     text-align: center
  49
  50   #content
  51     color: #2e2e2e
  52
  53   .outline-text-2
  54     margin-left: 2em
  55
  56   .outline-text-3
  57     margin-left: 2em
  58
  59   .outline-text-4
  60     margin-left: 2em
  61
  62   .outline-text-5
  63     margin-left: 2em
  64
  65   .outline-text-6
  66     margin-left: 2em
  67
  68   h3
  69     margin-left: 1em
  70     color: #000
  71
  72   a
  73     text-decoration: none
  74     color: #4a708b
  75   a:hover
  76     text-decoration: underline
  77 #+end_src