` (``/home/alexandre/Documents/test-sphinx/cpp-example/include/Driver.h``)
-
-.. |exhale_lsh| unicode:: U+021B0 .. UPWARDS ARROW WITH TIP LEFTWARDS
-
-.. code-block:: cpp
-
-
- class Driver
- {
- public:
- int write(unsigned char *buffer);
-
- private:
- bool mIsActive;
- };
diff --git a/cpp-example/docs/source/api/unabridged_api.rst.include b/cpp-example/docs/source/api/unabridged_api.rst.include
deleted file mode 100644
index 2b067ca..0000000
--- a/cpp-example/docs/source/api/unabridged_api.rst.include
+++ /dev/null
@@ -1,12 +0,0 @@
-
-Full API
---------
-
-Classes and Structs
-*******************
-
-
-.. toctree::
- :maxdepth: 5
-
- classDriver.rst
diff --git a/cpp-example/docs/source/api/unabridged_orphan.rst b/cpp-example/docs/source/api/unabridged_orphan.rst
deleted file mode 100644
index 466cb7d..0000000
--- a/cpp-example/docs/source/api/unabridged_orphan.rst
+++ /dev/null
@@ -1,23 +0,0 @@
-:orphan:
-
-
-Full API
-========
-
-Directories
-***********
-
-
-.. toctree::
- :maxdepth: 5
-
- dir__home_alexandre_Documents_test-sphinx_cpp-example_include.rst
-
-Files
-*****
-
-
-.. toctree::
- :maxdepth: 5
-
- file__home_alexandre_Documents_test-sphinx_cpp-example_include_Driver.h.rst
diff --git a/cpp-example/readme.md b/cpp-example/readme.md
index 34818e1..6ae5cd4 100644
--- a/cpp-example/readme.md
+++ b/cpp-example/readme.md
@@ -1,19 +1,86 @@
-# Sphinx documentation for C / C++
+# Sphinx documentation from c/c++ doxygen doc
-## :wrench: Dependencies installation
+## :tv: Demo
```sh
-pip3 install sphinx breathe exhale
+# Installing dependencies
+pip3 install sphinx shibuya breathe exhale
sudo apt-get install doxygen
-```
-## :rocket: Générer la documentation
-
-```sh
+# Generating documentation
cd docs
make html
-```
\ No newline at end of file
+```
+
+You can acces it through `docs/build/html/index.html`.
+
+## :rocket: How to use it ?
+
+**1. Generate the sphinx structure**
+
+In a first place, you need to generate the sphinx documentation using
+the command `sphinx-quickstart` inside a `docs` folder as below :
+
+```sh
+mkdir docs
+cd docs
+sphinx-quickstart --sep -l "fr" -r 1.0 .
+```
+
+Now your project structure should look like this
+
+```
+my_project/
+├── docs/
+│ ├── build/
+│ ├── source/
+│ ├── conf.py
+│ ├── make.bat
+│ └── Makefie
+├── src
+└── readme.md
+```
+
+**2. Edit sphinx config**
+
+And lastly you need to copy the next script at the end of the `conf.py` file.
+This script add the needed configuration to allow sphinx to generate the documentation from doxygen documentation inside `.h`,`.c`,`.cpp`,`.hpp`... (You don't need to change anything in the next configuration)
+
+```py
+extensions += ['breathe','exhale']
+
+breathe_projects = {"My Project": "../build/_doxygen/xml"}
+breathe_default_project = "My Project"
+
+exhale_args = {
+ "containmentFolder": "./api",
+ "rootFileName": "library_root.rst",
+ "doxygenStripFromPath": "..",
+ "rootFileTitle": "Library API",
+ "createTreeView": True,
+ "exhaleExecutesDoxygen": True,
+ "exhaleDoxygenStdin": "INPUT = ../../include"
+}
+```
+
+**3. Link the doc to a toctree**
+
+Now you need to link the documentation somewhere in your sphinx `rst` file.
+The best way is to go in `source/index.rst` and add `api/library_root` as an entry of the toctree.
+
+```css
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+
+ api/library_root
+```
+
+**4. Now you can generate !**
+
+Inside the `docs` directory you can now execute `make html` !
+You can acces it through `docs/build/html/index.html`.
\ No newline at end of file
diff --git a/make.bat b/make.bat
new file mode 100644
index 0000000..747ffb7
--- /dev/null
+++ b/make.bat
@@ -0,0 +1,35 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+ set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=source
+set BUILDDIR=build
+
+%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
+)
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+
+:end
+popd