emacs-orgmode
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Examples of online documentation written with Org-mode


From: Thomas Redelberger
Subject: Re: Examples of online documentation written with Org-mode
Date: Sun, 11 Aug 2024 19:21:03 +0200
User-agent: Mozilla Thunderbird

All pages of my personal web-site are written in Org (except for sitemap):
 https://web222.webclient5.de

I have documented how I use the built-in org to html export:
 https://web222.webclient5.de/doc/swdev/emacs/orgmode/html

I do not use org-publish.
The navigation, headers and footes of my site are generated using XSLT, CSS and 
a few python scripts, which are open source:
 https://web222.webclient5.de/prj/content/trgensit
A ZIP file contains also tree-like documentation (i.e. multiple HTML files), 
which was generated by the package...
I did /not/ include the org sources of the pages - only resulting HTML - to 
avoid confusing those that might want to use the site generator without org.

Best regards
Thomas
--
Thomas Redelberger
redetho@gmx.de

Am 11.08.2024 um 09:59 schrieb Phil:





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





reply via email to

[Prev in Thread] Current Thread [Next in Thread]