[Distutils] PyPI and Uploading Documentation
wes.turner at gmail.com
Sat May 16 12:33:18 CEST 2015
On May 16, 2015 4:55 AM, "Nick Coghlan" <ncoghlan at gmail.com> wrote:
> On 16 May 2015 at 04:34, Donald Stufft <donald at stufft.io> wrote:
> > So I can’t speak for ReadTheDocs, but I believe that they are
> > and/or are planning on offering arbitrary HTML uploads similarly to how
> > you can upload documentation to PyPI. I don’t know if this will actually
> > happen and what it would look like but I know they are thinking about
> I've never tried it with ReadTheDocs, but in theory the ".. raw::
> html" docutils directive allows arbitrary HTML content to be embedded
> in a reStructuredText page.
> Regardless, "Can ReadTheDocs do X?" questions are better asked on
ReadTheDocs is hiring!
> while both
> GitHub and Atlassian (via BitBucket) offer free static HTML hosting.
I just wrote a tool (pypi:pgs) for serving files over HTTP directly from
gh-pages branches that works in conjunction with pypi:ghp-import (>
gh-pages; touch .nojekyll).
CloudFront DNS can sort of be used to add TLS/SSL to custom domains with
GitHub Pages (and probably BitBucket)
> In relation to the original question, +1 for attempting to phase out
> PyPI's documentation hosting capability in favour of delegating to
> RTFD or third party static HTML hosting. One possible option to
> explore that minimises disruption for existing users might be to stop
> offering it to *new* projects, while allowing existing projects to
> continue uploading new versions of their documentation.
- [ ] DOC: migration / alternatives guide
> Nick Coghlan | ncoghlan at gmail.com | Brisbane, Australia
> Distutils-SIG maillist - Distutils-SIG at python.org
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the Distutils-SIG