howard/lit-prog-book
1
0
Fork 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity Actions
lit-prog-book/README.org

28 lines
1.1 KiB
Org Mode
Raw Normal View History

Initial attempt at a background for the book This is just a brain dump and the Background and Advantages section need to be proof-read. We should also expand on the general outline and table of contents, as the headers here are just a start.
2024-08-03 17:01:42 +00:00
#+title: Literate Programming in Org
#+date: 2024-08-03 August
#+tags: book literate-programming lp emacs org org-mode
Initial commit
2024-08-03 15:32:23 +00:00
Initial attempt at a background for the book This is just a brain dump and the Background and Advantages section need to be proof-read. We should also expand on the general outline and table of contents, as the headers here are just a start.
2024-08-03 17:01:42 +00:00
# (progn (find-file (org-texinfo-export-to-info)) (Info-mode) (Info-top-node))
This is a book on /Literate Programming in Emacs/ using Org Mode.
The goal is to write the book as an org document, and then /export/ it as:
- Info, readable in Emacs
- PDF and Epub, readable on devices
- HTML to be viewable as a web page in EWW
- Org, downloadable and useful when this project is cloned
A question on /interactive-ness/. Since the goal is to teach LP through Emacs (and not just a general guide on LP), we want the text viewable in Emacs, so that code can be easily copy/pasted into their own notes, as well as allowing the user to enter ~C-x C-e~ on any s-expression.
To render and read [[file:lp-in-org.org][the book]] in Info, execute the following:
Bug fix in the rendering code along with minor formatting Keep in mind that Hyperlinks, while good looking in Org, HTML and other formats, are displayed inline in Info files, so we may want to consider ways to have them look good in both.
2024-08-03 17:16:07 +00:00
#+begin_src emacs-lisp :results silent
Initial attempt at a background for the book This is just a brain dump and the Background and Advantages section need to be proof-read. We should also expand on the general outline and table of contents, as the headers here are just a start.
2024-08-03 17:01:42 +00:00
(progn
Bug fix in the rendering code along with minor formatting Keep in mind that Hyperlinks, while good looking in Org, HTML and other formats, are displayed inline in Info files, so we may want to consider ways to have them look good in both.
2024-08-03 17:16:07 +00:00
(ignore-errors
(kill-buffer "lp-in-org.info"))
Initial attempt at a background for the book This is just a brain dump and the Background and Advantages section need to be proof-read. We should also expand on the general outline and table of contents, as the headers here are just a start.
2024-08-03 17:01:42 +00:00
(find-file "lp-in-org.org")
Bug fix in the rendering code along with minor formatting Keep in mind that Hyperlinks, while good looking in Org, HTML and other formats, are displayed inline in Info files, so we may want to consider ways to have them look good in both.
2024-08-03 17:16:07 +00:00
(find-file (org-texinfo-export-to-info))
Initial attempt at a background for the book This is just a brain dump and the Background and Advantages section need to be proof-read. We should also expand on the general outline and table of contents, as the headers here are just a start.
2024-08-03 17:01:42 +00:00
(Info-mode)
(Info-top-node))
#+end_src
Reference in a new issue Copy permalink