|
|
@@ -3,6 +3,25 @@
|
|
|
#+OPTIONS: H:3 num:nil toc:t
|
|
|
#+STARTUP: oddeven hideblocks
|
|
|
|
|
|
+Through Org-Babel Org-Mode can communicate with programming languages.
|
|
|
+Code contained in source-code blocks can be evaluated passing and
|
|
|
+receiving data to and from org-mode files, tables, other source-code
|
|
|
+blocks, and interactive comint buffers.
|
|
|
+
|
|
|
+In this document:
|
|
|
+- The [[* Introduction][Introduction]] :: provides a brief overview of the design and use
|
|
|
+ of Org-Babel including tutorials and examples.
|
|
|
+- The [[* Tasks][Tasks]] :: section contains current and past tasks roughly ordered
|
|
|
+ by TODO state, then importance or date-completed. This would be
|
|
|
+ a good place to suggest ideas for development.
|
|
|
+- The [[* Bugs][Bugs]] :: section contains bug reports.
|
|
|
+- The [[* Tests][Tests]] :: section consists of a large table which can be
|
|
|
+ evaluated to run Org-Babel's functional test suite. This
|
|
|
+ provides a good overview of the current functionality with
|
|
|
+ pointers to example source blocks.
|
|
|
+- The [[* Sandbox][Sandbox]] :: demonstrates much of the early/basic functionality
|
|
|
+ through commented source-code blocks.
|
|
|
+
|
|
|
* Introduction
|
|
|
|
|
|
Org-Babel enables *communication* between programming languages and
|
|
|
@@ -24,10 +43,8 @@ and outputs.
|
|
|
*** simple execution
|
|
|
with both scalar, file, and table output
|
|
|
|
|
|
-
|
|
|
*** reading information from tables
|
|
|
|
|
|
-
|
|
|
*** reading information from other source blocks (disk usage in your home directory)
|
|
|
|
|
|
This will work for Linux and Mac users, not so sure about shell
|
|
|
@@ -62,7 +79,6 @@ cd ~ && du -sc * |grep -v total
|
|
|
pie(dirs[,1], labels = dirs[,2])
|
|
|
#+end_src
|
|
|
|
|
|
-
|
|
|
*** operations in/on tables
|
|
|
|
|
|
#+tblname: grades-table
|
|
|
@@ -113,6 +129,9 @@ org-babels own functional tests are contained in a large org-mode
|
|
|
table, allowing the test suite to be run be evaluation of the table
|
|
|
and the results to be collected in the same table.
|
|
|
|
|
|
+*** Emacs initialization files stored in Org-Mode buffers
|
|
|
+Once org-babel-tangle is completed this could be a very compelling use case.
|
|
|
+
|
|
|
|
|
|
** features
|
|
|
|
Eric Schulte