diff --git a/docs/source/conf.py b/docs/source/conf.py index a23efabb..ee2dba3d 100644 --- 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 index 4f798216..7bb2785d 100644 --- 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 b/docs/source/installing.rst similarity index 82% rename from docs/source/building.rst rename to docs/source/installing.rst index 30017d2c..2171aadb 100644 --- a/docs/source/building.rst +++ b/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 `_ to find out +what MOLA version is available for your ROS distribution. + + +Compile from sources +------------------------ Get the sources -------------------