docutils-users — General discussions, questions, help requests.

[Docutils-users] reStructuredText vs Markdown for Rust's documentation

[Tony N. <to...@gi...>]

Greetings Docutils Users,

Earlier, I also posted information about Cmake's partial reStructuredText
processing in C++ [1] from a thread about reST implementation in other
languages.

There is a thread where the rust language is looking over reST vs Markdown.

https://internals.rust-lang.org/t/rustdoc-restructuredtext-vs-markdown/356

Anything in responses look like things that could be misunderstandings
about reST that could documented by us or helped in someway?

Notes from Chris Morgan's presentation on rustdocs, which goes over Java
Documentation and Python Documentation:

http://chrismorgan.info/blog/rust-docs-vision-presentation.html


Where do you think Markdown stands between reStructuredText for technical
documentation?


[1] https://github.com/Kitware/CMake/search?utf8=%E2%9C%93&q=cmrst

Re: [Docutils-users] [Docutils-develop] RinohType 0.1.1 released

[Roberto A. <ra...@ne...>]

On 29/04/15 12:23, Tony Narlock wrote:
> I stand corrected.
>
> By the way, are you the author of https://github.com/ralsina/rst2pdf?
>

Yes sir.

>
> On Wed, Apr 29, 2015 at 10:05 AM, Roberto Alsina 
> <ra...@ne... <mailto:ra...@ne...>> wrote:
>
>     On 29/04/15 12:02, Tony Narlock wrote:
>     > > On 2015-04-28, Brecht Machiels wrote:
>     > >
>     > >> RinohType can render a structured text document (only
>     reStructuredText
>     > >> at the moment) to a PDF based on a document template and a
>     style sheet.
>     > >
>     > > There is a contributed PDF writer and rst2pdf.py front-end
>     based on
>     > > "reportlab" for many years. It used to be in the sandbox and
>     moved to a
>     > > separate host eventually...
>     > >
>     > > rst2odf + LibreOffice provides another alternative route to PDF.
>     >
>     > I know there are alternatives. What is your point?
>     >
>     > I did try to use the rst2pdf Sphinx builder a while ago. It
>     produced a
>     > corrupt PDF and it seems to abandoned by the developer, so I
>     don't think
>     > rst2pdf can be recommended at the moment.
>
>     That's not the rst2pdf he's referring to.
>
>     ------------------------------------------------------------------------------
>     One dashboard for servers and applications across
>     Physical-Virtual-Cloud
>     Widest out-of-the-box monitoring support with 50+ applications
>     Performance metrics, stats and reports that give you Actionable
>     Insights
>     Deep dive visibility with transaction tracing using APM Insight.
>     http://ad.doubleclick.net/ddm/clk/290420510;117567292;y
>     _______________________________________________
>     Docutils-users mailing list
>     Doc...@li...
>     <mailto:Doc...@li...>
>     https://lists.sourceforge.net/lists/listinfo/docutils-users
>
>     Please use "Reply All" to reply to the list.
>
>

Re: [Docutils-users] [Docutils-develop] RinohType 0.1.1 released

[Tony N. <to...@gi...>]

I stand corrected.

By the way, are you the author of https://github.com/ralsina/rst2pdf?


On Wed, Apr 29, 2015 at 10:05 AM, Roberto Alsina <ra...@ne...
> wrote:

> On 29/04/15 12:02, Tony Narlock wrote:
> > > On 2015-04-28, Brecht Machiels wrote:
> > >
> > >> RinohType can render a structured text document (only reStructuredText
> > >> at the moment) to a PDF based on a document template and a style
> sheet.
> > >
> > > There is a contributed PDF writer and rst2pdf.py front-end based on
> > > "reportlab" for many years. It used to be in the sandbox and moved to a
> > > separate host eventually...
> > >
> > > rst2odf + LibreOffice provides another alternative route to PDF.
> >
> > I know there are alternatives. What is your point?
> >
> > I did try to use the rst2pdf Sphinx builder a while ago. It produced a
> > corrupt PDF and it seems to abandoned by the developer, so I don't think
> > rst2pdf can be recommended at the moment.
>
> That's not the rst2pdf he's referring to.
>
>
> ------------------------------------------------------------------------------
> One dashboard for servers and applications across Physical-Virtual-Cloud
> Widest out-of-the-box monitoring support with 50+ applications
> Performance metrics, stats and reports that give you Actionable Insights
> Deep dive visibility with transaction tracing using APM Insight.
> http://ad.doubleclick.net/ddm/clk/290420510;117567292;y
> _______________________________________________
> 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] [Docutils-develop] RinohType 0.1.1 released

