summaryrefslogtreecommitdiffstats
path: root/2020/info/14.md
diff options
context:
space:
mode:
authorSacha Chua <sacha@sachachua.com>2020-11-10 13:34:03 -0500
committerSacha Chua <sacha@sachachua.com>2020-11-10 13:34:03 -0500
commitfc01255025f3270df0f275055b3c18b1cb2d00f0 (patch)
tree5e1596af00a00e702c6619aeaf2e982afbedd39c /2020/info/14.md
parentae5c1f030b9c43a3ebae981bc2295bcabae5fc10 (diff)
downloademacsconf-wiki-fc01255025f3270df0f275055b3c18b1cb2d00f0.tar.xz
emacsconf-wiki-fc01255025f3270df0f275055b3c18b1cb2d00f0.zip
Let's try it with individual info pages that are included
Diffstat (limited to '2020/info/14.md')
-rw-r--r--2020/info/14.md25
1 files changed, 25 insertions, 0 deletions
diff --git a/2020/info/14.md b/2020/info/14.md
new file mode 100644
index 00000000..34cc09df
--- /dev/null
+++ b/2020/info/14.md
@@ -0,0 +1,25 @@
+Org mode, among its numerous features, has the ability to do full
+literate programming (with tangling and weaving the way Donald Knuth
+originally intended). As a programmer, you can work comfortably,
+completely inside an org-mode buffer. When you are ready, emacs will
+generate the appropriate documentation and source code files for you.
+If you are a lone emacs user on your project, simply commit these
+exported files and keep your org file to yourself &#x2013; no one is the
+wiser.
+
+Watch "Literate Programming in Emacs Org-mode" to learn how you can
+annotate code snippets in an org file so they can be automatically
+exported to their proper locations in your source tree. Keep
+important information about your project where it should be: right
+next to the code itself. Not as ugly, out-of-date notes sitting
+behind comment characters in your source files, but front and center
+in well-formatted markdown and pdf files.
+
+And, for advanced use cases, see how you can even use a full-fledged
+macro processor like m4 to personalize your workflow even more.
+Literate programming on steroids!
+
+I'll walk you through the whole process, starting from an empty
+project README.org to a simple example that generates source and
+documentation.
+