Skip to content

Commit

Permalink
cleaned-up repo structure
Browse files Browse the repository at this point in the history
  • Loading branch information
superstes committed Sep 23, 2023
1 parent 61352f3 commit 7a635b5
Show file tree
Hide file tree
Showing 45 changed files with 99 additions and 0 deletions.
21 changes: 21 additions & 0 deletions docs/.readthedocs.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---

# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details

version: 2

build:
os: 'ubuntu-22.04'
tools:
python: "3.11"

sphinx:
configuration: 'docs/source/conf.py'

formats:
- 'pdf'
- 'epub'

python:
install:
- requirements: 'docs/requirements.txt'
2 changes: 2 additions & 0 deletions docs/requirements.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
sphinx
sphinx-rtd-theme
2 changes: 2 additions & 0 deletions docs/source/_inc/head.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
.. tip::
If you find some discrepancy or missing information - `open a GitHub issue <https://github.com/superstes/ShieldWall/issues/new>`_
2 changes: 2 additions & 0 deletions docs/source/_inc/in_progress.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
.. warning::
Writing of this documentation is still in progress! Read it with a grain of salt!
17 changes: 17 additions & 0 deletions docs/source/_static/css/main.css
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
.wiki-img {
width: 70%;
margin: 5px 0px;
border-radius: 5px;
border-style: solid;
border-color: #343a40;
border-width: 3px;
}

.wiki-img-sm {
width: 40%;
margin: 5px 0px;
border-radius: 5px;
border-style: solid;
border-color: #343a40;
border-width: 3px;
}
19 changes: 19 additions & 0 deletions docs/source/conf.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
from datetime import datetime

# pylint: disable=W0622

project = 'Calamary'
copyright = f'{datetime.now().year}, Superstes'
author = 'Superstes'
extensions = ['sphinx_rtd_theme']
templates_path = ['_templates']
exclude_patterns = []
html_theme = 'sphinx_rtd_theme'
html_theme_options = {}
html_static_path = ['_static']
html_css_files = ['css/main.css']
master_doc = 'index'
display_version = True
sticky_navigation = True
# html_logo = '_static/img/logo.svg'
# html_favicon = 'img/favicon.ico'
14 changes: 14 additions & 0 deletions docs/source/index.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
.. include:: _inc/head.rst

######################
Camalary Documentation
######################

.. toctree::
:glob:
:maxdepth: 1

info/*


.. include:: _inc/in_progress.rst
14 changes: 14 additions & 0 deletions docs/source/info/intro.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
.. include:: _inc/head.rst

#####
Intro
#####

.. toctree::
:glob:
:maxdepth: 1

info/*


.. include:: _inc/in_progress.rst
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.
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.
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.
File renamed without changes.
File renamed without changes.
File renamed without changes.
8 changes: 8 additions & 0 deletions scripts/build_docs.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
#!/bin/bash

cd "$(dirname "$0")/../docs"

rm -rf build
mkdir build

sphinx-build -b html source/ build/

0 comments on commit 7a635b5

Please sign in to comment.