[Roberto A. <ra...@ne...>]

On 29/04/15 12:02, Tony Narlock wrote:
> > On 2015-04-28, Brecht Machiels wrote:
> >
> >> RinohType can render a structured text document (only reStructuredText
> >> at the moment) to a PDF based on a document template and a style sheet.
> >
> > There is a contributed PDF writer and rst2pdf.py front-end based on
> > "reportlab" for many years. It used to be in the sandbox and moved to a
> > separate host eventually...
> >
> > rst2odf + LibreOffice provides another alternative route to PDF.
>
> I know there are alternatives. What is your point?
>
> I did try to use the rst2pdf Sphinx builder a while ago. It produced a
> corrupt PDF and it seems to abandoned by the developer, so I don't think
> rst2pdf can be recommended at the moment.

That's not the rst2pdf he's referring to.

Re: [Docutils-users] [Docutils-develop] RinohType 0.1.1 released

[Tony N. <to...@gi...>]

Frankly, I can attest, I haven't looked into our PDF/LaTeX processing at
all in docutils yet. I know it's an area I want to get to - particularly
when it comes to rendering unicode (hanzi) characters.

I'm happy for your effort and thanks for bringing it to light here. I think
reception would be better if kept in docutils-users.

As for the license part - I don't agree, but trust your heart is in the
right place. I don't want to turn this thread into a license debate, but
feel free to message if me off-list if you want to talk about it.

Keep up the good work Brecht


On Wed, Apr 29, 2015 at 1:48 AM, Brecht Machiels <bre...@mo...>
wrote:

> On Tue, 28 Apr 2015 23:33:27 +0200, Guenter Milde <mi...@us...>
> wrote:
>
> > On 2015-04-28, Brecht Machiels wrote:
> >
> >> RinohType can render a structured text document (only reStructuredText
> >> at the moment) to a PDF based on a document template and a style sheet.
> >
> > There is a contributed PDF writer and rst2pdf.py front-end based on
> > "reportlab" for many years. It used to be in the sandbox and moved to a
> > separate host eventually...
> >
> > rst2odf + LibreOffice provides another alternative route to PDF.
>
> I know there are alternatives. What is your point?
>
> I did try to use the rst2pdf Sphinx builder a while ago. It produced a
> corrupt PDF and it seems to abandoned by the developer, so I don't think
> rst2pdf can be recommended at the moment.
>
> >> It should be able to replace the Sphinx LaTeX builder eventually.
> >
> > LaTeX comprises typesetting experience of dekades. RT may provide an
> > quick and easy alternative eventually, but replacement? I doubt it.
>
> LaTeX has many problems worth fixing. But you are free to doubt, of course.
> Luckily, the availability of RinohType does not affect the LaTeX option in
> any way, so you can just keep on using that.
>
> I don't expect you to be enthusiastic about RinohType. But if you can't
> provide any useful feedback, please refrain from replying to announcements
> like this.
>
> Brecht
>
>
>
> ------------------------------------------------------------------------------
> One dashboard for servers and applications across Physical-Virtual-Cloud
> Widest out-of-the-box monitoring support with 50+ applications
> Performance metrics, stats and reports that give you Actionable Insights
> Deep dive visibility with transaction tracing using APM Insight.
> http://ad.doubleclick.net/ddm/clk/290420510;117567292;y
> _______________________________________________
> Docutils-develop mailing list
> Doc...@li...
> https://lists.sourceforge.net/lists/listinfo/docutils-develop
>
> Please use "Reply All" to reply to the list.
>

