[IMP] contributing/doc, install: add an extension for content tabs

In many places in the docs, we need to document several flows that
differ only by a few details. For example, the steps to install Odoo
from the sources are almost identical for Windows, Linux, and Mac OS.
In other places, we'd want to suggest a command in different
environments or programming languages, etc.

This commit thus adds an extension for content tabs (tabs within the
content) to help reduce content repetition in the documentation. As a
proof of concept, the "Packaged installers" and "Source install"
sections of the "Installing Odoo" page are reworked to present their
content within tabs whenever it helps clarify the instructions.

A new python dependency is added as of this commit: `sphinx-tabs`

task-2713983

closes odoo/documentation#1528

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Co-authored-by: Lucie Van Nieuwenhuyse (luvn) <luvn@odoo.com>

This commit is contained in:

Antoine Vandevenne (anv)

2021-12-17 14:06:56 +00:00

parent b71cf50f9e

commit cf6ca0fbb2

6 changed files with 642 additions and 519 deletions

									
										content/developer/howtos/rdtraining/02_setup.rst
									
		+1
		-1
	
												View File
												
				@@ -184,7 +184,7 @@ You can check your Python version with:

				Install required packages

				-------------------------

				See :ref:`install/python-dependencies`

				See :ref:`install/dependencies`.

				.. _howto/rdtraining/02_setup/install-wkhtmltopdf: