Re: Examples of online documentation written with Org-mode

[Phil <pe@7d.nz>]

* [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