Re: [Docutils-users] 2015: reStructuredText implementations in other programming languages?

[Tony N. <to...@gi...>]

(While studying systems programming...)

CMake 3.0 has implemented a subset of reStructuredText + Sphinx in C++:

   -
   https://github.com/Kitware/CMake/blob/bb9d71b4fee2cc4abf55e0dcbadf85c6cbe0d07d/Source/cmRST.cxx
   -
   https://github.com/Kitware/CMake/blob/bb9d71b4fee2cc4abf55e0dcbadf85c6cbe0d07d/Source/cmRST.h



On Mon, Apr 27, 2015 at 12:45 PM, Brecht Machiels <bre...@mo...
> wrote:

> On Wed, 22 Apr 2015 11:35:06 +0200, Tony Narlock <to...@gi...>
> wrote:
>
> > Greetings docutils users,
> >
> > Where do things stand with reStructuredText in other programming
> > languages?  Does anyone know any attempts? As it stands, I've seen a
> > couple
> > of non-python applications using reST - but they were just wrapping
> > docutils.
>
> I think the Nim programming language has adopted rST for its documentation
> [1]. They have an rST parser [2] written in Nim. I don't know how complete
> this implementation is.
>
> [1] http://nim-lang.org/docgen.html
> [2] http://nim-lang.org/rstast.html
>
> You should also look at this SO question:
> http://stackoverflow.com/questions/2746692/restructuredtext-tool-support
> It has a long list of rST tools.
>
> Best Regards,
> Brecht
>
>
>
> ------------------------------------------------------------------------------
> One dashboard for servers and applications across Physical-Virtual-Cloud
> Widest out-of-the-box monitoring support with 50+ applications
> Performance metrics, stats and reports that give you Actionable Insights
> Deep dive visibility with transaction tracing using APM Insight.
> http://ad.doubleclick.net/ddm/clk/290420510;117567292;y
> _______________________________________________
> 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] RinohType 0.1.1 released

[Brecht M. <bre...@mo...>]

My apologies for the double post.

Coincidentally, can anyone recommend a decent news reader for Mac? I'm  
currently using Opera Mail (which I blame for this double post and some  
other annoyances). I have previously ditched Unison.

Cheers,
Brecht

On Mon, 27 Apr 2015 20:01:13 +0200, Brecht Machiels  
<bre...@mo...> wrote:

> Hello,
>
> RinohType is a document processor inspired by LaTeX and written in  
> Python.
> Version 0.1.1 is the first release and is incomplete and very buggy.
> Nonetheless, it should be able to render most reStructuredText files and
> it also includes a Sphinx builder.
>
> You can read more about RinohType here:
> http://www.mos6581.org/rinohtype_status_update_1
> And the PyPI link: https://pypi.python.org/pypi/RinohType/0.1.1
>
> Bug reports and other feedback are highly appreciated.
>
> Best regards,
> Brecht Machiels

[Docutils-users] RinohType 0.1.1 released

[Brecht M. <bre...@mo...>]

Hello,

RinohType is a document processor inspired by LaTeX and written in Python.
Version 0.1.1 is the first release and is incomplete and very buggy.
Nonetheless, it should be able to render most reStructuredText files and
it also includes a Sphinx builder.

You can read more about RinohType here:
http://www.mos6581.org/rinohtype_status_update_1
And the PyPI link: https://pypi.python.org/pypi/RinohType/0.1.1

Bug reports and other feedback are highly appreciated.

Best regards,
Brecht Machiels

[Docutils-users] RinohType 0.1.1 released

[Brecht M. <bre...@mo...>]

Hello,

RinohType is a document processor inspired by LaTeX and written in Python.
Version 0.1.1 is the first release and is incomplete and very buggy.
Nonetheless, it should be able to render most reStructuredText files and
it also includes a Sphinx builder.

