Path: csiph.com!usenet.pasdenom.info!news.albasani.net!newsfeed.freenet.ag!news2.euro.net!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail
Return-Path: <pengyu.ut@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; 'sphinx': 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; 'meant': 0.20; '(in': 0.22; '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; 'doc': 0.31; 'figure': 0.32; 'run': 0.32; 'received:209.85': 0.35; 'tool': 0.35; 'convert': 0.35; 'but': 0.35; 'received:google.com': 0.35; 'there': 0.35; 'possible': 0.36; 'hi,': 0.36; 'received:209': 0.37; 'pm,': 0.38; 'how': 0.40; 'to:addr:gmail.com': 0.65; 'confusion.': 0.84; '2013': 0.98
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:x-received:in-reply-to:references:date:message-id :subject:from:to:cc:content-type; bh=BBrXW1BShNdzlVfbLqQB4d6QZC4V3ugTmydL7XHv3Kk=; b=jF+8BIEyjKUd3yepw2nqETQhYWN9oSYDFFodg7dM6f+sttiJyikktEjJG8Jr9z5HJf d8qOSRaXWlkiMWLbJAEA9rJI/WspW5iBy5rqq59Jry7LtCNVaVgxak802r8hcyHFfW05 UTfDR39QuHLp9LSf4FcVU/r8GlzD71WsR+98qbh37NQUwQNlPTyN6f3A9R0oYzdSTlNc NH0+7ID3ps0IU1NaASTxQ3l+YHlnorr1JICeJngzQYL7K6/TBhg0UZWulxz6oIyeLmvO b1l3XaPGMyVV6wbLtkmzNll+Dk/k5016YG3baJktl6pr899fEPHVT+9kP/ak6OAxWYNH O59A==
MIME-Version: 1.0
X-Received: by 10.229.10.103 with SMTP id o39mr8401605qco.88.1366758848805; Tue, 23 Apr 2013 16:14:08 -0700 (PDT)
In-Reply-To: <CAAmySGPYcAWYJu=MqNxHUaDG7i_vEzydB-99n+AYWiiRnR+5eA@mail.gmail.com>
References: <CABrM6w=dSJRQ=FtTEHwUfXYfTWwLDiPiJdr7sKoVk4a3McfsSg@mail.gmail.com> <CAAmySGPYcAWYJu=MqNxHUaDG7i_vEzydB-99n+AYWiiRnR+5eA@mail.gmail.com>
Date: Tue, 23 Apr 2013 18:14:08 -0500
Subject: Re: using pandoc instead of rst to document python
From: Peng Yu <pengyu.ut@gmail.com>
To: "R. Michael Weylandt" <michael.weylandt@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.1006.1366758851.3114.python-list@python.org>
Lines: 26
NNTP-Posting-Host: 2001:888:2000:d::a6
X-Trace: 1366758851 news.xs4all.nl 2308 [2001:888:2000:d::a6]:54369
X-Complaints-To: abuse@xs4all.nl
Xref: csiph.com comp.lang.python:44233

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