Skip to content

Commit

Permalink
DOC: rename doc/ to docs/ (#24)
Browse files Browse the repository at this point in the history
  • Loading branch information
hagenw authored Aug 9, 2019
1 parent bfd1a94 commit c9a6db7
Show file tree
Hide file tree
Showing 13 changed files with 10 additions and 10 deletions.
8 changes: 4 additions & 4 deletions .travis.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ matrix:
include:

# Default Python + latest Sphinx + check for broken links
- env: ADDITIONAL_COMMAND="python -m sphinx doc/ doc/_build/ -b linkcheck -W"
- env: ADDITIONAL_COMMAND="python -m sphinx docs/ docs/_build/ -b linkcheck -W"

# A few older Sphinx releases using default Python version and stripped down
# example from tests/
Expand All @@ -32,9 +32,9 @@ install:
- pip install sphinx$SPHINX
- python setup.py install
script:
- python -m sphinx ${FOLDER:-doc} ${FOLDER:-doc}/_build/ -c doc/ -b html -W
- python -m sphinx ${FOLDER:-doc} ${FOLDER:-doc}/_build/ -c doc/ -b latex -W
- python -m sphinx ${FOLDER:-docs} ${FOLDER:-docs}/_build/ -c docs/ -b html -W
- python -m sphinx ${FOLDER:-docs} ${FOLDER:-docs}/_build/ -c docs/ -b latex -W
# Test server side prerendering
- katex -V
- python -m sphinx ${FOLDER:-doc} ${FOLDER:-doc}/_build/ -c doc/ -b html -D katex_prerender=1 -W
- python -m sphinx ${FOLDER:-docs} ${FOLDER:-docs}/_build/ -c docs/ -b html -D katex_prerender=1 -W
- $ADDITIONAL_COMMAND
12 changes: 6 additions & 6 deletions CONTRIBUTING.rst
Original file line number Diff line number Diff line change
Expand Up @@ -37,17 +37,17 @@ If you make changes to the documentation, you can re-create the HTML pages
using Sphinx_.
You can install it and a few other necessary packages with::

pip install -r doc/requirements.txt
pip install -r docs/requirements.txt

To create the HTML pages, use::

python -m sphinx doc/ build/sphinx/ -b html
python -m sphinx docs/ build/sphinx/ -b html

The generated files will be available in the directory ``build/sphinx/``.

It is also possible to automatically check if all links are still valid::

python -m sphinx doc/ build/sphinx/ -b linkcheck
python -m sphinx docs/ build/sphinx/ -b linkcheck

.. _Sphinx: http://sphinx-doc.org/

Expand All @@ -57,15 +57,15 @@ Running Tests

``sphinxcontrib.katex`` is supposed to work for all versions ``sphinx>=1.6``.
To test that you have to use a stripped down version of the documentation that
is provided in the ``tests/`` folder, as the documentation under ``doc/`` uses
is provided in the ``tests/`` folder, as the documentation under ``docs/`` uses
features that are only supported by ``sphinx>=1.8``.

To test that everything works as expected, please execute:

.. code-block:: bash
python -m sphinx tests/ tests/_build/ -c doc/ -b html -W
python -m sphinx tests/ tests/_build/ -c doc/ -b latex -W
python -m sphinx tests/ tests/_build/ -c docs/ -b html -W
python -m sphinx tests/ tests/_build/ -c docs/ -b latex -W
The same tests are automatically performed by Travis_ once you create a pull
request on Github_.
Expand Down
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

0 comments on commit c9a6db7

Please sign in to comment.