Skip to content

Commit

Permalink
Add read the docs documentation first attempt
Browse files Browse the repository at this point in the history
Signed-off-by: jparisu <[email protected]>
  • Loading branch information
jparisu committed Oct 18, 2023
1 parent 57479aa commit 0a0be9f
Show file tree
Hide file tree
Showing 7 changed files with 97 additions and 0 deletions.
5 changes: 5 additions & 0 deletions docs/conf.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
project = 'IArena'
author = 'jparisu'

extensions = ['sphinx.ext.autodoc']
html_theme = 'sphinx_rtd_theme'
23 changes: 23 additions & 0 deletions docs/index.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@

.. toctree::
:caption: Introduction
:maxdepth: 2
:hidden:

/src/titlepage


.. toctree::
:caption: Project
:maxdepth: 2
:hidden:

/src/project


.. toctree::
:caption: Games
:maxdepth: 2
:hidden:

/src/games
9 changes: 9 additions & 0 deletions docs/requirements.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
doc8==0.10.1
docutils==0.16.0
GitPython==3.1.32
setuptools==65.5.1
sphinx_rtd_theme==0.5.2
sphinx-tabs==3.2.0
sphinx==4.3.1
sphinxcontrib-imagehelper==1.1.1
sphinxcontrib.spelling==7.2.1
7 changes: 7 additions & 0 deletions docs/src/games.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
.. _games:

#####
Games
#####

In this page will be displayed the different games available in the platform along with their description, characteristics and tutorials.
7 changes: 7 additions & 0 deletions docs/src/project.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
.. _project_overview:

################
Project Overview
################

Detailed information about the project.
15 changes: 15 additions & 0 deletions docs/src/titlepage.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
.. _title:

.. raw:: html

<h1>
IArena Documentation
</h1>

*IArena* first documentation release.

########
Overview
########

Some text.
31 changes: 31 additions & 0 deletions readthedocs.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# .readthedocs.yaml
# Read the Docs configuration file
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details

# Required
version: 2

# Set the OS, Python version and other tools you might need
build:
os: ubuntu-22.04
tools:
python: "3.12"
# You can also specify other tool versions:
# nodejs: "19"
# rust: "1.64"
# golang: "1.19"

# Build documentation in the "docs/" directory with Sphinx
sphinx:
configuration: docs/conf.py

# Optionally build your docs in additional formats such as PDF and ePub
formats:
- pdf

# Optional but recommended, declare the Python requirements required
# to build your documentation
# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
python:
install:
- requirements: docs/requirements.txt

0 comments on commit 0a0be9f

Please sign in to comment.