Discussion:
[ceylon-dev] Ceylon pandoc converter for documentation
formalizator
2016-03-31 16:59:32 UTC
Permalink
Hi!

There is an idea to use pandoc for ceylondoc compilation. This tool allows
to use markdown as it is and also allow user to use variety of standards
for documentation.
In case of pandoc user is able to document some formulas like this:
<Loading Image...>




This converter can also provide html pages for herd module and make cross
links.
All the features we have now with markdown will stay the same. Pandoc is
fully copatitable with md.

Another good feature will be custom modules for documentation.

To support this feature we should change compiler and IDE plugin.
--
You received this message because you are subscribed to the Google Groups "ceylon-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ceylon-dev+***@googlegroups.com.
To post to this group, send email to ceylon-***@googlegroups.com.
Visit this group at https://groups.google.com/group/ceylon-dev.
To view this discussion on the web visit https://groups.google.com/d/msgid/ceylon-dev/fe13b264-f67c-42c3-83e9-931303ce1eec%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
Tom Bentley
2016-04-04 08:57:59 UTC
Permalink
To me this seems like quite a lot of work for relatively little benefit.
Personally, I wouldn't want Ceylon to support a variety of standards for
documentation (I assume that means a variety of syntaxes), because that
would make the doc annotations harder to read than just supporting a single
syntax.
Post by formalizator
Hi!
There is an idea to use pandoc for ceylondoc compilation. This tool allows
to use markdown as it is and also allow user to use variety of standards
for documentation.
<https://lh3.googleusercontent.com/-dTfuw8eHNnk/Vv1WVE08rQI/AAAAAAAAC3I/awaGFsSXy8oEkYYlK-M3mWeLc73hu8Kow/s1600/formulaaaa.png>
This converter can also provide html pages for herd module and make cross
links.
All the features we have now with markdown will stay the same. Pandoc is
fully copatitable with md.
Another good feature will be custom modules for documentation.
To support this feature we should change compiler and IDE plugin.
--
You received this message because you are subscribed to the Google Groups
"ceylon-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an
Visit this group at https://groups.google.com/group/ceylon-dev.
To view this discussion on the web visit
https://groups.google.com/d/msgid/ceylon-dev/fe13b264-f67c-42c3-83e9-931303ce1eec%40googlegroups.com
<https://groups.google.com/d/msgid/ceylon-dev/fe13b264-f67c-42c3-83e9-931303ce1eec%40googlegroups.com?utm_medium=email&utm_source=footer>
.
For more options, visit https://groups.google.com/d/optout.
--
You received this message because you are subscribed to the Google Groups "ceylon-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ceylon-dev+***@googlegroups.com.
To post to this group, send email to ceylon-***@googlegroups.com.
Visit this group at https://groups.google.com/group/ceylon-dev.
To view this discussion on the web visit https://groups.google.com/d/msgid/ceylon-dev/CAMd5Ysx6UDH1QCkfD5znqXNKnh-W5%3DgjDA5oqUu2%3Dv4V7sGKfQ%40mail.gmail.com.
For more options, visit https://groups.google.com/d/optout.
Loading...