From 5e7642643a5a74c4737c947e4b2e66ced59b2e59 Mon Sep 17 00:00:00 2001 From: Sacha Chua Date: Tue, 31 Oct 2023 09:37:34 -0400 Subject: Add doc talk --- 2023/talks/doc.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 2023/talks/doc.md (limited to '2023/talks') diff --git a/2023/talks/doc.md b/2023/talks/doc.md new file mode 100644 index 00000000..0f7edf2c --- /dev/null +++ b/2023/talks/doc.md @@ -0,0 +1,26 @@ +[[!meta title="Literate Documentation with Emacs and Org Mode"]] +[[!meta copyright="Copyright © 2023 Mike Hamrick"]] +[[!inline pages="internal(2023/info/doc-nav)" raw="yes"]] + + + + + +# Literate Documentation with Emacs and Org Mode +Mike Hamrick + +[[!inline pages="internal(2023/info/doc-before)" raw="yes"]] + +When writing about programming or other technical subjects, you’re often weaving blocks of source code, program output, and raw data in with your prose. These supplementary materials are usually copied and pasted into your document from other sources, which can be difficult and tedious to keep up-to-date as things change. Inconsistencies and errors can easily creep in when you “hard-code” dynamic information like program output into your writing. + +Wouldn’t it be great if the tool you used for writing knew how to run code in a variety of programming languages, collect and format output, and let you refer symbolically to all this dynamically generated content in your prose? In this talk I’ll demonstrate how to use GNU Emacs’ Org mode to create technical documents that do just that. We’ll explore the features of Babel, Org mode’s literate programming add-on, that makes it convenient to edit, evaluate, and manage embedded code, output, and data all from inside GNU Emacs. + +We'll also show how these literate documents can be exported to LaTeX and ultimately PDF format to create professional looking output that looks stunning when printed or viewed. + +Also shared at SeaGL 2023 + +[[!inline pages="internal(2023/info/doc-after)" raw="yes"]] + +[[!inline pages="internal(2023/info/doc-nav)" raw="yes"]] + + -- cgit v1.2.3