You can read more about RinohType here:
http://www.mos6581.org/rinohtype_status_update_1
And the PyPI link: https://pypi.python.org/pypi/RinohType/0.1.1

Bug reports and other feedback are highly appreciated.

Best regards,
Brecht Machiels

Re: [Docutils-users] 2015: reStructuredText implementations in other programming languages?

[Brecht M. <bre...@mo...>]

On Wed, 22 Apr 2015 11:35:06 +0200, Tony Narlock <to...@gi...> wrote:

> Greetings docutils users,
>
> Where do things stand with reStructuredText in other programming
> languages?  Does anyone know any attempts? As it stands, I've seen a  
> couple
> of non-python applications using reST - but they were just wrapping
> docutils.

I think the Nim programming language has adopted rST for its documentation  
[1]. They have an rST parser [2] written in Nim. I don't know how complete  
this implementation is.

[1] http://nim-lang.org/docgen.html
[2] http://nim-lang.org/rstast.html

You should also look at this SO question:  
http://stackoverflow.com/questions/2746692/restructuredtext-tool-support
It has a long list of rST tools.

Best Regards,
Brecht

Re: [Docutils-users] 2015: reStructuredText implementations in other programming languages?

[Zeth <the...@gm...>]

Markdown is the VHS of the plain text world. RST is the Betamax,
technically superior but lower adoption.

The Tables in RST are far superior, especially since they are natively
supported by Emacs Table Mode (which comes by default in Emacs 25?
24.x? Cannot remember which exactly).

I think one of the reasons Markdown often wins out is that Markdown's
inline links are much quicker for people used to HTML or Wikis to
understand.

RST's link format is superior in that the reference style links look
nicer in the textual format of the document, but that is kinda Betamax
again, most people using a plain text format are doing small textbox
style editing rather than writing a whole document.

RST and the docutils setup are better for longer texts or documentation.

On 23 April 2015 at 23:21, Philipp A. <fly...@we...> wrote:
> Skip Montanaro <sk...@po...> schrieb am Mi., 22. Apr. 2015 um 15:21 Uhr:
>>
>> Hasn't Markdown kind of taken over the marked-up-text world these days? Or
>> is that just how it appears since that's what Github supports?
>>
>> Skip
>
>
> it certainly has taken over the *non-semantic* world.
>
> reddit comments, readmes, forums, bug trackers.
>
> but i real documents, rST’s flexibility is unparalleled. except for LaTeX,
> which is a programming language and therefore has to be executed.
>
> an example where rST is perfect:
> http://flask.pocoo.org/docs/0.10/quickstart/#a-minimal-application
>
> https://github.com/mitsuhiko/flask/blob/master/docs/quickstart.rst
>
> the roles :class:, :meth:, :file:, :command:, :option:, :exc:, :attr:, … all
>  semantically define what the text is, and allow independent styling, links
> to the official python docs, other project’s docs (e.g. werkzeug), and other
> parts of the same docs.
>
> the same can be applied to blocks. rST also knows citations, …
>
> ------------------------------------------------------------------------------
> One dashboard for servers and applications across Physical-Virtual-Cloud
> Widest out-of-the-box monitoring support with 50+ applications
> Performance metrics, stats and reports that give you Actionable Insights
> Deep dive visibility with transaction tracing using APM Insight.
> http://ad.doubleclick.net/ddm/clk/290420510;117567292;y
> _______________________________________________
> 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] 2015: reStructuredText implementations in other programming languages?

[Philipp A. <fly...@we...>]

Skip Montanaro <sk...@po...> schrieb am Mi., 22. Apr. 2015 um 15:21 Uhr:

> Hasn't Markdown kind of taken over the marked-up-text world these days? Or
> is that just how it appears since that's what Github supports?
>
> Skip
>

it certainly has taken over the *non-semantic* world.

reddit comments, readmes, forums, bug trackers.

but i real documents, rST’s flexibility is unparalleled. except for LaTeX,
which is a programming language and therefore has to be executed.

