[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Examples of online documentation written with Org-mode
From: |
Phil |
Subject: |
Re: Examples of online documentation written with Org-mode |
Date: |
Sun, 11 Aug 2024 09:59:58 +0200 |
User-agent: |
Mozilla Thunderbird |
* [2024-08-11 08:19] Ihor Radchenko:
mbork@mbork.pl writes:
On 2024-08-10, at 17:13, Ihor Radchenko <yantar92@posteo.net> wrote:
Many blogs are also made with Org mode. Not sure if it qualifies for
documentation.
... my custom blog engine
(https://gitlab.com/mbork_mbork_pl/org-clive). It is a testament to the
power of Org that Org Clive is less then 400 lines of Elisp - most of
the heavy lifting is done by Org itself.
Note that it is listed in https://orgmode.org/tools.html since long ago ;)
Mine too (https://gitlab.com/7dnz/org-weblog) lands in this
category, with an emphasize on a — very verbose I admit — but strict
literate programming. It's a 99KB file, with tests, attempts,
explanations, explorations, etc.
The page documentation is produced as blog post by evaluating
directly from the code and documentation being redacted.
It doesn't use the tangle processor but evaluates one section
after the other. This is how I learned Lisp. It may stay as a
beginner's work forever but I don't mind, it works, and I like it.
Here are the functions it lacks to make it a complete blogging engine :
search, archival by year/month, previous/next post, pagination, one
folder by post, and a few custom properties :
the author of a post and a custom stylesheet per post among others.
Cheers
--
Philippe Estival
https://7d.nz
Re: Examples of online documentation written with Org-mode, Juergen Fenn, 2024/08/11
Re: Examples of online documentation written with Org-mode, Steve Downey, 2024/08/11