diff --git a/doc/images/library-of-babel.png b/doc/images/library-of-babel.png new file mode 100644 index 000000000..26973e08c Binary files /dev/null and b/doc/images/library-of-babel.png differ diff --git a/doc/images/tower-of-babel.jpg b/doc/images/tower-of-babel.jpg new file mode 100644 index 000000000..3279a88d4 Binary files /dev/null and b/doc/images/tower-of-babel.jpg differ diff --git a/doc/images/tower-of-babel.png b/doc/images/tower-of-babel.png new file mode 100644 index 000000000..3c1a3f132 Binary files /dev/null and b/doc/images/tower-of-babel.png differ diff --git a/doc/stylesheet.css b/doc/stylesheet.css new file mode 100644 index 000000000..3b8ef4f22 --- /dev/null +++ b/doc/stylesheet.css @@ -0,0 +1,9 @@ + #logo { + float:right; + } + + #logo #attr { + float:center; + text-align:center; + margin-top:-1em; + } diff --git a/library-of-babel.org b/library-of-babel.org index 2de8bad4d..2e9c92568 100644 --- a/library-of-babel.org +++ b/library-of-babel.org @@ -3,7 +3,14 @@ #+OPTIONS: H:3 num:nil toc:t #+STARTUP: odd hideblocks -[[http://downlode.org/Etext/library_of_babel.html][Full text of the Borges short story]] +#+begin_html + +#+end_html * Plotting code Plot column 2 (y axis) against column 1 (x axis). Columns 3 and beyond, if present, are ignored. diff --git a/org-babel-worg.org b/org-babel-worg.org index 8233a5ce9..31693100d 100644 --- a/org-babel-worg.org +++ b/org-babel-worg.org @@ -8,6 +8,15 @@ #+LANGUAGE: en #+CATEGORY: worg +#+begin_html + +#+end_html + * Introduction Org-babel provides the following modifications to [[http://orgmode.org/manual/Literal-examples.html][the existing support]] for blocks of source code examples in the org-mode core. @@ -72,6 +81,17 @@ c(5, 10) * A meta-programming language for org-mode * Spreadsheet plugins for org-mode in any language +* Library of Babel +Org-babel support saving of source-code blocks in a library from which +they can be call in any org-mode file. This library is called the +[[file:library-of-babel.org][Library of Babel]]. It is possible to add source-code blocks from any +org-mode file to the library by calling + +#+srcname: add-file-to-lob +#+begin_src emacs-lisp +(org-babel-lob-ingest "path/to/file.org") +#+end_src + * Reproducible research - output vs. value mode - file & graphical output diff --git a/publish-babel.org b/publish-babel.org new file mode 100644 index 000000000..11ce3c43b --- /dev/null +++ b/publish-babel.org @@ -0,0 +1,38 @@ +#+TITLE: Tools for publishing Org-babel documentation +#+OPTIONS: toc:nil num:nil ^:nil + +* org-babel-documentation Project + +This defines the =org-babel-documentation= project, for ease of +publishing. Publish a project with =C-c C-e X=. + +#+begin_src emacs-lisp :results silent + (setq org-babel-dir (file-name-directory (or load-file-name buffer-file-name))) + (unless (boundp 'org-publish-project-alist) + (setq org-publish-project-alist nil)) + (setq org-publish-project-alist + (cons + `("org-babel-documentation" + :base-directory ,org-babel-dir + :base-extension "org" + :exclude "org-babel.org" + :publishing-directory ,(expand-file-name "doc" org-babel-dir) + :index-filename "org-babel-worg.org" + :auto-postamble nil + :style "") + org-publish-project-alist)) +#+end_src + +* org-babel-documentation stylesheet + +#+begin_src css :tangle doc/stylesheet + #logo { + float:right; + } + + #logo #attr { + float:center; + text-align:center; + margin-top:-1em; + } +#+end_src