docutils-users

[Docutils-users] [SPAM] Gemini and rst2gemtext

[Schimon J. <sc...@fe...>]

Good day.

Are there intentions to merge rst2gemtext into docutils?

I think that it would be of at most useful to many people.

https://github.com/flozz/rst2gemtext/issues/9

Kind regards,
Schimon

[Docutils-users] [SPAM] Re: [SPAM] Gemini and rst2gemtext

[Schimon J. <sc...@fe...>]

Of course, there is already  a discussion at SF.net.

https://sourceforge.net/p/docutils/patches/200/

Schimon

On Fri, 8 Aug 2025 09:17:43 +0300
Schimon Jehudah via Docutils-users
<doc...@li...> wrote:

> Good day.
> 
> Are there intentions to merge rst2gemtext into docutils?
> 
> I think that it would be of at most useful to many people.
> 
> https://github.com/flozz/rst2gemtext/issues/9
> 
> Kind regards,
> Schimon
> 
> 
> _______________________________________________
> Docutils-users mailing list
> Doc...@li...
> https://lists.sourceforge.net/lists/listinfo/docutils-users
> 
> Please use "Reply All" to reply to the list.

Re: [Docutils-users] [SPAM] Gemini and rst2gemtext

[Guenter M. <mi...@us...>]

Dear Schimon,

On 2025-08-08, Schimon Jehudah via Docutils-users wrote:

> Are there intentions to merge rst2gemtext into docutils?
...
> https://github.com/flozz/rst2gemtext/issues/9

Currently not.  I agree, that "gemtext" export is a useful addition to
Docutils, especially as both formats are "text centered" and try to stay
distraction free.  However, I am less sure merging is the best way forward
at the current stage.  

Instead, I propose to develop the project as an "independent
sister-project", using Docutils' plug-in architecture. 

This means generating a "gemtext" writer that can be used as

   docutils --writer=gemtext  mydoc.rst > mydoc.gemtext
   
as well as in the `Publisher Interface`__ provided by `docutils.core`
(https://docutils.sourceforge.io/docs/api/publisher.html).

In Docutils, we can provide cross-links in the Documentation similar to what
we already do for "markdown" parsers.
Not only in the "Docutils Link List", but also in, e.g., 
https://docutils.sourceforge.io/docs/user/config.html#docutils-application

Regards,  
Günter

Re: [Docutils-users] [SPAM] Re: [SPAM] Gemini and rst2gemtext

[Guenter M. <mi...@us...>]

Dear Schimon,

On 2025-08-08, Schimon Jehudah via Docutils-users wrote:
> Of course, there is already  a discussion at SF.net.

> https://sourceforge.net/p/docutils/patches/200/

Mind, that this patch is about adding the "gemini:" scheme to the schemes
that are recognized in "standalone hyperlinks", i.e. not the addition of
another export format but a change to the reStructuredText specification
(a releated, but distinct topic).


Günter