an example where rST is perfect:
http://flask.pocoo.org/docs/0.10/quickstart/#a-minimal-application

https://github.com/mitsuhiko/flask/blob/master/docs/quickstart.rst

the roles :class:, :meth:, :file:, :command:, :option:, :exc:, :attr:, … all
 semantically define what the text is, and allow independent styling, links
to the official python docs, other project’s docs (e.g. werkzeug), and
other parts of the same docs.

the same can be applied to blocks. rST also knows citations, …

Re: [Docutils-users] 2015: reStructuredText implementations in other programming languages?

[Peter F. <pf...@ar...>]

Roberto Alsina schrieb am Mittwoch, den 22.04.2015 um 10:24:
> On 22/04/15 10:20, Skip Montanaro wrote:
> > Hasn't Markdown kind of taken over the marked-up-text world these 
> > days? Or is that just how it appears since that's what Github supports?
> 
> GitHub also supports rst. Just use foo.rst as a filename:
> 
> https://github.com/getnikola/nikola/blob/master/README.rst

IMHO comparing the ugliness auf MarkDown with the beauty of ReST this 
seems to be unfortunately something which should be made more public
amongst Github users.

BTW: Who can contribute reports about her/his experiences
with pandoc ( https://github.com/jgm/pandoc ) to this discussion?
I've experimented in a project with the following makefile rule but
later decided to manually edit the resulting .rst files a lot.

%.rst: %.md
    pandoc $< -f markdown -t rst -o $@

To the OP question: Pandoc seems to contain a partly finished
ReST implementation in the programming language Haskell.  From the
description of the Pandoc project I guess, that Davids original
architecture of docutils might have inspired the author of Pandoc.

Regards, Peter Funk
-- 
Peter Funk, home: ✉Oldenburger Str.86, D-27777 Ganderkesee
mobile:+49-179-640-8878 phone:+49-421-20419-0 <http://www.artcom-gmbh.de/>
office: ArtCom GmbH, ✉Haferwende 2, D-28357 Bremen, Germany

Re: [Docutils-users] 2015: reStructuredText implementations in other programming languages?

[Grzegorz A. H. <rs...@gr...>]

El 22/04/2015, a las 11:35, Tony Narlock <to...@gi...> escribió:
> 
> Where do things stand with reStructuredText in other programming languages?  Does anyone know any attempts? As it stands, I've seen a couple of non-python applications using reST - but they were just wrapping docutils.

Lazy_rest (https://github.com/gradha/lazy_rest) implements a minimal rst spec in Nim. Since Nim compiles to C you can statically link it in most C software.

Re: [Docutils-users] 2015: reStructuredText implementations in other programming languages?

[George V. R. <ge...@re...>]

StackOverflow and all the other StackExchange sites use Markdown heavily. I
think the plethora of Markdown implementations in different languages has
helped its adoption.

There's also VST, an implementation of reStructuredText in VimL, Vim's
native extension language. I used it for a year or so and gave the author
feedback, but it was never great.
https://github.com/vim-scripts/VST/blob/master/doc2/vst.txt

-- 
/George V. Reilly  ge...@re...  Twitter: @georgevreilly
*http://georgevreilly.github.io/ <http://georgevreilly.github.io/>*

On Wed, Apr 22, 2015 at 10:26 AM, Kevin Horn <kev...@gm...> wrote:

> @Skip
>
> IMO, RestructuredText and Markdown fill different niches.  Markdown really
> targets HTML output and is quite limited when talking about other output
> formats.  This is mainly because it only supports a limited group of
> document elements.  If you need something outside this set of elements, the
> Markdown way of handling this is to insert raw html.  This really makes
> markdown only suitable for (relatively) simple documents or documents that
> will be turned into HTML.
>
> RestructuredText tries much harder to support whatever type of document
> element you happen to need, and if one isn't supported, it has built in
> extension mechanisms (custom directives/roles) which you can use.  This
> allows it to be much more useful if you want to support non-HTML output
> formats.
>
> There's room for both in the ecosystem, as they do different things
> (though there is some overlap).
>
> As far as Markdown taking over, I would say that both have experienced
> quite a bit of growth in the last few years, Markdown mostly being used for
> simple documents, and HTML fragments (thinking comments here), and
> RestructuredText getting a lot of use and exposure via Sphinx (which is
> used for lots of projects even outside the Python community).
>
>
> On Wed, Apr 22, 2015 at 8:20 AM, Skip Montanaro <sk...@po...> wrote:
>
>> Hasn't Markdown kind of taken over the marked-up-text world these days?
>> Or is that just how it appears since that's what Github supports?
>>
>> Skip
>>
>>
>>
>> ------------------------------------------------------------------------------
>> BPM Camp - Free Virtual Workshop May 6th at 10am PDT/1PM EDT
>> Develop your own process in accordance with the BPMN 2 standard
>> Learn Process modeling best practices with Bonita BPM through live
>> exercises
>> http://www.bonitasoft.com/be-part-of-it/events/bpm-camp-virtual-
>> event?utm_
>> source=Sourceforge_BPM_Camp_5_6_15&utm_medium=email&utm_campaign=VA_SF
>> _______________________________________________
>> Docutils-users mailing list
>> Doc...@li...
>> https://lists.sourceforge.net/lists/listinfo/docutils-users
>>
>> Please use "Reply All" to reply to the list.
>>
>>
>
>
> --
> --
> Kevin Horn
>
>
> ------------------------------------------------------------------------------
> BPM Camp - Free Virtual Workshop May 6th at 10am PDT/1PM EDT
> Develop your own process in accordance with the BPMN 2 standard
> Learn Process modeling best practices with Bonita BPM through live
> exercises
> http://www.bonitasoft.com/be-part-of-it/events/bpm-camp-virtual-
> event?utm_
> source=Sourceforge_BPM_Camp_5_6_15&utm_medium=email&utm_campaign=VA_SF
> _______________________________________________
> 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] 2015: reStructuredText implementations in other programming languages?

[Kevin H. <kev...@gm...>]

@Skip

IMO, RestructuredText and Markdown fill different niches.  Markdown really
targets HTML output and is quite limited when talking about other output
formats.  This is mainly because it only supports a limited group of
document elements.  If you need something outside this set of elements, the
Markdown way of handling this is to insert raw html.  This really makes
markdown only suitable for (relatively) simple documents or documents that
will be turned into HTML.

RestructuredText tries much harder to support whatever type of document
element you happen to need, and if one isn't supported, it has built in
extension mechanisms (custom directives/roles) which you can use.  This
allows it to be much more useful if you want to support non-HTML output
formats.

There's room for both in the ecosystem, as they do different things (though
there is some overlap).

