From 1298ec1257c0ae44d63422948bf807a8812c193e Mon Sep 17 00:00:00 2001 From: Brendan <2bndy5@gmail.com> Date: Tue, 24 Sep 2024 06:06:35 -0700 Subject: [PATCH] remove sphinx and update RTD config --- .github/doxygen.py | 25 +++ .readthedocs.yaml | 38 ++-- docs/Doxyfile | 21 +- .../{sphinx/_static => images}/Logo large.png | Bin .../new_favicon.ico => images/favicon.ico} | Bin docs/sphinx/Makefile | 20 -- docs/sphinx/README.md | 3 - docs/sphinx/RF24Mesh_8h.rst | 5 - docs/sphinx/RF24Mesh__config_8h.rst | 4 - docs/sphinx/_static/custom_material.css | 20 -- docs/sphinx/classRF24Mesh.rst | 73 ------- docs/sphinx/conf.py | 186 ------------------ docs/sphinx/deprecated.rst | 5 - docs/sphinx/examples.rst | 44 ----- .../examples/Arduino/RF24Mesh_Example.rst | 5 - .../Arduino/RF24Mesh_Example_Master.rst | 5 - .../Arduino/RF24Mesh_Example_Node2Node.rst | 5 - .../RF24Mesh_Example_Node2NodeExtra.rst | 5 - .../Arduino/RF24Mesh_SerialConfig.rst | 5 - .../examples/Linux/RF24Mesh_Example.rst | 6 - .../Linux/RF24Mesh_Example_Master.rst | 6 - .../Linux/RF24Mesh_Ncurses_Master.rst | 10 - .../examples/PicoSDK/RF24Mesh_Example.rst | 8 - .../PicoSDK/RF24Mesh_Example_Master.rst | 8 - docs/sphinx/examples/PicoSDK/default_pins.rst | 5 - .../examples/Python/RF24Mesh_Example.rst | 7 - .../Python/RF24Mesh_Example_Master.rst | 7 - docs/sphinx/index.rst | 37 ---- docs/sphinx/make.bat | 35 ---- docs/sphinx/md_contributing.rst | 5 - docs/sphinx/md_docs_general_usage.rst | 5 - docs/sphinx/md_docs_setup_config.rst | 5 - docs/sphinx/pages.rst | 9 - docs/sphinx/requirements.txt | 2 - 34 files changed, 49 insertions(+), 575 deletions(-) create mode 100644 .github/doxygen.py rename docs/{sphinx/_static => images}/Logo large.png (100%) rename docs/{sphinx/_static/new_favicon.ico => images/favicon.ico} (100%) delete mode 100644 docs/sphinx/Makefile delete mode 100644 docs/sphinx/README.md delete mode 100644 docs/sphinx/RF24Mesh_8h.rst delete mode 100644 docs/sphinx/RF24Mesh__config_8h.rst delete mode 100644 docs/sphinx/_static/custom_material.css delete mode 100644 docs/sphinx/classRF24Mesh.rst delete mode 100644 docs/sphinx/conf.py delete mode 100644 docs/sphinx/deprecated.rst delete mode 100644 docs/sphinx/examples.rst delete mode 100644 docs/sphinx/examples/Arduino/RF24Mesh_Example.rst delete mode 100644 docs/sphinx/examples/Arduino/RF24Mesh_Example_Master.rst delete mode 100644 docs/sphinx/examples/Arduino/RF24Mesh_Example_Node2Node.rst delete mode 100644 docs/sphinx/examples/Arduino/RF24Mesh_Example_Node2NodeExtra.rst delete mode 100644 docs/sphinx/examples/Arduino/RF24Mesh_SerialConfig.rst delete mode 100644 docs/sphinx/examples/Linux/RF24Mesh_Example.rst delete mode 100644 docs/sphinx/examples/Linux/RF24Mesh_Example_Master.rst delete mode 100644 docs/sphinx/examples/Linux/RF24Mesh_Ncurses_Master.rst delete mode 100644 docs/sphinx/examples/PicoSDK/RF24Mesh_Example.rst delete mode 100644 docs/sphinx/examples/PicoSDK/RF24Mesh_Example_Master.rst delete mode 100644 docs/sphinx/examples/PicoSDK/default_pins.rst delete mode 100644 docs/sphinx/examples/Python/RF24Mesh_Example.rst delete mode 100644 docs/sphinx/examples/Python/RF24Mesh_Example_Master.rst delete mode 100644 docs/sphinx/index.rst delete mode 100644 docs/sphinx/make.bat delete mode 100644 docs/sphinx/md_contributing.rst delete mode 100644 docs/sphinx/md_docs_general_usage.rst delete mode 100644 docs/sphinx/md_docs_setup_config.rst delete mode 100644 docs/sphinx/pages.rst delete mode 100644 docs/sphinx/requirements.txt diff --git a/.github/doxygen.py b/.github/doxygen.py new file mode 100644 index 00000000..7cdf569f --- /dev/null +++ b/.github/doxygen.py @@ -0,0 +1,25 @@ +"""WARNING -- FOR CI ONLY + +This script is meant to be execute in CI only. +Running this locally will alter the Doxyfile. +Such changes SHOULD NOT be pushed to the remote. +""" +from pathlib import Path +import json + +DOCS_DIR = Path(__file__).parent.parent / "docs" +PROPERTIES = DOCS_DIR.parent / "library.json" +CONFIG = DOCS_DIR / "Doxyfile" +TMP = DOCS_DIR / "doxygenAction" + + +def overwrite_doxygen_value(): + properties = json.loads(PROPERTIES.read_text(encoding="utf-8")) + assert "version" in properties + config = CONFIG.read_text(encoding="utf-8") + TMP.write_text("PROJECT_NUMBER = {}\n".format(properties["version"]), encoding="utf-8") + config += f"\n@INCLUDE = {str(TMP)}\n" + CONFIG.write_text(config, encoding="utf-8") + +if __name__ == "__main__": + overwrite_doxygen_value() diff --git a/.readthedocs.yaml b/.readthedocs.yaml index 78539418..e6f4edc3 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -6,20 +6,28 @@ version: 2 build: - os: "ubuntu-20.04" + os: "ubuntu-22.04" + apt_packages: + - libclang1-12 + - libclang-cpp12 tools: python: "3" - -# Build documentation in the docs/ directory with Sphinx -sphinx: - configuration: docs/sphinx/conf.py - -# Optionally build your docs in additional formats such as PDF -#formats: -# - pdf -# latex builds break for sphinx-immaterial theme - -# install Python requirements required to build docs -python: - install: - - requirements: docs/sphinx/requirements.txt + commands: + # Install doxygen from source distributions (conda forge does not keep up-to-date doxygen releases) + - > + DOXYGEN_VERSION="1.12.0" && + mkdir .doxygen && cd .doxygen && + echo $(pwd) && + echo "https://sourceforge.net/projects/doxygen/files/rel-$DOXYGEN_VERSION/doxygen-$DOXYGEN_VERSION.linux.bin.tar.gz" && + curl -L https://sourceforge.net/projects/doxygen/files/rel-$DOXYGEN_VERSION/doxygen-$DOXYGEN_VERSION.linux.bin.tar.gz > doxygen.tar.gz && + gunzip doxygen.tar.gz && + tar xf doxygen.tar && + mv doxygen-$DOXYGEN_VERSION/bin/doxygen ./ + # get lib version & overwrite Doxyfile values + - python3 .github/doxygen.py + # run doxygen + - cd docs && ../.doxygen/doxygen + # copy output to RTD output path for HTML files + - ls -R docs/html/ + - mkdir -p ${READTHEDOCS_OUTPUT} + - mv docs/html/ "${READTHEDOCS_OUTPUT}" diff --git a/docs/Doxyfile b/docs/Doxyfile index aa032223..852035ff 100644 --- a/docs/Doxyfile +++ b/docs/Doxyfile @@ -17,7 +17,7 @@ # Project related configuration options #--------------------------------------------------------------------------- -PROJECT_ICON = sphinx/_static/new_favicon.ico +PROJECT_ICON = images/favicon.ico # The PROJECT_NAME tag is a single word (or a sequence of words surrounded by # double-quotes, unless you are using Doxywizard) that should identify the @@ -383,25 +383,6 @@ HTML_DYNAMIC_SECTIONS = YES GENERATE_LATEX = NO -#--------------------------------------------------------------------------- -# Configuration options related to the XML output -#--------------------------------------------------------------------------- - -# If the GENERATE_XML tag is set to YES, doxygen will generate an XML file that -# captures the structure of the code including all documentation. -# The default value is: NO. - -GENERATE_XML = YES - -# The XML_OUTPUT tag is used to specify where the XML pages will be put. If a -# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of -# it. -# The default directory is: xml. -# This tag requires that the tag GENERATE_XML is set to YES. - -XML_OUTPUT = sphinx/xml - - #--------------------------------------------------------------------------- # Configuration options related to the preprocessor #--------------------------------------------------------------------------- diff --git a/docs/sphinx/_static/Logo large.png b/docs/images/Logo large.png similarity index 100% rename from docs/sphinx/_static/Logo large.png rename to docs/images/Logo large.png diff --git a/docs/sphinx/_static/new_favicon.ico b/docs/images/favicon.ico similarity index 100% rename from docs/sphinx/_static/new_favicon.ico rename to docs/images/favicon.ico diff --git a/docs/sphinx/Makefile b/docs/sphinx/Makefile deleted file mode 100644 index bbe765a0..00000000 --- a/docs/sphinx/Makefile +++ /dev/null @@ -1,20 +0,0 @@ -# Minimal makefile for Sphinx documentation -# - -# You can set these variables from the command line, and also -# from the environment for the first two. -SPHINXOPTS ?= -SPHINXBUILD ?= sphinx-build -SOURCEDIR = ../sphinx -BUILDDIR = ../_build - -# Put it first so that "make" without argument is like "make help". -help: - @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) - -.PHONY: help Makefile - -# Catch-all target: route all unknown targets to Sphinx using the new -# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). -%: Makefile - @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) diff --git a/docs/sphinx/README.md b/docs/sphinx/README.md deleted file mode 100644 index 5ca5047f..00000000 --- a/docs/sphinx/README.md +++ /dev/null @@ -1,3 +0,0 @@ -# Intended for Sphinx only - -The files in this folder are only used to generate documentation using Sphinx (from Doxygen's XML output). diff --git a/docs/sphinx/RF24Mesh_8h.rst b/docs/sphinx/RF24Mesh_8h.rst deleted file mode 100644 index aa584d34..00000000 --- a/docs/sphinx/RF24Mesh_8h.rst +++ /dev/null @@ -1,5 +0,0 @@ -RF24Mesh.h -============ - -.. doxygenfile:: RF24Mesh.h - :sections: define diff --git a/docs/sphinx/RF24Mesh__config_8h.rst b/docs/sphinx/RF24Mesh__config_8h.rst deleted file mode 100644 index 689495a4..00000000 --- a/docs/sphinx/RF24Mesh__config_8h.rst +++ /dev/null @@ -1,4 +0,0 @@ -RF24Mesh_config.h -================= - -.. doxygenfile:: RF24Mesh_config.h diff --git a/docs/sphinx/_static/custom_material.css b/docs/sphinx/_static/custom_material.css deleted file mode 100644 index dd7e9fe2..00000000 --- a/docs/sphinx/_static/custom_material.css +++ /dev/null @@ -1,20 +0,0 @@ -html .md-nav--primary .md-nav__title--site .md-nav__button { - top: 0; - left: 0; - width: inherit; - height: auto; -} - -thead { - background-color: var(--md-default-fg-color--light); - color: var(--md-primary-bg-color); -} - -.md-nav__title .md-nav__button.md-logo img, .md-nav__title .md-nav__button.md-logo svg { - height: 3rem; - width: auto; -} - -.md-header__button.md-logo img, .md-header__button.md-logo svg { - width: auto; -} diff --git a/docs/sphinx/classRF24Mesh.rst b/docs/sphinx/classRF24Mesh.rst deleted file mode 100644 index 3ab81039..00000000 --- a/docs/sphinx/classRF24Mesh.rst +++ /dev/null @@ -1,73 +0,0 @@ -ESBMesh class -~~~~~~~~~~~~~~ - -.. doxygentypedef:: RF24Mesh - -.. cpp:class:: template, radio_t = RF24> ESBMesh - - :tparam network_t: The ``network`` object's type. Defaults to the :class:`RF24Network` specialization - for legacy behavior. This new abstraction is really meant for using the nRF52840 SoC as a - drop-in replacement for the nRF24L01 radio. For more detail, see the - `nrf_to_nrf Arduino library `_. - :tparam radio_t: The ``radio`` object's type. Defaults to :class:`RF24` for legacy behavior. - This new abstraction is really meant for using the nRF52840 SoC as a drop-in replacement - for the nRF24L01 radio. For more detail, see the - `nrf_to_nrf Arduino library `_. - - .. doxygenfunction:: ESBMesh::ESBMesh - - .. seealso:: - - :cpp:class:`RF24` for the ``radio`` object - - :cpp:class:`RF24Network` for the ``network`` object. - -Basic API -============ - -.. doxygenfunction:: ESBMesh::begin - -.. seealso:: - :cpp:enum:`rf24_datarate_e`, :external:cpp:func:`RF24::setChannel()`, :c:macro:`MESH_DEFAULT_CHANNEL`, :c:macro:`MESH_RENEWAL_TIMEOUT` - -.. doxygenfunction:: ESBMesh::update - -.. seealso:: - Review :cpp:func:`RF24Network::update()` for more details. - -.. doxygenfunction:: ESBMesh::write (const void *data, uint8_t msg_type, size_t size, uint8_t nodeID=0) - -.. seealso:: - Review :cpp:var:`RF24NetworkHeader::type` for more details about available message types. - -.. doxygenfunction:: ESBMesh::renewAddress -.. doxygenfunction:: ESBMesh::setNodeID -.. doxygenvariable:: ESBMesh::_nodeID - -Advanced API -============ - -.. doxygenvariable:: ESBMesh::mesh_address -.. doxygenfunction:: ESBMesh::getNodeID -.. doxygenfunction:: ESBMesh::checkConnection -.. doxygenfunction:: ESBMesh::releaseAddress -.. doxygenfunction:: ESBMesh::getAddress -.. doxygenfunction:: ESBMesh::write (uint16_t to_node, const void *data, uint8_t msg_type, size_t size) -.. doxygenfunction:: ESBMesh::setChannel - -.. seealso:: :external:cpp:func:`RF24::setChannel()` - -.. doxygenfunction:: ESBMesh::setChild -.. doxygenfunction:: ESBMesh::setCallback -.. doxygenfunction:: ESBMesh::setAddress -.. doxygenfunction:: ESBMesh::setStaticAddress -.. doxygenfunction:: ESBMesh::DHCP -.. doxygenfunction:: ESBMesh::saveDHCP -.. doxygenfunction:: ESBMesh::loadDHCP - -Address List Struct -=================== - -.. doxygenvariable:: ESBMesh::addrList -.. doxygenvariable:: ESBMesh::addrListTop - -.. doxygenstruct:: ESBMesh::addrListStruct - :members: diff --git a/docs/sphinx/conf.py b/docs/sphinx/conf.py deleted file mode 100644 index 02584c99..00000000 --- a/docs/sphinx/conf.py +++ /dev/null @@ -1,186 +0,0 @@ -"""Configuration file for the Sphinx documentation builder. - -This file only contains a selection of the most common options. For a full -list see the documentation: -https://www.sphinx-doc.org/en/master/usage/configuration.html -""" -import subprocess -import os -import json - -# pylint: disable=invalid-name - -# -- Path setup -------------------------------------------------------------- - -# If extensions (or modules to document with autodoc) are in another directory, -# add these directories to sys.path here. If the directory is relative to the -# documentation root, use os.path.abspath to make it absolute, like shown here. -# -# import sys -# sys.path.insert(0, os.path.abspath('.')) - -# -- Project information ----------------------------------------------------- - -project = "RF24Mesh library" -copyright = "2021, nRF24 org" -author = "nRF24" - -# The full version, including alpha/beta/rc tags -release = "1.1.6" # the minimum version that supports sphinx builds and RTD hosting -with open("../../library.json", "rb") as lib_json: - # get updated info from PlatformIO JSON - release = json.load(lib_json)["version"] - -# The language for content autogenerated by Sphinx. Refer to documentation -# for a list of supported languages. -# This is also used if you do content translation via gettext catalogs. -# Usually you set "language" from the command line for these cases. -language = "en" - - -# -- General configuration --------------------------------------------------- - -# Add any Sphinx extension module names here, as strings. They can be -# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom -# ones. -extensions = [ - "breathe", - "sphinx_immaterial", - "sphinx.ext.intersphinx", - "sphinx.ext.autosectionlabel", - "sphinx_immaterial.apidoc.cpp.cppreference", -] - -intersphinx_mapping = { - "python": ("https://rf24.readthedocs.io/en/latest/", None), - "RF24 library": ("https://rf24.readthedocs.io/en/latest", None), - "RF24Network library": ("https://rf24network.readthedocs.io/en/latest", None), -} - -# Add any paths that contain templates here, relative to this directory. -templates_path = ["_templates"] - -# List of patterns, relative to source directory, that match files and -# directories to ignore when looking for source files. -# This pattern also affects html_static_path and html_extra_path. -exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"] - -# code-blocks will use this as their default syntax highlighting -highlight_language = "c++" - -# If true, '()' will be appended to :func: etc. cross-reference text. -add_function_parentheses = True - -# -- Options for breathe (XML output from doxygen) --------------------------- - -breathe_projects = {"RF24Mesh": "xml"} -breathe_default_project = "RF24Mesh" -breathe_show_define_initializer = True -breathe_show_enumvalue_initializer = True -breathe_domain_by_extension = { "h" : "cpp" } - -READTHEDOCS = os.environ.get("READTHEDOCS", None) == "True" - -if READTHEDOCS: - subprocess.call("cd ..; doxygen", shell=True) - -# -- Options for HTML output ------------------------------------------------- - -# The theme to use for HTML and HTML Help pages. See the documentation for -# a list of builtin themes. -# -html_theme = "sphinx_immaterial" -html_theme_options = { - "features": [ - # "navigation.expand", - "navigation.tabs", - # "toc.integrate", - # "navigation.sections", - "navigation.instant", - # "header.autohide", - "navigation.top", - # "search.highlight", - "search.share", - ], - "palette": [ - { - "media": "(prefers-color-scheme: dark)", - "scheme": "slate", - "primary": "lime", - "accent": "light-blue", - "toggle": { - "icon": "material/lightbulb", - "name": "Switch to light mode", - }, - }, - { - "media": "(prefers-color-scheme: light)", - "scheme": "default", - "primary": "light-blue", - "accent": "green", - "toggle": { - "icon": "material/lightbulb-outline", - "name": "Switch to dark mode", - }, - }, - ], - # Set the repo location to get a badge with stats - "repo_url": "https://github.com/nRF24/RF24Mesh/", - "repo_name": "RF24Mesh", - # If False, expand all TOC entries - "globaltoc_collapse": False, -} - -object_description_options = [ - ("cpp:functionParam", dict(include_in_toc=False, generate_synopses=None)), - ("cpp:function", dict(include_fields_in_toc=False)), -] - -sphinx_immaterial_custom_admonitions = [ - { - "name": "warning", - "color": (255, 66, 66), - "icon": "octicons/alert-24", - "override": True, - }, - { - "name": "note", - "icon": "octicons/pencil-24", - "override": True, - }, - { - "name": "seealso", - "color": (255, 66, 252), - "icon": "octicons/eye-24", - "title": "See Also", - "override": True, - }, - { - "name": "remark", - "color": (116, 66, 255), - "icon": "octicons/checklist-16", - }, -] - -# Set link name generated in the top bar. -html_title = "RF24Mesh C++ library" - -# Add any paths that contain custom static files (such as style sheets) here, -# relative to this directory. They are copied after the builtin static files, -# so a file named "default.css" will overwrite the builtin "default.css". -html_static_path = ["_static"] - -# The name of an image file (relative to this directory) to use as a favicon of -# the docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 -# pixels large. -# -html_favicon = "_static/new_favicon.ico" - -# project logo -html_logo = "_static/Logo large.png" - -# These paths are either relative to html_static_path -# or fully qualified paths (eg. https://...) -html_css_files = [ - "custom_material.css", -] diff --git a/docs/sphinx/deprecated.rst b/docs/sphinx/deprecated.rst deleted file mode 100644 index 3e1b5a0a..00000000 --- a/docs/sphinx/deprecated.rst +++ /dev/null @@ -1,5 +0,0 @@ -Deprecated API -============== - -.. doxygenpage:: deprecated - :content-only: diff --git a/docs/sphinx/examples.rst b/docs/sphinx/examples.rst deleted file mode 100644 index 0fd54690..00000000 --- a/docs/sphinx/examples.rst +++ /dev/null @@ -1,44 +0,0 @@ -Examples -========== - -Arduino Examples ----------------- - -.. toctree:: - :maxdepth: 1 - - examples/Arduino/RF24Mesh_Example - examples/Arduino/RF24Mesh_Example_Master - examples/Arduino/RF24Mesh_Example_Node2Node - examples/Arduino/RF24Mesh_Example_Node2NodeExtra - examples/Arduino/RF24Mesh_SerialConfig - -Linux Examples ----------------- - -.. toctree:: - :maxdepth: 1 - - examples/Linux/RF24Mesh_Example - examples/Linux/RF24Mesh_Example_Master - examples/Linux/RF24Mesh_Ncurses_Master - -PicoSDK Examples ----------------- - -.. toctree:: - :maxdepth: 1 - - examples/PicoSDK/RF24Mesh_Example_Master - examples/PicoSDK/RF24Mesh_Example - examples/PicoSDK/default_pins - - -Python Examples ----------------- - -.. toctree:: - :maxdepth: 1 - - examples/Python/RF24Mesh_Example_Master - examples/Python/RF24Mesh_Example diff --git a/docs/sphinx/examples/Arduino/RF24Mesh_Example.rst b/docs/sphinx/examples/Arduino/RF24Mesh_Example.rst deleted file mode 100644 index 04327d3b..00000000 --- a/docs/sphinx/examples/Arduino/RF24Mesh_Example.rst +++ /dev/null @@ -1,5 +0,0 @@ -RF24Mesh_Example.ino -=========================== - -.. literalinclude:: ../../../../examples/RF24Mesh_Example/RF24Mesh_Example.ino - :linenos: diff --git a/docs/sphinx/examples/Arduino/RF24Mesh_Example_Master.rst b/docs/sphinx/examples/Arduino/RF24Mesh_Example_Master.rst deleted file mode 100644 index 0b702e9c..00000000 --- a/docs/sphinx/examples/Arduino/RF24Mesh_Example_Master.rst +++ /dev/null @@ -1,5 +0,0 @@ -RF24Mesh_Example_Master.ino -=========================== - -.. literalinclude:: ../../../../examples/RF24Mesh_Example_Master/RF24Mesh_Example_Master.ino - :linenos: diff --git a/docs/sphinx/examples/Arduino/RF24Mesh_Example_Node2Node.rst b/docs/sphinx/examples/Arduino/RF24Mesh_Example_Node2Node.rst deleted file mode 100644 index 6bc84a63..00000000 --- a/docs/sphinx/examples/Arduino/RF24Mesh_Example_Node2Node.rst +++ /dev/null @@ -1,5 +0,0 @@ -RF24Mesh_Example_Node2Node.ino -============================== - -.. literalinclude:: ../../../../examples/RF24Mesh_Example_Node2Node/RF24Mesh_Example_Node2Node.ino - :linenos: diff --git a/docs/sphinx/examples/Arduino/RF24Mesh_Example_Node2NodeExtra.rst b/docs/sphinx/examples/Arduino/RF24Mesh_Example_Node2NodeExtra.rst deleted file mode 100644 index f23763f1..00000000 --- a/docs/sphinx/examples/Arduino/RF24Mesh_Example_Node2NodeExtra.rst +++ /dev/null @@ -1,5 +0,0 @@ -RF24Mesh_Example_Node2NodeExtra.ino -=================================== - -.. literalinclude:: ../../../../examples/RF24Mesh_Example_Node2NodeExtra/RF24Mesh_Example_Node2NodeExtra.ino - :linenos: diff --git a/docs/sphinx/examples/Arduino/RF24Mesh_SerialConfig.rst b/docs/sphinx/examples/Arduino/RF24Mesh_SerialConfig.rst deleted file mode 100644 index bf2d82c3..00000000 --- a/docs/sphinx/examples/Arduino/RF24Mesh_SerialConfig.rst +++ /dev/null @@ -1,5 +0,0 @@ -RF24Mesh_SerialConfig.ino -========================= - -.. literalinclude:: ../../../../examples/RF24Mesh_SerialConfig/RF24Mesh_SerialConfig.ino - :linenos: diff --git a/docs/sphinx/examples/Linux/RF24Mesh_Example.rst b/docs/sphinx/examples/Linux/RF24Mesh_Example.rst deleted file mode 100644 index f24e5ddf..00000000 --- a/docs/sphinx/examples/Linux/RF24Mesh_Example.rst +++ /dev/null @@ -1,6 +0,0 @@ -RF24Mesh_Example.cpp -=========================== - -.. literalinclude:: ../../../../examples_RPi/RF24Mesh_Example.cpp - :caption: examples_RPi/RF24Mesh_Example.cpp - :linenos: diff --git a/docs/sphinx/examples/Linux/RF24Mesh_Example_Master.rst b/docs/sphinx/examples/Linux/RF24Mesh_Example_Master.rst deleted file mode 100644 index 60994571..00000000 --- a/docs/sphinx/examples/Linux/RF24Mesh_Example_Master.rst +++ /dev/null @@ -1,6 +0,0 @@ -RF24Mesh_Example_Master.cpp -=========================== - -.. literalinclude:: ../../../../examples_RPi/RF24Mesh_Example_Master.cpp - :caption: examples_RPi/RF24Mesh_Example_Master.cpp - :linenos: diff --git a/docs/sphinx/examples/Linux/RF24Mesh_Ncurses_Master.rst b/docs/sphinx/examples/Linux/RF24Mesh_Ncurses_Master.rst deleted file mode 100644 index e044fe7d..00000000 --- a/docs/sphinx/examples/Linux/RF24Mesh_Ncurses_Master.rst +++ /dev/null @@ -1,10 +0,0 @@ -RF24Mesh_Ncurses_Master.cpp -=========================== - -A very limited ncurses interface used for initial monitoring/testing of RF24Mesh. - -.. image:: ../../../../images/RF24Mesh_Ncurses.JPG - -.. literalinclude:: ../../../../examples_RPi/ncurses/RF24Mesh_Ncurses_Master.cpp - :caption: examples_RPi/RF24Mesh_Ncurses_Master.cpp - :linenos: diff --git a/docs/sphinx/examples/PicoSDK/RF24Mesh_Example.rst b/docs/sphinx/examples/PicoSDK/RF24Mesh_Example.rst deleted file mode 100644 index 90b61ccf..00000000 --- a/docs/sphinx/examples/PicoSDK/RF24Mesh_Example.rst +++ /dev/null @@ -1,8 +0,0 @@ -RF24Mesh_Example -=========================== - -.. seealso:: - `defaultPins.h `_ - -.. literalinclude:: ../../../../examples_pico/RF24Mesh_Example.cpp - :linenos: diff --git a/docs/sphinx/examples/PicoSDK/RF24Mesh_Example_Master.rst b/docs/sphinx/examples/PicoSDK/RF24Mesh_Example_Master.rst deleted file mode 100644 index 6fc89fee..00000000 --- a/docs/sphinx/examples/PicoSDK/RF24Mesh_Example_Master.rst +++ /dev/null @@ -1,8 +0,0 @@ -RF24Mesh_Example_Master -=========================== - -.. seealso:: - `defaultPins.h `_ - -.. literalinclude:: ../../../../examples_pico/RF24Mesh_Example_Master.cpp - :linenos: diff --git a/docs/sphinx/examples/PicoSDK/default_pins.rst b/docs/sphinx/examples/PicoSDK/default_pins.rst deleted file mode 100644 index 54087260..00000000 --- a/docs/sphinx/examples/PicoSDK/default_pins.rst +++ /dev/null @@ -1,5 +0,0 @@ -PicoSDK Examples' Default Pins -============================== - -.. literalinclude:: ../../../../examples_pico/defaultPins.h - :linenos: diff --git a/docs/sphinx/examples/Python/RF24Mesh_Example.rst b/docs/sphinx/examples/Python/RF24Mesh_Example.rst deleted file mode 100644 index 43a09e1d..00000000 --- a/docs/sphinx/examples/Python/RF24Mesh_Example.rst +++ /dev/null @@ -1,7 +0,0 @@ -RF24Mesh_Example.py -=========================== - -.. literalinclude:: ../../../../examples_RPi/RF24Mesh_Example.py - :language: python - :caption: examples_RPi/RF24Mesh_Example.py - :linenos: diff --git a/docs/sphinx/examples/Python/RF24Mesh_Example_Master.rst b/docs/sphinx/examples/Python/RF24Mesh_Example_Master.rst deleted file mode 100644 index 8b8f354a..00000000 --- a/docs/sphinx/examples/Python/RF24Mesh_Example_Master.rst +++ /dev/null @@ -1,7 +0,0 @@ -RF24Mesh_Example_Master.py -=========================== - -.. literalinclude:: ../../../../examples_RPi/RF24Mesh_Example_Master.py - :language: python - :caption: examples_RPi/RF24Mesh_Example_Master.py - :linenos: diff --git a/docs/sphinx/index.rst b/docs/sphinx/index.rst deleted file mode 100644 index 2283f6de..00000000 --- a/docs/sphinx/index.rst +++ /dev/null @@ -1,37 +0,0 @@ - -:hero: Mesh Networking Layer for nRF24L01 radios - -Introduction -============= - -.. doxygenpage:: index - :content-only: - -Site Index ------------ - -:ref:`Site index` - -.. toctree:: - :maxdepth: 2 - :caption: API Reference - :hidden: - - classRF24Mesh - RF24Mesh_8h - RF24Mesh__config_8h - deprecated - - -.. toctree:: - :maxdepth: 1 - :hidden: - - pages - - -.. toctree:: - :maxdepth: 2 - :hidden: - - examples diff --git a/docs/sphinx/make.bat b/docs/sphinx/make.bat deleted file mode 100644 index bba10073..00000000 --- a/docs/sphinx/make.bat +++ /dev/null @@ -1,35 +0,0 @@ -@ECHO OFF - -pushd %~dp0 - -REM Command file for Sphinx documentation - -if "%SPHINXBUILD%" == "" ( - set SPHINXBUILD=sphinx-build -) -set SOURCEDIR=../sphinx -set BUILDDIR=../_build - -if "%1" == "" goto help - -%SPHINXBUILD% >NUL 2>NUL -if errorlevel 9009 ( - echo. - echo.The 'sphinx-build' command was not found. Make sure you have Sphinx - echo.installed, then set the SPHINXBUILD environment variable to point - echo.to the full path of the 'sphinx-build' executable. Alternatively you - echo.may add the Sphinx directory to PATH. - echo. - echo.If you don't have Sphinx installed, grab it from - echo.https://www.sphinx-doc.org/ - exit /b 1 -) - -%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% -goto end - -:help -%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% - -:end -popd diff --git a/docs/sphinx/md_contributing.rst b/docs/sphinx/md_contributing.rst deleted file mode 100644 index 8a9b00db..00000000 --- a/docs/sphinx/md_contributing.rst +++ /dev/null @@ -1,5 +0,0 @@ -Contributing -============= - -.. doxygenpage:: md_CONTRIBUTING - :content-only: diff --git a/docs/sphinx/md_docs_general_usage.rst b/docs/sphinx/md_docs_general_usage.rst deleted file mode 100644 index 5a53a1a4..00000000 --- a/docs/sphinx/md_docs_general_usage.rst +++ /dev/null @@ -1,5 +0,0 @@ -General Usage -================ - -.. doxygenpage:: md_docs_general_usage - :content-only: diff --git a/docs/sphinx/md_docs_setup_config.rst b/docs/sphinx/md_docs_setup_config.rst deleted file mode 100644 index 81cc4dfe..00000000 --- a/docs/sphinx/md_docs_setup_config.rst +++ /dev/null @@ -1,5 +0,0 @@ -Setup And Config -================ - -.. doxygenpage:: md_docs_setup_config - :content-only: diff --git a/docs/sphinx/pages.rst b/docs/sphinx/pages.rst deleted file mode 100644 index a8b4b119..00000000 --- a/docs/sphinx/pages.rst +++ /dev/null @@ -1,9 +0,0 @@ -Related Pages -============= - -.. toctree:: - :maxdepth: 1 - - md_contributing - md_docs_general_usage - md_docs_setup_config diff --git a/docs/sphinx/requirements.txt b/docs/sphinx/requirements.txt deleted file mode 100644 index 1707fa2f..00000000 --- a/docs/sphinx/requirements.txt +++ /dev/null @@ -1,2 +0,0 @@ -breathe -sphinx-immaterial