diff options
author | Sacha Chua <sacha@sachachua.com> | 2020-11-10 13:34:03 -0500 |
---|---|---|
committer | Sacha Chua <sacha@sachachua.com> | 2020-11-10 13:34:03 -0500 |
commit | fc01255025f3270df0f275055b3c18b1cb2d00f0 (patch) | |
tree | 5e1596af00a00e702c6619aeaf2e982afbedd39c /2020/info/14.md | |
parent | ae5c1f030b9c43a3ebae981bc2295bcabae5fc10 (diff) | |
download | emacsconf-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.md | 25 |
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 – 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. + |