As far as Markdown taking over, I would say that both have experienced
quite a bit of growth in the last few years, Markdown mostly being used for
simple documents, and HTML fragments (thinking comments here), and
RestructuredText getting a lot of use and exposure via Sphinx (which is
used for lots of projects even outside the Python community).


On Wed, Apr 22, 2015 at 8:20 AM, Skip Montanaro <sk...@po...> wrote:

> Hasn't Markdown kind of taken over the marked-up-text world these days? Or
> is that just how it appears since that's what Github supports?
>
> Skip
>
>
>
> ------------------------------------------------------------------------------
> BPM Camp - Free Virtual Workshop May 6th at 10am PDT/1PM EDT
> Develop your own process in accordance with the BPMN 2 standard
> Learn Process modeling best practices with Bonita BPM through live
> exercises
> http://www.bonitasoft.com/be-part-of-it/events/bpm-camp-virtual-
> event?utm_
> source=Sourceforge_BPM_Camp_5_6_15&utm_medium=email&utm_campaign=VA_SF
> _______________________________________________
> Docutils-users mailing list
> Doc...@li...
> https://lists.sourceforge.net/lists/listinfo/docutils-users
>
> Please use "Reply All" to reply to the list.
>
>


-- 
--
Kevin Horn

Re: [Docutils-users] 2015: reStructuredText implementations in other programming languages?

