Improve documentation (#6307)

* Add install with upgrade option when installing latest development package.
* util/install-deps-python.sh was removed in #2146
* Grammar fix.
* Move open3d_ml and arm to after docker.
* organize TOC - Move C++ and Contribution to end and keep python section together.
* Fix sphinx warnings (Title underline too short).
* Fix extra heading drop when going one level down.
* Fix cross reference links
* Add files/directories to ignore for sphinx, reduces inconsistency warnings.
* Fix `Unknown directive type "code_block"` warning.
* Add uvmaps to official docs, fix - `WARNING: document isn't included in any toctree`.
* Fix yaml lexer name - See https://pygments.org/languages/
* Fix warnings - `Inline substitution_reference start-string without end-string.`
* Only copy open3d_tutorial.py once
* Move list of classes to a global variable
* Use f-strings as requested in PR
* Add python_api_in as ignored directory.
* Fix pybind docs with literal block for tree output
* Fix doxygen docs with code block for tree outpu
* Correct class names in doxygen docs for RedWood dataset

cpp/open3d/data/Dataset.h

@@ -723,26 +723,26 @@ class PaintedPlasterTexture : public DownloadDataset {
 /// cloud, rgb sequence, clean depth sequence, noisy depth sequence, oni
 /// sequence, and ground-truth camera trajectory.
 ///
-/// RedwoodIndoorLivingRoom1
-/// ├── colors
-/// │   ├── 00000.jpg
-/// │   ├── 00001.jpg
-/// │   ├── ...
-/// │   └── 02869.jpg
-/// ├── depth
-/// │   ├── 00000.png
-/// │   ├── 00001.png
-/// │   ├── ...
-/// │   └── 02869.png
-/// ├── depth_noisy
-/// │   ├── 00000.png
-/// │   ├── 00001.png
-/// │   ├── ...
-/// │   └── 02869.png
-/// ├── dist-model.txt
-/// ├── livingroom1.oni
-/// ├── livingroom1-traj.txt
-/// └── livingroom.ply
+///     RedwoodIndoorLivingRoom1
+///     ├── colors
+///     │   ├── 00000.jpg
+///     │   ├── 00001.jpg
+///     │   ├── ...
+///     │   └── 02869.jpg
+///     ├── depth
+///     │   ├── 00000.png
+///     │   ├── 00001.png
+///     │   ├── ...
+///     │   └── 02869.png
+///     ├── depth_noisy
+///     │   ├── 00000.png
+///     │   ├── 00001.png
+///     │   ├── ...
+///     │   └── 02869.png
+///     ├── dist-model.txt
+///     ├── livingroom1.oni
+///     ├── livingroom1-traj.txt
+///     └── livingroom.ply
 class RedwoodIndoorLivingRoom1 : public DownloadDataset {
 public:
     RedwoodIndoorLivingRoom1(const std::string& data_root = "");
@@ -775,30 +775,30 @@ class RedwoodIndoorLivingRoom1 : public DownloadDataset {
 };
 
 /// \class RedwoodIndoorLivingRoom2 (Augmented ICL-NUIM Dataset)
-/// \brief Data class for `RedwoodIndoorLivingRoom1`, containing dense point
+/// \brief Data class for `RedwoodIndoorLivingRoom2`, containing dense point
 /// cloud, rgb sequence, clean depth sequence, noisy depth sequence, oni
 /// sequence, and ground-truth camera trajectory.
 ///
-/// RedwoodIndoorLivingRoom2
-/// ├── colors
-/// │   ├── 00000.jpg
-/// │   ├── 00001.jpg
-/// │   ├── ...
-/// │   └── 02349.jpg
-/// ├── depth
-/// │   ├── 00000.png
-/// │   ├── 00001.png
-/// │   ├── ...
-/// │   └── 02349.png
-/// ├── depth_noisy
-/// │   ├── 00000.png
-/// │   ├── 00001.png
-/// │   ├── ...
-/// │   └── 02349.png
-/// ├── dist-model.txt
-/// ├── livingroom2.oni
-/// ├── livingroom2-traj.txt
-/// └── livingroom.ply
+///     RedwoodIndoorLivingRoom2
+///     ├── colors
+///     │   ├── 00000.jpg
+///     │   ├── 00001.jpg
+///     │   ├── ...
+///     │   └── 02349.jpg
+///     ├── depth
+///     │   ├── 00000.png
+///     │   ├── 00001.png
+///     │   ├── ...
+///     │   └── 02349.png
+///     ├── depth_noisy
+///     │   ├── 00000.png
+///     │   ├── 00001.png
+///     │   ├── ...
+///     │   └── 02349.png
+///     ├── dist-model.txt
+///     ├── livingroom2.oni
+///     ├── livingroom2-traj.txt
+///     └── livingroom.ply
 class RedwoodIndoorLivingRoom2 : public DownloadDataset {
 public:
     RedwoodIndoorLivingRoom2(const std::string& data_root = "");
@@ -831,30 +831,30 @@ class RedwoodIndoorLivingRoom2 : public DownloadDataset {
 };
 
 /// \class RedwoodIndoorOffice1 (Augmented ICL-NUIM Dataset)
-/// \brief Data class for `RedwoodIndoorLivingRoom1`, containing dense point
+/// \brief Data class for `RedwoodIndoorOffice1`, containing dense point
 /// cloud, rgb sequence, clean depth sequence, noisy depth sequence, oni
 /// sequence, and ground-truth camera trajectory.
 ///
-/// RedwoodIndoorOffice1
-/// ├── colors
-/// │   ├── 00000.jpg
-/// │   ├── 00001.jpg
-/// │   ├── ...
-/// │   └── 02689.jpg
-/// ├── depth
-/// │   ├── 00000.png
-/// │   ├── 00001.png
-/// │   ├── ...
-/// │   └── 02689.png
-/// ├── depth_noisy
-/// │   ├── 00000.png
-/// │   ├── 00001.png
-/// │   ├── ...
-/// │   └── 02689.png
-/// ├── dist-model.txt
-/// ├── office1.oni
-/// ├── office1-traj.txt
-/// └── office.ply
+///     RedwoodIndoorOffice1
+///     ├── colors
+///     │   ├── 00000.jpg
+///     │   ├── 00001.jpg
+///     │   ├── ...
+///     │   └── 02689.jpg
+///     ├── depth
+///     │   ├── 00000.png
+///     │   ├── 00001.png
+///     │   ├── ...
+///     │   └── 02689.png
+///     ├── depth_noisy
+///     │   ├── 00000.png
+///     │   ├── 00001.png
+///     │   ├── ...
+///     │   └── 02689.png
+///     ├── dist-model.txt
+///     ├── office1.oni
+///     ├── office1-traj.txt
+///     └── office.ply
 class RedwoodIndoorOffice1 : public DownloadDataset {
 public:
     RedwoodIndoorOffice1(const std::string& data_root = "");
@@ -887,30 +887,30 @@ class RedwoodIndoorOffice1 : public DownloadDataset {
 };
 
 /// \class RedwoodIndoorOffice2 (Augmented ICL-NUIM Dataset)
-/// \brief Data class for `RedwoodIndoorLivingRoom1`, containing dense point
+/// \brief Data class for `RedwoodIndoorOffice2`, containing dense point
 /// cloud, rgb sequence, clean depth sequence, noisy depth sequence, oni
 /// sequence, and ground-truth camera trajectory.
 ///
-/// RedwoodIndoorOffice2
-/// ├── colors
-/// │   ├── 00000.jpg
-/// │   ├── 00001.jpg
-/// │   ├── ...
-/// │   └── 02537.jpg
-/// ├── depth
-/// │   ├── 00000.png
-/// │   ├── 00001.png
-/// │   ├── ...
-/// │   └── 02537.png
-/// ├── depth_noisy
-/// │   ├── 00000.png
-/// │   ├── 00001.png
-/// │   ├── ...
-/// │   └── 02537.png
-/// ├── dist-model.txt
-/// ├── office2.oni
-/// ├── office2-traj.txt
-/// └── office.ply
+///     RedwoodIndoorOffice2
+///     ├── colors
+///     │   ├── 00000.jpg
+///     │   ├── 00001.jpg
+///     │   ├── ...
+///     │   └── 02537.jpg
+///     ├── depth
+///     │   ├── 00000.png
+///     │   ├── 00001.png
+///     │   ├── ...
+///     │   └── 02537.png
+///     ├── depth_noisy
+///     │   ├── 00000.png
+///     │   ├── 00001.png
+///     │   ├── ...
+///     │   └── 02537.png
+///     ├── dist-model.txt
+///     ├── office2.oni
+///     ├── office2-traj.txt
+///     └── office.ply
 class RedwoodIndoorOffice2 : public DownloadDataset {
 public:
     RedwoodIndoorOffice2(const std::string& data_root = "");