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