[Roberto A. <ra...@ne...>]

On 22/04/15 08:51, TP wrote:
> On Wed, Apr 22, 2015 at 2:35 AM, Tony Narlock <to...@gi...> wrote:
>> Greetings docutils users,
>>
>> Where do things stand with reStructuredText in other programming languages?
>> Does anyone know any attempts? As it stands, I've seen a couple of
>> non-python applications using reST - but they were just wrapping docutils.
> Jetbrains has a java implementation [1] used in their Python PyCharm
> product [2]. Not sure how complete it is and there isn't much activity
> on it.
>
> PyCharm page says "Epydoc and reStructuredText markup highlighting and
> code completion for tags and tag parameters. Docstrings and the code
> matching verification, and autoupdate on refactoring."
>
> [1] https://github.com/JetBrains/intellij-community/tree/master/python/rest/src/com/jetbrains/rest
>
> [2] https://www.jetbrains.com/pycharm/features/

Pandoc supports a subset of ReST and is written in Haskell IIRC

> ------------------------------------------------------------------------------
> BPM Camp - Free Virtual Workshop May 6th at 10am PDT/1PM EDT
> Develop your own process in accordance with the BPMN 2 standard
> Learn Process modeling best practices with Bonita BPM through live exercises
> http://www.bonitasoft.com/be-part-of-it/events/bpm-camp-virtual- event?utm_
> source=Sourceforge_BPM_Camp_5_6_15&utm_medium=email&utm_campaign=VA_SF
> _______________________________________________
> 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] 2015: reStructuredText implementations in other programming languages?

[Roberto A. <ra...@ne...>]

On 22/04/15 10:20, Skip Montanaro wrote:
> Hasn't Markdown kind of taken over the marked-up-text world these 
> days? Or is that just how it appears since that's what Github supports?
>

GitHub also supports rst. Just use foo.rst as a filename:

https://github.com/getnikola/nikola/blob/master/README.rst

Re: [Docutils-users] 2015: reStructuredText implementations in other programming languages?

[Skip M. <sk...@po...>]

Hasn't Markdown kind of taken over the marked-up-text world these days? Or
is that just how it appears since that's what Github supports?

Skip

Re: [Docutils-users] 2015: reStructuredText implementations in other programming languages?

[TP <wi...@gm...>]

On Wed, Apr 22, 2015 at 2:35 AM, Tony Narlock <to...@gi...> wrote:
> Greetings docutils users,
>
> Where do things stand with reStructuredText in other programming languages?
> Does anyone know any attempts? As it stands, I've seen a couple of
> non-python applications using reST - but they were just wrapping docutils.

You don't bother to mention it for some reason, but the docutils
"Emacs Support for reStructuredText" [1] uses elisp to understand
quite a bit about reStructured text documents.

[1] http://docutils.sourceforge.net/docs/user/emacs.html

Re: [Docutils-users] 2015: reStructuredText implementations in other programming languages?

[Terry B. <ter...@ya...>]

On Wed, 22 Apr 2015 11:59:41 +0000 (UTC)
Guenter Milde <mi...@us...> wrote:

> On 2015-04-22, Tony Narlock wrote:
> 
> > Greetings docutils users,
> 
> > Where do things stand with reStructuredText in other programming
> > languages?  Does anyone know any attempts? As it stands, I've seen
> > a couple of non-python applications using reST - but they were just
> > wrapping docutils.
> 
> There is prest (perl reStructuredText) in the sandbox.
> 
> I don't know how the Leo outline/editer
> http://leoeditor.com/tutorial-rst3.html
> implements its rST support.

Leo is in Python and uses docutils.

Cheers -Terry

