update build instructions

MOLAorg · Jan 9, 2024 · 975faf7 · 975faf7
1 parent df792f8
commit 975faf7
Show file tree

Hide file tree

Showing 3 changed files with 31 additions and 6 deletions.
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -39,11 +39,17 @@
 # ones.
 extensions = [
     'sphinx.ext.mathjax',
-    'sphinx.ext.ifconfig'
+    'sphinx.ext.ifconfig',
+    'sphinx.ext.mathjax',
+    'sphinx_design',
+    'sphinx.ext.autosectionlabel',
+    'sphinxcontrib.bibtex',
 ]
 
 extensions += ['doxyrest', 'cpplexer']
 
+bibtex_bibfiles = ['refs.bib']
+
 # Show build time
 html_last_updated_fmt = '%H:%M, %b %d, %Y'
 

diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -10,7 +10,7 @@ MOLA
   :hidden:
   :caption: Quickstart
 
-  building
+  installing
   demos
 
 .. toctree::

diff --git a/docs/source/building.rst → docs/source/installing.rst b/docs/source/building.rst → docs/source/installing.rst
@@ -1,11 +1,30 @@
-.. _building:
+.. _installing:
 
 ======================
-Building
+Installing
 ======================
 
-1. First-time build
-====================
+.. contents:: :local:
+
+
+From ROS 2 repositories
+------------------------
+
+**Recommended**: This is the easiest way to install MOLA.
+
+In Debian/Ubuntu systems, activate your ROS environment (``setup.bash``) if not done automatically 
+in your ``~./bashrc`` file, then just run:
+
+.. code-block:: bash
+
+    sudo apt install ros-$ROS_DISTRO-mola
+
+Check the `build status table <https://github.com/MOLAorg/mola#build-matrix-status>`_ to find out
+what MOLA version is available for your ROS distribution.
+
+
+Compile from sources
+------------------------
 
 Get the sources
 -------------------