PyPI, reStructuredText and readthedocs problems

Wolfgang Maier wolfgang.maier at biologie.uni-freiburg.de
Mon Mar 2 05:54:06 EST 2015


On 03/02/2015 11:33 AM, INADA Naoki wrote:
> PyPI parses your README strictly.
>
> $ rst2html.py --strict README.rst
> README.rst:700: (INFO/1) Duplicate implicit target name: "fingerprint".
> Exiting due to level-1 (INFO) system message.
>
> But I don't know how to avoid this error when converting from markdown.
>

The other occurence of a title Fingerprint is at line 436. I guess you 
will have to change one of the two titles (maybe Fingerprints ?) to make 
things work.

> On Mon, Mar 2, 2015 at 6:35 PM Leonardo Giordani
> <giordani.leonardo at gmail.com <mailto:giordani.leonardo at gmail.com>> wrote:
>
>     Hi all,
>
>     Some time ago I open sourced a package named postage
>     (https://pypi.python.org/pypi/postage/).
>
>     I am experiencing issues with documentation. The project is hosted
>     on GitHub (https://github.com/lgiordani/postage), where the
>     README.md is perfectly rendered. My issues are:
>
>     1. I use pandoc to convert README.md to README.rst. This latter is
>     rendered by GitHUb as well, but when I upload the package to PyPI I
>     get a messy result (look at the package page).
>
>     2. When I import the project into readthedocs.org
>     <http://readthedocs.org> the build fails with no output. This is the
>     only information I get
>
>     ----------------------------- 8< -----------------------------
>
>     Build for postage
>
>     Built: Feb. 27, 2015. 10:41 a.m.
>
>     State: Finished
>
>     Outcome: Failed (Status Code: 0)
>
>     Version: latest
>
>     Type: html
>
>     Build Standard Output
>
>     ----------------------------- 8< -----------------------------
>
>     May someone help me figuring out what's wrong in my code?
>     Thanks!
>
>     Leo





More information about the Python-list mailing list