> Günter
> 
> 
> ------------------------------------------------------------------------------
> BPM Camp - Free Virtual Workshop May 6th at 10am PDT/1PM EDT
> Develop your own process in accordance with the BPMN 2 standard
> Learn Process modeling best practices with Bonita BPM through live
> exercises
> http://www.bonitasoft.com/be-part-of-it/events/bpm-camp-virtual-
> event?utm_
> source=Sourceforge_BPM_Camp_5_6_15&utm_medium=email&utm_campaign=VA_SF
> _______________________________________________ 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] 2015: reStructuredText implementations in other programming languages?

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

On 2015-04-22, Tony Narlock wrote:

> Greetings docutils users,

> Where do things stand with reStructuredText in other programming
> languages?  Does anyone know any attempts? As it stands, I've seen a couple
> of non-python applications using reST - but they were just wrapping
> docutils.

There is prest (perl reStructuredText) in the sandbox.

I don't know how the Leo outline/editer
http://leoeditor.com/tutorial-rst3.html
implements its rST support.

Günter

Re: [Docutils-users] 2015: reStructuredText implementations in other programming languages?

[TP <wi...@gm...>]

On Wed, Apr 22, 2015 at 2:35 AM, Tony Narlock <to...@gi...> wrote:
> Greetings docutils users,
>
> Where do things stand with reStructuredText in other programming languages?
> Does anyone know any attempts? As it stands, I've seen a couple of
> non-python applications using reST - but they were just wrapping docutils.

Jetbrains has a java implementation [1] used in their Python PyCharm
product [2]. Not sure how complete it is and there isn't much activity
on it.

PyCharm page says "Epydoc and reStructuredText markup highlighting and
code completion for tags and tag parameters. Docstrings and the code
matching verification, and autoupdate on refactoring."

[1] https://github.com/JetBrains/intellij-community/tree/master/python/rest/src/com/jetbrains/rest

[2] https://www.jetbrains.com/pycharm/features/

[Docutils-users] 2015: reStructuredText implementations in other programming languages?

[Tony N. <to...@gi...>]

Greetings docutils users,

Where do things stand with reStructuredText in other programming
languages?  Does anyone know any attempts? As it stands, I've seen a couple
of non-python applications using reST - but they were just wrapping
docutils.

Re: [Docutils-users] screenplay markup (was Re: Nested, titled sections)

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

On 2015-04-19, David Goodger wrote:
> On Apr 19, 2015 3:22 PM, "Guenter Milde" <mi...@us...> wrote:
>> On 2015-04-14, David Goodger wrote:
>> > On Tue, Apr 14, 2015 at 3:13 PM, Jeffrey C. Jacobs
>> ><dar...@ti...> wrote:
>> >> David Goodger <goodger <at> python.org> writes:

...

>> The idea was to use a block element instead of a role. This could be a
>> generic admonition, an (ab)used pre-defined admonition (note, hint, ...)
> or
>> a custom directive (whether the parentheses are added by the directive or
>> required in the source is up to the implementation)::

>>   Character
>>     .. parenthetical:: action

>>     Dialog

> That does work. But I'd recommend a less verbose option.

>> Or you could simply put the `action` in a separate paragraph:

>>     Character
>>           `action`

>>           Dialog

> Yes, but I believe there should not be any blank lines between sections of
> dialog and parentheticals (in the output). Of course, a transform could do
> that too.

A custom paragraph style for "parenthetical" paragraphs should suffice.
(Most printed documents use indendation instead of vertical space as
paragraph separator anyway.)


>> Another, [...] option would be to (ab)use the
>> "classifier" of a definition list term ...
...

> Unfortunately that won't work, because such parentheticals can occur in
> arbitrary positions (not just at the beginning of dialog, but in the middle
> or at the end), and there can be multiple instances. The pattern doesn't
> match definition list classifiers at all.

OK. Then it is up to role (inline element) vs. directive (block element).

It should even be possible to transform all "parenthetical" role nodes to
block elements (paragraphs with class value "parenthetical", say) in a
transform. 

+1 less verbose markup (no need for blank lines)
-1 the role can be used at places where no block level markup is allowed --
   requires test and error mechanism that comes "for free" if you use a
   directive.
   
Günter