Show More
@@ -139,21 +139,21 b' Building and uploading' | |||
|
139 | 139 | The built docs are stored in a separate repository. Through some github magic, |
|
140 | 140 | they're automatically exposed as a website. It works like this: |
|
141 | 141 | |
|
142 |
|
|
|
142 | * You will need to have sphinx and latex installed. In Ubuntu, install | |
|
143 | 143 | ``texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended``. |
|
144 | 144 | Install the latest version of sphinx from PyPI (``pip install sphinx``). |
|
145 |
|
|
|
145 | * Ensure that the development version of IPython is the first in your system | |
|
146 | 146 | path. You can either use a virtualenv, or modify your PYTHONPATH. |
|
147 |
|
|
|
147 | * Switch into the docs directory, and run ``make gh-pages``. This will build | |
|
148 | 148 | your updated docs as html and pdf, then automatically check out the latest |
|
149 | 149 | version of the docs repository, copy the built docs into it, and commit your |
|
150 | 150 | changes. |
|
151 |
|
|
|
152 |
|
|
|
151 | * Open the built docs in a web browser, and check that they're as expected. | |
|
152 | * (If rebuilding the docs for the development version, it may have duplicated | |
|
153 | 153 | the link to the development version in the homepage. Remove this from |
|
154 | 154 | index.rst, then run ``python build_index.py`` to update index.html. Commit the |
|
155 | 155 | change.) |
|
156 |
|
|
|
156 | * Upload the docs with ``git push``. This only works if you have write access to | |
|
157 | 157 | the docs repository. |
|
158 | 158 | |
|
159 | 159 | .. [reStructuredText] reStructuredText. http://docutils.sourceforge.net/rst.html |
General Comments 0
You need to be logged in to leave comments.
Login now