There is a nice little editor with a live preview of MarkDown and ReStructuredText. This editor is very useful for beginners to learn a (new) markup language.
Dmitry Shachnev proposed the following answer:
This markup language looks nice to me, but it seems it's a bit broken —
it doesn't work with the latest versions of Python. I can add a support
once it's fixed.
By the way, ReText (4.0) is now using pymarkups (https://launchpad.net /python-markups) which supports custom markups — so the support should
be added there, not in ReText directly.
-------------------------------
Does anyone know, what python incompatibilities he is talking about? It seems the author of ReText is also initiator of pymarkups (should be validated).
> There is a nice little editor with a live preview of MarkDown and
> ReStructuredText.
> This editor is very useful for beginners to learn a (new) markup language.
> Dmitry Shachnev proposed the following answer:
> This markup language looks nice to me, but it seems it's a bit broken —
> it doesn't work with the latest versions of Python. I can add a support
> once it's fixed.
> By the way, ReText (4.0) is now using pymarkups (https://launchpad.net > /python-markups) which supports custom markups — so the support should
> be added there, not in ReText directly.
> Good luck with that, pymarkups seems to be essentially undocumented.
> -------------------------------
> Does anyone know, what python incompatibilities he is talking about?
Probably that asciidoc is Python 2 only for now. Probably better if you
ask them to confirm.
> It seems the author of ReText is also initiator of pymarkups (should be validated).
> --
> You received this message because you are subscribed to the Google Groups
> "asciidoc" group.
> To view this discussion on the web visit
> https://groups.google.com/d/msg/asciidoc/-/WQosd-c3S58J.
> To post to this group, send email to asciidoc@googlegroups.com.
> To unsubscribe from this group, send email to
> asciidoc+unsubscribe@googlegroups.com.
> For more options, visit this group at
> http://groups.google.com/group/asciidoc?hl=en.
> Does anyone know, what python incompatibilities he is talking about?
> Probably that asciidoc is Python 2 only for now. Probably better if you > ask them to confirm.
Yes, ReText 4.0 and pymarkups depend on python3. Dimitry i willing to integrate Asciidoc in pymarkups (which is used be ReText) as soon as it becomes available.
ReText and pymarkups (the library) render markdown and ReStructuredText to html, pdf and odt.
So when will AsciiDoc be compatible with python 3? Any plans?
> It seems the author of ReText is also initiator of pymarkups (should be
validated).
I'm here :)
> Probably that asciidoc is Python 2 only for now. Probably better if you
ask them to confirm.
Yes, that's very sad you are python 2 only for now.
Pymarkups itself supports both python 2 and python 3, as well as ReText 4.0. But we are going to drop 2.x support in ReText 4.1 because it's a pain to support three string types that occur in PyQt apps (QString, str and unicode; everything is just str in python 3).
I'll think it would be easy for me to add asciidoc support for pymarkups when you port it to python3.
Let's presume AsciiDoc for python 3 is available. What needs to be done next? How do you estimate the workload?
The workload will be adding one small file (I hope the API isn't overcomplicated), pymarkups will do the rest and asciidoc will show as available markup in ReText
On Tue, October 16, 2012 7:55 am, Dmitry Shachnev wrote:
>> It seems the author of ReText is also initiator of pymarkups (should be
> validated).
> I'm here :)
>> Probably that asciidoc is Python 2 only for now. Probably better if you
> ask them to confirm.
> Yes, that's very sad you are python 2 only for now.
I am just an asciidoc user and I am looking with interest at this
discussion. As a java developer and maintainer of a few open source
projects my answer to you would be..
imho the best thing would be to help out and see if you can help with the
migration to python3. I am sure the work is non trivial and is probably on
the roadmap but there is just too much other things for one person to do.
So help out!
There is another very nice IDE with markdown and restructuredText support: http://www.geany.org The typo3 project recently converted all their documentation to restructuredText.
One could ask himself why restructuredText is more and more widely used although AsciiDoc is far the
better markup language...
Jens
Le mardi 16 octobre 2012 22:44:59 UTC+2, Manfred Moser a écrit :
> I am just an asciidoc user and I am looking with interest at this > discussion. As a java developer and maintainer of a few open source > projects my answer to you would be..
> imho the best thing would be to help out and see if you can help with the > migration to python3. I am sure the work is non trivial and is probably on > the roadmap but there is just too much other things for one person to do. > So help out!
On 31 October 2012 22:56, Jens Getreu <jens.get...@gmail.com> wrote:
> There is another very nice IDE with markdown and restructuredText support:
> http://www.geany.org
Mea culpa, I've had an asciidoc patch for Geany for a while that gives
the same functionality as rest. I've now made a pull request to add
it to Geany https://github.com/geany/geany/pull/78.
> The typo3 project recently converted all their documentation to
> restructuredText.
> One could ask himself why restructuredText is more and more widely used
> although AsciiDoc is far the
> better markup language...
One could ask why so much code is written in C although, [your choice
here] is a much better programming language. :)
Many non-technical influences affect the popularity of languages and
that applies to markup languages too. See
http://lambda-the-ultimate.org/node/497 and a whole bunch of other
such discussions on that site :)
> Le mardi 16 octobre 2012 22:44:59 UTC+2, Manfred Moser a écrit :
>> I am just an asciidoc user and I am looking with interest at this
>> discussion. As a java developer and maintainer of a few open source
>> projects my answer to you would be..
>> imho the best thing would be to help out and see if you can help with the
>> migration to python3. I am sure the work is non trivial and is probably on
>> the roadmap but there is just too much other things for one person to do.
>> So help out!
> To post to this group, send email to asciidoc@googlegroups.com.
> To unsubscribe from this group, send email to
> asciidoc+unsubscribe@googlegroups.com.
> For more options, visit this group at
> http://groups.google.com/group/asciidoc?hl=en.
Am Donnerstag, 1. November 2012 01:31:54 UTC+1 schrieb Lex Trotman:
> Mea culpa, I've had an asciidoc patch for Geany for a while that gives > the same functionality as rest. I've now made a pull request to add > it to Geany https://github.com/geany/geany/pull/78.
Thanks :)
> Many non-technical influences affect the popularity of languages and > that applies to markup languages too. See > http://lambda-the-ultimate.org/node/497 and a whole bunch of other > such discussions on that site :)
Yes. What is it that makes ReText so popular although AsciiDoc is much better?
In a way those ReText guys manage to respond better to the user's needs. What do they do differently? How do they create synergy?
> Yes. What is it that makes ReText so popular although AsciiDoc is
> much better?
Possibly as simple as it being chosen for Python documentation making it
somewhat widely used, and more docs are persuaded to use it "because Python
does", incumbency is a strong position.
> In a way those ReText guys manage to respond better to the user's needs.
Do they? So why was Sphinx created?
> What do they do differently? How do they create synergy?
> Or is it just a matter of resources?
Its quite possibly a combination of such things, and simply individual
decisions made by a developer to use a particular tool, maybe because it
was the only one they knew about, and after that changing is hard and more
are persuaded to use it "because xxx does" and so on.
> To post to this group, send email to asciidoc@googlegroups.com.
> To unsubscribe from this group, send email to
> asciidoc+unsubscribe@googlegroups.com.
> For more options, visit this group at
> http://groups.google.com/group/asciidoc?hl=en.
