From: Thomas Redelberger <redetho@gmx.de>
To: "Sébastien Gendre" <seb@k-7.ch>
Cc: General discussions about Org-mode <emacs-orgmode@gnu.org>
Subject: Re: Examples of online documentation written with Org-mode
Date: Sun, 11 Aug 2024 19:21:03 +0200 [thread overview]
Message-ID: <de2cd1c2-0753-4d75-b488-ad9cd9200730@gmx.de> (raw)
In-Reply-To: <f312396e-832f-4439-9180-7b7e7943ac51@7d.nz>
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
>
next prev parent reply other threads:[~2024-08-11 17:22 UTC|newest]
Thread overview: 16+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-08-10 7:50 Examples of online documentation written with Org-mode Sébastien Gendre
2024-08-10 12:41 ` Samuel Loury
2024-08-10 17:01 ` Sébastien Gendre
2024-08-10 17:13 ` Ihor Radchenko
2024-08-10 19:48 ` András Simonyi
2024-08-11 5:17 ` mbork
2024-08-11 6:19 ` Ihor Radchenko
2024-08-11 7:59 ` Phil
2024-08-11 16:39 ` Ihor Radchenko
2024-08-12 10:18 ` Phil Estival
2024-08-18 12:26 ` Ihor Radchenko
2024-08-11 17:21 ` Thomas Redelberger [this message]
2024-08-11 7:45 ` Juergen Fenn
2024-08-11 18:30 ` Steve Downey
-- strict thread matches above, loose matches on Subject: below --
2024-08-11 2:41 Sébastien Gendre
2024-08-11 2:44 Sébastien Gendre
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=de2cd1c2-0753-4d75-b488-ad9cd9200730@gmx.de \
--to=redetho@gmx.de \
--cc=emacs-orgmode@gnu.org \
--cc=seb@k-7.ch \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).