Re: using pandoc instead of rst to document python

Path	csiph.com!v102.xanadu-bbs.net!xanadu-bbs.net!feeder.erje.net!eu.feeder.erje.net!newsfeed.xs4all.nl!newsfeed4.news.xs4all.nl!xs4all!post.news.xs4all.nl!not-for-mail
Return-Path	<michael.weylandt@gmail.com>
X-Original-To	python-list@python.org
Delivered-To	python-list@mail.python.org
X-Spam-Status	OK 0.005
X-Spam-Evidence	'H': 0.99; 'S': 0.00; 'python.': 0.02; 'tool,': 0.07; 'e.g.,': 0.09; 'subject:using': 0.09; 'cc:addr:python-list': 0.11; 'python': 0.11; '23,': 0.16; 'subject:python': 0.16; 'wrote:': 0.18; 'pfxlen:0': 0.19; 'cc:addr:python.org': 0.22; 'cc:2**0': 0.24; 'header:In-Reply-To:1': 0.27; 'michael': 0.29; 'wondering': 0.29; 'message-id:@mail.gmail.com': 0.30; "i'm": 0.30; 'another.': 0.31; 'run': 0.32; 'tool': 0.35; 'convert': 0.35; 'but': 0.35; 'received:google.com': 0.35; 'there': 0.35; 'possible': 0.36; 'hi,': 0.36; 'pm,': 0.38; 'to:addr:gmail.com': 0.65; '2013': 0.98
DKIM-Signature	v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:mime-version:in-reply-to:references:from:date:message-id :subject:to:cc:content-type; bh=ugb8+mpoTCxaN+r7yOLhkt0Czp4WC+HoeCGCTqUSM7g=; b=sGfU45gQgW9/j+dnxbLNy4I1NE2K7QXXj4ExblP7wq+9zmUBKPYlXeQGJUcQWMeUKD edStgyLDcEce3LNtOKRpHwgiJs2BSlvyAWvxi+GpgE954OfRjo5nEAOSfxvMUYi/cpW8 z2r9/fcivH8rTjAAvAnIeO2GYjBu4efjkP5yW4uuMUCPmBa9eLTN8y4WMD99ESDe+Rnn 1vj4GTVSYi8Vd7rEvu00WsDiG6wAl1s0BV8tE2yktLWljIKMoP5pLt1gMazxHUcE1I6B HdOrS8QwaqLONgc6TCWhQ0eC86jn5kuVBFKpEyDqYnY7apYcI0v9ghxQdjezP4NvP7Rc 5R8A==
X-Received	by 10.112.158.38 with SMTP id wr6mr16197621lbb.36.1366756851614; Tue, 23 Apr 2013 15:40:51 -0700 (PDT)
MIME-Version	1.0
In-Reply-To	<CABrM6w=dSJRQ=FtTEHwUfXYfTWwLDiPiJdr7sKoVk4a3McfsSg@mail.gmail.com>
References	<CABrM6w=dSJRQ=FtTEHwUfXYfTWwLDiPiJdr7sKoVk4a3McfsSg@mail.gmail.com>
From	"R. Michael Weylandt" <michael.weylandt@gmail.com>
Date	Tue, 23 Apr 2013 18:40:31 -0400
Subject	Re: using pandoc instead of rst to document python
To	Peng Yu <pengyu.ut@gmail.com>
Content-Type	text/plain; charset=ISO-8859-1
Cc	python-list <python-list@python.org>
X-BeenThere	python-list@python.org
X-Mailman-Version	2.1.15
Precedence	list
List-Id	General discussion list for the Python programming language <python-list.python.org>
List-Unsubscribe	<http://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive	<http://mail.python.org/pipermail/python-list/>
List-Post	<mailto:python-list@python.org>
List-Help	<mailto:python-list-request@python.org?subject=help>
List-Subscribe	<http://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Newsgroups	comp.lang.python
Message-ID	<mailman.1003.1366756858.3114.python-list@python.org> (permalink)
Lines	15
NNTP-Posting-Host	2001:888:2000:d::a6
X-Trace	1366756858 news.xs4all.nl 2175 [2001:888:2000:d::a6]:40087
X-Complaints-To	abuse@xs4all.nl
Xref	csiph.com comp.lang.python:44229

Show key headers only | View raw

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?

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.

Michael

Back to comp.lang.python | Previous | Next | Find similar | Unroll thread

Thread

Re: using pandoc instead of rst to document python "R. Michael Weylandt" <michael.weylandt@gmail.com> - 2013-04-23 18:40 -0400

csiph-web