[QNEBE-640] Readthedoc fix

.readthedocs.yaml

@@ -1,4 +1,11 @@
+build:
+  image: latest
+
 python:
   version: 3.8
   setup_py_install: true
-  pip_install: true
+  pip_install: true
+
+formats:
+  - pdf
+  - epub

docs/Makefile

@@ -5,8 +5,8 @@
 SPHINXOPTS    =
 SPHINXBUILD   = sphinx-build
 SOURCEDIR     = .
-BUILDDIR      = build
-PYTHON3       = python3
+BUILDDIR      = _build
+PYTHON3       = python
 # TODO handle like this?
 export NETQASM_SIMULATOR = debug
 

docs/api_root.rst

@@ -9,4 +9,4 @@ netqasm package
    netqasm.logging
    netqasm.runtime
    netqasm.sdk
-   netqasm.util
+   netqasm.util

docs/conf.py

@@ -22,9 +22,9 @@
 author = "QuTech"
 
 # The full version, including alpha/beta/rc tags
-from importlib.metadata import version
+from importlib.metadata import version as get_release_version
 
-release = version("netqasm")
+release = get_release_version("netqasm")
 
 
 # -- General configuration ---------------------------------------------------
@@ -84,4 +84,4 @@
 # 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"]
+# html_static_path = ["_static"]

docs/netqasm.examples.rst

@@ -8,4 +8,6 @@ netqasm\.examples
    api_examples/netqasm.examples.apps
    api_examples/netqasm.examples.lib
    api_examples/netqasm.examples.netqasm_files
-   api_examples/netqasm.examples.sdk_examples
+   api_examples/netqasm.examples.qne_apps
+   api_examples/netqasm.examples.sdk_compilation
+   api_examples/netqasm.examples.sdk_scripts

docs/netqasm.sdk.rst

@@ -1,13 +1,12 @@
 netqasm\.sdk
-================
+============
 
 .. toctree::
    :caption: Modules
    :maxdepth: 2
 
    api_sdk/netqasm.sdk.builder
    api_sdk/netqasm.sdk.classical_communication
-   api_sdk/netqasm.sdk.compiling
    api_sdk/netqasm.sdk.config
    api_sdk/netqasm.sdk.connection
    api_sdk/netqasm.sdk.epr_socket
@@ -17,4 +16,4 @@ netqasm\.sdk
    api_sdk/netqasm.sdk.progress_bar
    api_sdk/netqasm.sdk.qubit
    api_sdk/netqasm.sdk.shared_memory
-   api_sdk/netqasm.sdk.toolbox
+   api_sdk/netqasm.sdk.toolbox

docs/quickstart/modules.rst

@@ -50,7 +50,7 @@ NetQASM connection
      :noindex:
      :special-members: __enter__, __exit__
      :members:
-   :undoc-members: app_name, node_name, app_id, flush, block
+     :undoc-members: app_name, node_name, app_id, flush, block
 
 Qubit
 -----
@@ -61,7 +61,7 @@ Qubit
    .. autoclass:: Qubit
      :noindex:
      :members:
-   :undoc-members: qubit_id, entanglement_info, remote_entangled_node, measure,
+     :undoc-members: qubit_id, entanglement_info, remote_entangled_node, measure,
                 X, Y, Z, H, S, K, T,
                 rot_X, rot_Y, rot_Z,
                 cnot, cphase, reset, free
@@ -74,8 +74,8 @@ EPR socket
 
    .. autoclass:: EPRSocket
      :members:
-   :undoc-members: conn, remote_app_name, remote_node_id, epr_socket_id, remote_epr_socket_id, min_fidelity,
-                create, recv,
+     :undoc-members: conn, remote_app_name, remote_node_id, epr_socket_id, remote_epr_socket_id, min_fidelity,
+                     create, recv,
      :noindex:
 
       .. automethod:: create_context(number=1, sequential=False)
@@ -92,20 +92,19 @@ Futures
 
    .. autoclass:: Future
      :members:
-   :undoc-members: add, value
+     :undoc-members: add, value
      :noindex:
 
    .. autoclass:: Array
      :members:
-   :undoc-members: get_future_index, get_future_slice, foreach, enumerate
+     :undoc-members: get_future_index, get_future_slice, foreach, enumerate
      :noindex:
 
    .. autoclass:: RegFuture
      :members:
-   :undoc-members: add, value
+     :undoc-members: add, value
      :noindex:
 
-
 Classical communication
 -----------------------
 

docs/requirements.txt

@@ -1,3 +1,5 @@
 sphinx>=3.5.3,<4.0.0
 sphinx-rtd-theme>=0.5.2,<1.0.0
 sphinx-autodoc-typehints>=1.11.1,<2.0.0
+jinja2<3.0.0
+MarkupSafe==2.0.1