[Fix] Fix API documentation compilation and mmcv build errors (#1116)

* Simplify the requirements in the readthedoc yml

* Remove unused packages in the docs.txt

* Add m2r and recommonmark in the docs.txt

* Fix mistune version because the latest mistune does not have module BlockGrammar

* Add mmdet in the readthedocs.txt to compile api docs

* Add mmseg in the readthedocs.txt to compile api docs

* Fix the typo of mmseg (should be mmsegmentation)

* Add mmcv.ops into autodoc_mock_imports

* Add numba into readthedocs.txt to compile api docs

* Remove numba from readthedocs.txt and add runtime requirements in readthedocs.yml

.readthedocs.yml

@@ -8,4 +8,3 @@ python:
     - requirements: requirements/docs.txt
     - requirements: requirements/runtime.txt
     - requirements: requirements/readthedocs.txt
-    - requirements: requirements/mminstall.txt

docs/conf.py

@@ -54,7 +54,7 @@ extensions = [
 
 autodoc_mock_imports = [
     'matplotlib', 'nuscenes', 'PIL', 'pycocotools', 'pyquaternion',
-    'terminaltables', 'mmdet3d.version', 'mmdet3d.ops'
+    'terminaltables', 'mmdet3d.version', 'mmdet3d.ops', 'mmcv.ops'
 ]
 autosectionlabel_prefix_document = True
 

docs_zh-CN/conf.py

@@ -54,7 +54,7 @@ extensions = [
 
 autodoc_mock_imports = [
     'matplotlib', 'nuscenes', 'PIL', 'pycocotools', 'pyquaternion',
-    'terminaltables', 'mmdet3d.version', 'mmdet3d.ops'
+    'terminaltables', 'mmdet3d.version', 'mmdet3d.ops', 'mmcv.ops'
 ]
 autosectionlabel_prefix_document = True
 

requirements/docs.txt

 docutils==0.16.0
 m2r
-myst-parser
-opencv-python
+mistune==0.8.4
 -e git+https://github.com/open-mmlab/pytorch_sphinx_theme.git#egg=pytorch_sphinx_theme
+recommonmark
 sphinx==4.0.2
 sphinx-copybutton
 sphinx_markdown_tables
-torch

requirements/readthedocs.txt

 mmcv
+mmdet
+mmsegmentation>=0.14.1
 torch
 torchvision