Reorg docs (isl-org#2381)

* restructure docs * more protection against disabled modules * core->tensor
ECNURoboLab · Oct 1, 2020 · 1860e75 · 1860e75
1 parent 664eff5
commit 1860e75
Show file tree

Hide file tree

Showing 235 changed files with 551 additions and 398 deletions.
diff --git a/.gitignore b/.gitignore
@@ -51,30 +51,30 @@ static/
 compile_commands.json
 
 # Example resources
-examples/python/ReconstructionSystem/dataset/
+examples/python/reconstruction_system/dataset/
 examples/test_data/fountain_small
 examples/test_data/Armadillo.ply
 examples/test_data/Bunny.ply
 examples/test_data/eagle.ply
 examples/test_data/voxelized.ply
-examples/python/Basic/voxel_grid_test.ply
-examples/python/Benchmark/testdata/
-examples/python/Misc/test.jpg
+examples/python/geometry/voxel_grid_test.ply
+examples/python/benchmark/testdata/
+examples/python/misc/test.jpg
 examples/test_data/GraphOptimization/pose_graph_example_fragment_optimized.json
 examples/test_data/GraphOptimization/pose_graph_example_global_optimized.json
 examples/test_data/depth/
 examples/test_data/image/
 examples/test_data/sync.ply
 examples/test_data/sync.png
-examples/python/Advanced/multiway_registration.pcd
-examples/python/Advanced/test.json
-examples/python/Advanced/viewpoint.json
-examples/python/Basic/copy_of_fragment.pcd
-examples/python/Basic/copy_of_knot.ply
-examples/python/Basic/copy_of_lena_color.jpg
-examples/python/Basic/copy_of_crate.mtl
-examples/python/Basic/copy_of_crate.png
-examples/python/Basic/copy_of_crate.obj
+examples/python/pipelines/multiway_registration.pcd
+examples/python/geometry/test.json
+examples/python/visualization/viewpoint.json
+examples/python/geometry/copy_of_fragment.pcd
+examples/python/geometry/copy_of_knot.ply
+examples/python/geometry/copy_of_lena_color.jpg
+examples/python/geometry/copy_of_crate.mtl
+examples/python/geometry/copy_of_crate.png
+examples/python/geometry/copy_of_crate.obj
 
 # doc
 docs/test_data

diff --git a/README.md b/README.md
@@ -80,9 +80,7 @@ Test your installation with:
 $ python -c "import open3d as o3d"
 ```
 
-and follow the [basic tutorials](http://www.open3d.org/docs/release/tutorial/Basic/index.html)
-or [Python examples](https://github.com/intel-isl/Open3D/tree/master/examples/python) to get
-started.
+and follow the tutorials to get started.
 
 ## C++ quick start
 

diff --git a/docs/_static/Advanced/color_map_optimization/initial.png b/docs/_static/Advanced/color_map_optimization/initial.png
diff --git a/docs/_static/Advanced/color_map_optimization/initial_zoom.png b/docs/_static/Advanced/color_map_optimization/initial_zoom.png
diff --git a/docs/_static/Advanced/color_map_optimization/non_rigid.png b/docs/_static/Advanced/color_map_optimization/non_rigid.png
diff --git a/docs/_static/Advanced/color_map_optimization/non_rigid_zoom.png b/docs/_static/Advanced/color_map_optimization/non_rigid_zoom.png
diff --git a/docs/_static/Advanced/color_map_optimization/rigid.png b/docs/_static/Advanced/color_map_optimization/rigid.png
diff --git a/docs/_static/Advanced/color_map_optimization/rigid_zoom.png b/docs/_static/Advanced/color_map_optimization/rigid_zoom.png
diff --git a/docs/_static/Advanced/colored_pointcloud_registration/colored.png b/docs/_static/Advanced/colored_pointcloud_registration/colored.png
diff --git a/docs/_static/Advanced/colored_pointcloud_registration/colored_side.png b/docs/_static/Advanced/colored_pointcloud_registration/colored_side.png
diff --git a/docs/_static/Advanced/colored_pointcloud_registration/initial.png b/docs/_static/Advanced/colored_pointcloud_registration/initial.png
diff --git a/docs/_static/Advanced/colored_pointcloud_registration/initial_side.png b/docs/_static/Advanced/colored_pointcloud_registration/initial_side.png
diff --git a/docs/_static/Advanced/colored_pointcloud_registration/point_to_plane.png b/docs/_static/Advanced/colored_pointcloud_registration/point_to_plane.png
diff --git a/docs/_static/Advanced/colored_pointcloud_registration/point_to_plane_side.png b/docs/_static/Advanced/colored_pointcloud_registration/point_to_plane_side.png
diff --git a/docs/_static/Advanced/fast_global_registration/fgr.png b/docs/_static/Advanced/fast_global_registration/fgr.png
diff --git a/docs/_static/Advanced/fast_global_registration/ransac.png b/docs/_static/Advanced/fast_global_registration/ransac.png
diff --git a/docs/_static/Advanced/global_registration/icp.png b/docs/_static/Advanced/global_registration/icp.png
diff --git a/docs/_static/Advanced/global_registration/initial.png b/docs/_static/Advanced/global_registration/initial.png
diff --git a/docs/_static/Advanced/global_registration/ransac.png b/docs/_static/Advanced/global_registration/ransac.png
diff --git a/docs/_static/Advanced/multiway_registration/combined.png b/docs/_static/Advanced/multiway_registration/combined.png
diff --git a/docs/_static/Advanced/multiway_registration/initial.png b/docs/_static/Advanced/multiway_registration/initial.png
diff --git a/docs/_static/Advanced/multiway_registration/optimized.png b/docs/_static/Advanced/multiway_registration/optimized.png
diff --git a/docs/_static/Advanced/pointcloud_outlier_removal/radius_outlier_removal.png b/docs/_static/Advanced/pointcloud_outlier_removal/radius_outlier_removal.png
diff --git a/docs/_static/Advanced/pointcloud_outlier_removal/statistical_outlier_removal.png b/docs/_static/Advanced/pointcloud_outlier_removal/statistical_outlier_removal.png
diff --git a/docs/_static/Advanced/pointcloud_outlier_removal/uniform_down_sample.png b/docs/_static/Advanced/pointcloud_outlier_removal/uniform_down_sample.png
diff --git a/docs/_static/Advanced/pointcloud_outlier_removal/voxel_down_sample.png b/docs/_static/Advanced/pointcloud_outlier_removal/voxel_down_sample.png
diff --git a/docs/_static/Advanced/rgbd_integration/integrated.png b/docs/_static/Advanced/rgbd_integration/integrated.png
diff --git a/docs/_static/Basic/icp/initial.png b/docs/_static/Basic/icp/initial.png
diff --git a/docs/_static/Basic/icp/point_to_plane.png b/docs/_static/Basic/icp/point_to_plane.png
diff --git a/docs/_static/Basic/icp/point_to_point.png b/docs/_static/Basic/icp/point_to_point.png
diff --git a/docs/_static/Basic/icp/point_to_point_2000.png b/docs/_static/Basic/icp/point_to_point_2000.png
diff --git a/docs/_static/Basic/kdtree/kdtree.png b/docs/_static/Basic/kdtree/kdtree.png
diff --git a/docs/_static/Basic/mesh/half.png b/docs/_static/Basic/mesh/half.png
diff --git a/docs/_static/Basic/mesh/half_color.png b/docs/_static/Basic/mesh/half_color.png
diff --git a/docs/_static/Basic/mesh/with_shading.png b/docs/_static/Basic/mesh/with_shading.png
diff --git a/docs/_static/Basic/mesh/without_shading.png b/docs/_static/Basic/mesh/without_shading.png
diff --git a/docs/_static/Basic/pointcloud/crop.png b/docs/_static/Basic/pointcloud/crop.png
diff --git a/docs/_static/Basic/pointcloud/crop_color.png b/docs/_static/Basic/pointcloud/crop_color.png
diff --git a/docs/_static/Basic/pointcloud/downsampled.png b/docs/_static/Basic/pointcloud/downsampled.png
diff --git a/docs/_static/Basic/pointcloud/downsampled_normal.png b/docs/_static/Basic/pointcloud/downsampled_normal.png
diff --git a/docs/_static/Basic/pointcloud/scene.png b/docs/_static/Basic/pointcloud/scene.png
diff --git a/docs/_static/Basic/pointcloud/scene_small.png b/docs/_static/Basic/pointcloud/scene_small.png
diff --git a/docs/_static/Basic/rgbd_images/nyu_pcd.png b/docs/_static/Basic/rgbd_images/nyu_pcd.png
diff --git a/docs/_static/Basic/rgbd_images/nyu_rgbd.png b/docs/_static/Basic/rgbd_images/nyu_rgbd.png
diff --git a/docs/_static/Basic/rgbd_images/redwood_pcd.png b/docs/_static/Basic/rgbd_images/redwood_pcd.png
diff --git a/docs/_static/Basic/rgbd_images/redwood_rgbd.png b/docs/_static/Basic/rgbd_images/redwood_rgbd.png
diff --git a/docs/_static/Basic/rgbd_images/sun_pcd.png b/docs/_static/Basic/rgbd_images/sun_pcd.png
diff --git a/docs/_static/Basic/rgbd_images/sun_rgbd.png b/docs/_static/Basic/rgbd_images/sun_rgbd.png
diff --git a/docs/_static/Basic/rgbd_images/tum_pcd.png b/docs/_static/Basic/rgbd_images/tum_pcd.png
diff --git a/docs/_static/Basic/rgbd_images/tum_rgbd.png b/docs/_static/Basic/rgbd_images/tum_rgbd.png
diff --git a/docs/_static/Basic/rgbd_odometry/color_term.png b/docs/_static/Basic/rgbd_odometry/color_term.png
diff --git a/docs/_static/Basic/rgbd_odometry/hybrid_term.png b/docs/_static/Basic/rgbd_odometry/hybrid_term.png
diff --git a/docs/_static/Basic/working_with_numpy/sync_3d.png b/docs/_static/Basic/working_with_numpy/sync_3d.png
diff --git a/docs/_static/Basic/working_with_numpy/sync_image.png b/docs/_static/Basic/working_with_numpy/sync_image.png
diff --git a/...tem/capture_your_own_dataset/recorder.png → ...tem/capture_your_own_dataset/recorder.png b/...tem/capture_your_own_dataset/recorder.png → ...tem/capture_your_own_dataset/recorder.png
diff --git a/...structionSystem/integrate_scene/scene.png → ...truction_system/integrate_scene/scene.png b/...structionSystem/integrate_scene/scene.png → ...truction_system/integrate_scene/scene.png
diff --git a/...ctionSystem/make_fragments/fragment_0.png → ...tion_system/make_fragments/fragment_0.png b/...ctionSystem/make_fragments/fragment_0.png → ...tion_system/make_fragments/fragment_0.png
diff --git a/...ctionSystem/make_fragments/fragment_1.png → ...tion_system/make_fragments/fragment_1.png b/...ctionSystem/make_fragments/fragment_1.png → ...tion_system/make_fragments/fragment_1.png
diff --git a/...ctionSystem/make_fragments/fragment_2.png → ...tion_system/make_fragments/fragment_2.png b/...ctionSystem/make_fragments/fragment_2.png → ...tion_system/make_fragments/fragment_2.png
diff --git a/...ctionSystem/make_fragments/fragment_3.png → ...tion_system/make_fragments/fragment_3.png b/...ctionSystem/make_fragments/fragment_3.png → ...tion_system/make_fragments/fragment_3.png
diff --git a/...anced/customized_visualization/custom.png → ...ation/customized_visualization/custom.png b/...anced/customized_visualization/custom.png → ...ation/customized_visualization/custom.png
diff --git a/.../customized_visualization/depth_small.gif → .../customized_visualization/depth_small.gif b/.../customized_visualization/depth_small.gif → .../customized_visualization/depth_small.gif
diff --git a/...vanced/customized_visualization/fov_5.png → ...zation/customized_visualization/fov_5.png b/...vanced/customized_visualization/fov_5.png → ...zation/customized_visualization/fov_5.png
diff --git a/...anced/customized_visualization/fov_90.png → ...ation/customized_visualization/fov_90.png b/...anced/customized_visualization/fov_90.png → ...ation/customized_visualization/fov_90.png
diff --git a/.../customized_visualization/image_small.gif → .../customized_visualization/image_small.gif b/.../customized_visualization/image_small.gif → .../customized_visualization/image_small.gif
diff --git a/...vanced/customized_visualization/key_k.png → ...zation/customized_visualization/key_k.png b/...vanced/customized_visualization/key_k.png → ...zation/customized_visualization/key_k.png
diff --git a/...anced/customized_visualization/normal.png → ...ation/customized_visualization/normal.png b/...anced/customized_visualization/normal.png → ...ation/customized_visualization/normal.png
diff --git a/...customized_visualization/rotate_small.gif → ...customized_visualization/rotate_small.gif b/...customized_visualization/rotate_small.gif → ...customized_visualization/rotate_small.gif
diff --git a/...teractive_visualization/crop_freeview.png → ...teractive_visualization/crop_freeview.png b/...teractive_visualization/crop_freeview.png → ...teractive_visualization/crop_freeview.png
diff --git a/...d/interactive_visualization/crop_lock.png → ...n/interactive_visualization/crop_lock.png b/...d/interactive_visualization/crop_lock.png → ...n/interactive_visualization/crop_lock.png
diff --git a/...interactive_visualization/crop_result.png → ...interactive_visualization/crop_result.png b/...interactive_visualization/crop_result.png → ...interactive_visualization/crop_result.png
diff --git a/...d/interactive_visualization/crop_save.png → ...n/interactive_visualization/crop_save.png b/...d/interactive_visualization/crop_save.png → ...n/interactive_visualization/crop_save.png
diff --git a/...eractive_visualization/crop_selection.png → ...eractive_visualization/crop_selection.png b/...eractive_visualization/crop_selection.png → ...eractive_visualization/crop_selection.png
diff --git a/...ve_visualization/manual_icp_alignment.png → ...ve_visualization/manual_icp_alignment.png b/...ve_visualization/manual_icp_alignment.png → ...ve_visualization/manual_icp_alignment.png
diff --git a/...tive_visualization/manual_icp_initial.png → ...tive_visualization/manual_icp_initial.png b/...tive_visualization/manual_icp_initial.png → ...tive_visualization/manual_icp_initial.png
diff --git a/...ctive_visualization/manual_icp_source.png → ...ctive_visualization/manual_icp_source.png b/...ctive_visualization/manual_icp_source.png → ...ctive_visualization/manual_icp_source.png
diff --git a/...ctive_visualization/manual_icp_target.png → ...ctive_visualization/manual_icp_target.png b/...ctive_visualization/manual_icp_target.png → ...ctive_visualization/manual_icp_target.png
diff --git a/...visualization/visualize_icp_iteration.gif → ...visualization/visualize_icp_iteration.gif b/...visualization/visualize_icp_iteration.gif → ...visualization/visualize_icp_iteration.gif
diff --git a/docs/_static/Basic/visualization/badview.png → ...c/visualization/visualization/badview.png b/docs/_static/Basic/visualization/badview.png → ...c/visualization/visualization/badview.png
diff --git a/docs/_static/Basic/visualization/color.png → ...tic/visualization/visualization/color.png b/docs/_static/Basic/visualization/color.png → ...tic/visualization/visualization/color.png
diff --git a/...atic/Basic/visualization/colormap_hot.png → ...ualization/visualization/colormap_hot.png b/...atic/Basic/visualization/colormap_hot.png → ...ualization/visualization/colormap_hot.png
diff --git a/...atic/Basic/visualization/colormap_jet.png → ...ualization/visualization/colormap_jet.png b/...atic/Basic/visualization/colormap_jet.png → ...ualization/visualization/colormap_jet.png
diff --git a/docs/_static/Basic/visualization/lineset.png → ...c/visualization/visualization/lineset.png b/docs/_static/Basic/visualization/lineset.png → ...c/visualization/visualization/lineset.png
diff --git a/docs/_static/Basic/visualization/newview.png → ...c/visualization/visualization/newview.png b/docs/_static/Basic/visualization/newview.png → ...c/visualization/visualization/newview.png
diff --git a/..._static/Basic/visualization/premitive.png → ...visualization/visualization/premitive.png b/..._static/Basic/visualization/premitive.png → ...visualization/visualization/premitive.png
diff --git a/docs/builddocs.rst b/docs/builddocs.rst
@@ -1,6 +1,6 @@
 .. _builddocs:
 
-Building documentation
+Build documentation
 ======================
 
 The main documentation and Python documentation is written in

diff --git a/docs/compilation.rst b/docs/compilation.rst
@@ -1,6 +1,6 @@
 .. _compilation:
 
-Compiling from source
+Build from source
 =====================
 
 You may want to build Open3D from source if you are developing Open3D, want to

diff --git a/docs/contribute/contribution_recipes.rst b/docs/contribute/contribution_recipes.rst
@@ -256,7 +256,7 @@ Case 3: When documenting pure Python code (no bindings)
 Case 4: When adding a Python tutorial
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-* Place your tutorial within Open3D/docs/tutorial/{Basic, Advanced}/
+* Place your tutorial within Open3D/docs/tutorial
 * There, create a new nblink file pointing to your ipynb notebook
 
   * e.g.: TutorialPointcloud.nblink

diff --git a/docs/cpp.rst → docs/cpp_api.rst b/docs/cpp.rst → docs/cpp_api.rst
diff --git a/docs/tutorial/C++/cplusplus_interface.rst → docs/cpp_project.rst b/docs/tutorial/C++/cplusplus_interface.rst → docs/cpp_project.rst
@@ -1,6 +1,6 @@
 .. _cplusplus_example_project:
 
-Building C++ projects with Open3D
+Build C++ projects with Open3D
 ---------------------------------
 
 This page explains how to create a CMake based C++ project using the Open3D C++ interface.

diff --git a/docs/index.rst b/docs/index.rst
@@ -18,44 +18,44 @@ Open3D: A Modern Library for 3D Data Processing
     Contents:
 
 .. toctree::
+    :maxdepth: 1
+    :caption: Getting Started
 
     introduction
     getting_started
     compilation
+    cpp_project
     builddocs
 
-.. _contribute_guide:
 
 .. toctree::
-    :maxdepth: 1
-    :caption: Contribute
-
-    contribute/contribute
-    contribute/contribution_recipes
-    contribute/styleguide
+    :maxdepth: 2
+    :caption: Tutorial
 
+    tutorial/geometry/index
+    tutorial/pipelines/index
+    tutorial/visualization/index
+    tutorial/core/index
+    tutorial/reconstruction_system/index
+    tutorial/sensor/index
+    tutorial/reference
 
-.. _tutorial_index:
 
 .. toctree::
     :maxdepth: 1
-    :caption: Tutorial
+    :caption: Contribute
 
-    tutorial/Basic/index
-    tutorial/Advanced/index
-    tutorial/ReconstructionSystem/index
-    tutorial/C++/cplusplus_interface
-    tutorial/reference
+    contribute/contribute
+    contribute/contribution_recipes
+    contribute/styleguide
 
-.. _cpp_api_index:
 
 .. toctree::
     :maxdepth: 1
     :caption: C++ API
 
-    cpp
+    cpp_api
 
-.. _python_api_index:
 
 .. Note: when adding new modules, please also update documented_modules.txt.
 

diff --git a/docs/introduction.rst b/docs/introduction.rst
@@ -1,3 +1,6 @@
 .. _introduction:
 
+Introduction
+~~~~~~~~~~~~
+
 .. mdinclude:: ../README.md
diff --git a/docs/make_docs.py b/docs/make_docs.py
@@ -65,21 +65,44 @@ class PyAPIDocsBuilder:
     ...
     """
 
-    def __init__(self, output_dir, input_dir, module_names):
+    def __init__(self, output_dir="python_api", input_dir="python_api_in"):
+        """
+        input_dir: The input dir for custom rst files that override the
+                   generated files.
+        """
         self.output_dir = output_dir
         self.input_dir = input_dir
-        self.module_names = module_names
+        self.module_names = PyAPIDocsBuilder._get_documented_module_names()
         print("Generating *.rst Python API docs in directory: %s" %
               self.output_dir)
 
     def generate_rst(self):
         _create_or_clear_dir(self.output_dir)
 
         for module_name in self.module_names:
-            module = self._get_open3d_module(module_name)
-            self._generate_module_class_function_docs(module_name, module)
+            try:
+                module = self._try_import_module(module_name)
+                self._generate_module_class_function_docs(module_name, module)
+            except:
+                print("[Warning] Module {} cannot be imported.".format(
+                    module_name))
 
-    def _get_open3d_module(self, full_module_name):
+    @staticmethod
+    def _get_documented_module_names():
+        """Reads the modules of the python api from the index.rst"""
+        module_names = []
+        with open("documented_modules.txt", "r") as f:
+            for line in f:
+                print(line, end="")
+                m = re.match("^(open3d\..*)\s*$", line)
+                if m:
+                    module_names.append(m.group(1))
+        print("Documented modules:")
+        for module_name in module_names:
+            print("-", module_name)
+        return module_names
+
+    def _try_import_module(self, full_module_name):
         """Returns the module object for the given module path"""
         import open3d  # make sure the root module is loaded
         if open3d._build_config['BUILD_TENSORFLOW_OPS']:
@@ -88,11 +111,11 @@ def _get_open3d_module(self, full_module_name):
             import open3d.ml.torch
 
         try:
-            # try to import directly. This will work for pure python submodules
+            # Try to import directly. This will work for pure python submodules
             module = importlib.import_module(full_module_name)
             return module
         except ImportError:
-            # traverse the module hierarchy of the root module.
+            # Traverse the module hierarchy of the root module.
             # This code path is necessary for modules for which we manually
             # define a specific module path (e.g. the modules defined with
             # pybind).
@@ -253,32 +276,10 @@ class SphinxDocsBuilder:
     """
 
     def __init__(self, html_output_dir, is_release, skip_notebooks):
-        # Get the modules for which we want to build the documentation.
-        # We use the modules listed in the index.rst file here.
-        self.documented_modules = self._get_documented_module_names()
-
-        self.python_api_output_dir = "python_api"
-        # The input dir for custom rst files that override the generated files
-        self.python_api_input_dir = "python_api_in"
         self.html_output_dir = html_output_dir
         self.is_release = is_release
         self.skip_notebooks = skip_notebooks
 
-    @staticmethod
-    def _get_documented_module_names():
-        """Reads the modules of the python api from the index.rst"""
-        module_names = []
-        with open("documented_modules.txt", "r") as f:
-            for line in f:
-                print(line)
-                m = re.match("^(open3d\..*)\s*$", line)
-                if m:
-                    module_names.append(m.group(1))
-        print("Documented modules:")
-        for module_name in module_names:
-            print("-", module_name)
-        return module_names
-
     def run(self):
         self._gen_python_api_docs()
         self._run_sphinx()
@@ -290,9 +291,7 @@ def _gen_python_api_docs(self):
         """
         # self.python_api_output_dir cannot be a temp dir, since other
         # "*.rst" files reference it
-        pd = PyAPIDocsBuilder(self.python_api_output_dir,
-                              self.python_api_input_dir,
-                              self.documented_modules)
+        pd = PyAPIDocsBuilder()
         pd.generate_rst()
 
     def _run_sphinx(self):
@@ -388,22 +387,27 @@ def run(self):
 
         # Copy and execute notebooks in the tutorial folder
         nb_paths = []
-        nb_ignored = ['tensor.ipynb']
-        example_dirs = ["Basic", "Advanced"]
+        nb_direct_copy = ['tensor.ipynb']
+        example_dirs = [
+            "geometry",
+            "core",
+            "pipelines",
+            "visualization",
+        ]
         for example_dir in example_dirs:
             in_dir = (Path(self.current_file_dir).parent / "examples" /
                       "python" / example_dir)
             out_dir = Path(self.current_file_dir) / "tutorial" / example_dir
+            out_dir.mkdir(parents=True, exist_ok=True)
             shutil.copy(
                 in_dir.parent / "open3d_tutorial.py",
                 out_dir.parent / "open3d_tutorial.py",
             )
 
             if self.clean_notebooks:
                 for nb_out_path in out_dir.glob("*.ipynb"):
-                    if (nb_out_path.name not in nb_ignored):
-                        print("Delete: {}".format(nb_out_path))
-                        nb_out_path.unlink()
+                    print("Delete: {}".format(nb_out_path))
+                    nb_out_path.unlink()
 
             for nb_in_path in in_dir.glob("*.ipynb"):
                 nb_out_path = out_dir / nb_in_path.name
@@ -416,6 +420,11 @@ def run(self):
 
         # Execute Jupyter notebooks
         for nb_path in nb_paths:
+            if nb_out_path.name in nb_direct_copy:
+                print("[Processing notebook {}, directly copied]".format(
+                    nb_path.name))
+                continue
+
             print("[Processing notebook {}]".format(nb_path.name))
             with open(nb_path, encoding="utf-8") as f:
                 nb = nbformat.read(f, as_version=4)

diff --git a/docs/tutorial/Advanced/example_projects.rst b/docs/tutorial/Advanced/example_projects.rst
diff --git a/docs/tutorial/Advanced/index.rst b/docs/tutorial/Advanced/index.rst
diff --git a/docs/tutorial/Basic/index.rst b/docs/tutorial/Basic/index.rst