Initial commit to get working read the docs deployment preview

Author: mcbarton

docs/source/conf.py

@@ -7,7 +7,38 @@
 on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
 
 if on_rtd:
-    subprocess.call('cd ..; doxygen', shell=True)
+    XEUS_CPP_ROOT = os.path.abspath('../..')
+    command_emscripten = 'cd {0};\
+                          micromamba create -f environment-wasm-build.yml -y;\
+                          micromamba activate xeus-cpp-wasm-build;\
+                          micromamba create -f environment-wasm-host.yml --platform=emscripten-wasm32;\
+                          mkdir build;\
+                          cd build;\
+                          export BUILD_PREFIX=$MAMBA_ROOT_PREFIX/envs/xeus-cpp-wasm-build;\
+                          export PREFIX=$MAMBA_ROOT_PREFIX/envs/xeus-cpp-wasm-host;\
+                          export SYSROOT_PATH=$BUILD_PREFIX/opt/emsdk/upstream/emscripten/cache/sysroot;\
+                          emcmake cmake -DCMAKE_BUILD_TYPE=Release                                     \
+                                        -DCMAKE_PREFIX_PATH=$PREFIX                                    \
+                                        -DCMAKE_INSTALL_PREFIX=$PREFIX                                 \
+                                        -DXEUS_CPP_EMSCRIPTEN_WASM_BUILD=ON                            \
+                                        -DCMAKE_FIND_ROOT_PATH_MODE_PACKAGE=ON                         \
+                                        -DXEUS_CPP_RESOURCE_DIR=$LLVM_BUILD_DIR/lib/clang/$LLVM_VERSION \
+                                        -DSYSROOT_PATH=$SYSROOT_PATH                                   \
+                                        {0}/xeus-cpp/;\
+                          emmake make -j $(nproc --all) install;\
+                          cd {0};\
+                          micromamba create -n xeus-lite-host jupyterlite-core -c conda-forge;\
+                          micromamba activate xeus-lite-host;\
+                          python -m pip install jupyterlite-xeus jupyter_server;\
+                          jupyter lite build --XeusAddon.prefix=$PREFIX \
+                          --contents notebooks/xeus-cpp-lite-demo.ipynb \
+                          --contents notebooks/smallpt.ipynb \
+                          --contents notebooks/images/marie.png \
+                          --contents notebooks/audio/audio.wav \
+                          --output-dir $READTHEDOCS_OUTPUT/html/xeus-cpp;'.format(XEUS_CPP_ROOT)
+    subprocess.call('cd {0}/xeus-cpp/docs/; doxygen', shell=True)
+    subprocess.call(command_emscripten.format(XEUS_CPP_ROOT), shell=True)
+    
 
 import sphinx_rtd_theme
 
@@ -32,4 +63,4 @@ def setup(app):
 highlight_language = 'c++'
 pygments_style = 'sphinx'
 todo_include_todos = False
-htmlhelp_basename = 'xeus-cppdoc'
+htmlhelp_basename = 'xeus-cppdoc'