Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > comp.lang.python > #44233 > unrolled thread

Re: using pandoc instead of rst to document python

Back to article view | Back to comp.lang.python

This discussion starts older than the indexed window; earlier articles aren't shown. The article labeled Started by below is the oldest one visible, not the original post.

Contents

  Re: using pandoc instead of rst to document python Peng Yu <pengyu.ut@gmail.com> - 2013-04-23 18:14 -0500

#44233 — Re: using pandoc instead of rst to document python

On Tue, Apr 23, 2013 at 5:40 PM, R. Michael Weylandt
<michael.weylandt@gmail.com> wrote:
> On Tue, Apr 23, 2013 at 6:36 PM, Peng Yu <pengyu.ut@gmail.com> wrote:
>> Hi,
>>
>> I'm wondering if it possible to use pandoc instead of rst to document
>> python. Is there a documentation system support this format of python
>> document?

Sorry for the confusion. When I said pandoc, I meant pandoc's markdown.

http://johnmacfarlane.net/pandoc/README.html#pandocs-markdown

> Pandoc is a converter while rst is a format so they're not directly
> comparable; pandoc can convert _to_ and _from_ rst to a wide variety
> of other formats, but you still have to write documentation in one
> format or another. If you want to use an rst-centric documentation
> tool, you can write in, e.g., Markdown, convert to rst and then run
> your other tool on it.

I currently use sphinx to generate the doc (in rst). How to figure it
to support pandoc's markdown?

-- 
Regards,
Peng

[toc] | [standalone]

Back to top | Article view | comp.lang.python

csiph-web