diff options
author | Juan Luis Cano RodrÃguez <hello@juanlu.space> | 2021-11-18 20:47:39 +0300 |
---|---|---|
committer | Juan Luis Cano RodrÃguez <hello@juanlu.space> | 2021-11-18 20:47:39 +0300 |
commit | 043b5e925357d6eb6e5aa3a7cbfccc0f5be0743c (patch) | |
tree | 18f4c9ca0608ab6db2c220999bd15544319c1361 /doc | |
parent | 1d1b2296c5bd2faae9d291d838cbde38f8517148 (diff) |
Add missing content on dependencies
Diffstat (limited to 'doc')
-rw-r--r-- | doc/tutorial/deploying.rst | 19 |
1 files changed, 12 insertions, 7 deletions
diff --git a/doc/tutorial/deploying.rst b/doc/tutorial/deploying.rst index f4991379f..08fa57ebc 100644 --- a/doc/tutorial/deploying.rst +++ b/doc/tutorial/deploying.rst @@ -205,10 +205,6 @@ contents: github_token: ${{ secrets.GITHUB_TOKEN }} publish_dir: docs/build/html -.. todo:: - Some more changes are needed to tell the Sphinx action to install the - dependencies. - This contains a GitHub Actions workflow with a single job of four steps: 1. Checkout the code. @@ -218,9 +214,18 @@ This contains a GitHub Actions workflow with a single job of four steps: 4. If the change happens on the default branch, take the contents of ``docs/build/html`` and push it to the ``gh-pages`` branch. -After that, you are ready to `enable GitHub Pages on your repository`_. For that, -go to :guilabel:`Settings`, then :guilabel:`Pages` on the left sidebar, select -the ``gh-pages`` branch in the "Source" dropdown menu, and click +Next, you need to specify the dependencies for the ``make html`` step to be +successful. For that, create a file ``docs/requirements.txt`` and add the +following contents: + +.. code-block:: + :caption: docs/requirements.txt + + furo==2021.11.16 + +And finally, you are ready to `enable GitHub Pages on your repository`_. For +that, go to :guilabel:`Settings`, then :guilabel:`Pages` on the left sidebar, +select the ``gh-pages`` branch in the "Source" dropdown menu, and click :guilabel:`Save`. After a few minutes, you should be able to see your HTML at the designated URL. |