From 043b5e925357d6eb6e5aa3a7cbfccc0f5be0743c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Juan=20Luis=20Cano=20Rodr=C3=ADguez?= Date: Thu, 18 Nov 2021 18:47:39 +0100 Subject: Add missing content on dependencies --- doc/tutorial/deploying.rst | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) (limited to 'doc/tutorial') 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. -- cgit v1.2.1