From 0efa4456051e97040c750d5927304ad4db49bf24 Mon Sep 17 00:00:00 2001 From: TAKAHASHI Shuuji Date: Mon, 5 Dec 2022 01:31:44 +0900 Subject: Added "Building Documentation" section (#101) --- docs/contributing.rst | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) (limited to 'docs') diff --git a/docs/contributing.rst b/docs/contributing.rst index a2e4251..49e53ed 100644 --- a/docs/contributing.rst +++ b/docs/contributing.rst @@ -121,6 +121,26 @@ And you can run the tests with pytest:: If you want to edit settings, you can edit the ``.env`` file. +Building Documentation +---------------------- + +We are using `Sphinx `_ and `reStructuredText markup language `_ to write documentation. + +To build documentation, we need to install additional libraries:: + + pip install -r docs/requirements.txt + +After editing documentation, you can build documentation with the following command:: + + make docs + +This outputs HTML files under the ``docs/_build/html/`` directory. Let's launch a development server to serve HTML files:: + + python -m http.server 8000 --directory docs/_build/html/ + +Now, you can view the documentation on your browser at http://localhost:8000/. + + Coding Guidelines ----------------- -- cgit v1.2.3