Documentation restructuring

cytopia · Jul 26, 2018 · acab8b3 · acab8b3
1 parent 0121371
commit acab8b3
Show file tree

Hide file tree

Showing 169 changed files with 2,210 additions and 864 deletions.
diff --git a/docs/Makefile b/docs/Makefile
@@ -53,4 +53,4 @@ build:
 	sphinx-build -a -E -n -j auto -q -W . _build/html
 
 autobuild:
-	sphinx-autobuild -E -n -j auto . _build/html
+	sphinx-autobuild . _build/html
diff --git a/docs/README.md b/docs/README.md
@@ -26,17 +26,15 @@ sudo pip install sphinx_rtd_theme
 #### How to build and error-check
 ```
 cd docs/
-sphinx-build -a -E -j auto -n -q . _build/html/
+make build
 ```
 
 #### How to build continuously
 ```
 cd docs/
-sphinx-autobuild . _build/html
+make autobuild
 ```
 
 #### How to view
 
-Open you browser on http://127.0.0.1:8000
-
-
+When using `make autobuild` your documentation is served at: http://127.0.0.1:8000
diff --git a/docs/_static/img/youtube-email-catch-all.png → ...figures/blogs/youtube-email-catch-all.png b/docs/_static/img/youtube-email-catch-all.png → ...figures/blogs/youtube-email-catch-all.png
diff --git a/docs/_includes/figures/blogs/youtube-email-catch-all.rst b/docs/_includes/figures/blogs/youtube-email-catch-all.rst
@@ -0,0 +1,2 @@
+.. figure:: /_includes/figures/blogs/youtube-email-catch-all.png
+   :target: https://www.youtube.com/watch?v=e-U-C5WhxGY
diff --git a/...static/img/youtube-setup-and-workflow.png → ...ures/blogs/youtube-setup-and-workflow.png b/...static/img/youtube-setup-and-workflow.png → ...ures/blogs/youtube-setup-and-workflow.png
diff --git a/docs/_includes/figures/blogs/youtube-setup-and-workflow.rst b/docs/_includes/figures/blogs/youtube-setup-and-workflow.rst
@@ -0,0 +1,2 @@
+.. figure:: /_includes/figures/blogs/youtube-setup-and-workflow.png
+   :target: https://www.youtube.com/watch?v=reyZMyt2Zzo
diff --git a/docs/_static/img/devilbox-dash-full.png → ...s/devilbox/devilbox-intranet-dash-all.png b/docs/_static/img/devilbox-dash-full.png → ...s/devilbox/devilbox-intranet-dash-all.png
diff --git a/docs/_includes/figures/devilbox/devilbox-intranet-dash-all.rst b/docs/_includes/figures/devilbox/devilbox-intranet-dash-all.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/devilbox/devilbox-intranet-dash-all.png
+
+   Devilbox intranet: index dash view for all started container
diff --git a/docs/_static/img/devilbox-dash-selective.png → ...lbox/devilbox-intranet-dash-selective.png b/docs/_static/img/devilbox-dash-selective.png → ...lbox/devilbox-intranet-dash-selective.png
diff --git a/docs/_includes/figures/devilbox/devilbox-intranet-dash-selective.rst b/docs/_includes/figures/devilbox/devilbox-intranet-dash-selective.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/devilbox/devilbox-intranet-dash-selective.png
+
+   Devilbox intranet: index dash view for some started container
diff --git a/docs/_static/img/devilbox-emails.png → ...res/devilbox/devilbox-intranet-emails.png b/docs/_static/img/devilbox-emails.png → ...res/devilbox/devilbox-intranet-emails.png
diff --git a/docs/_includes/figures/devilbox/devilbox-intranet-emails.rst b/docs/_includes/figures/devilbox/devilbox-intranet-emails.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/devilbox/devilbox-intranet-emails.png
+
+   Devilbox intranet: email catch-all overview
diff --git a/docs/_static/img/devilbox-index.png → ...ures/devilbox/devilbox-intranet-index.png b/docs/_static/img/devilbox-index.png → ...ures/devilbox/devilbox-intranet-index.png
diff --git a/docs/_includes/figures/devilbox/devilbox-intranet-index.rst b/docs/_includes/figures/devilbox/devilbox-intranet-index.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/devilbox/devilbox-intranet-index.png
+
+   Devilbox intranet: homepage
diff --git a/docs/_static/img/devilbox-database.png → ...box/devilbox-intranet-mysql-databases.png b/docs/_static/img/devilbox-database.png → ...box/devilbox-intranet-mysql-databases.png
diff --git a/docs/_includes/figures/devilbox/devilbox-intranet-mysql-databases.rst b/docs/_includes/figures/devilbox/devilbox-intranet-mysql-databases.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/devilbox/devilbox-intranet-mysql-databases.png
+
+   Devilbox intranet: MySQL database overview
diff --git a/docs/_static/img/devilbox-info-mysql.png → ...devilbox/devilbox-intranet-mysql-info.png b/docs/_static/img/devilbox-info-mysql.png → ...devilbox/devilbox-intranet-mysql-info.png
diff --git a/docs/_includes/figures/devilbox/devilbox-intranet-mysql-info.rst b/docs/_includes/figures/devilbox/devilbox-intranet-mysql-info.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/devilbox/devilbox-intranet-mysql-info.png
+
+   Devilbox intranet: MySQL info overview
diff --git a/docs/_static/img/devilbox-info-php.png → ...s/devilbox/devilbox-intranet-php-info.png b/docs/_static/img/devilbox-info-php.png → ...s/devilbox/devilbox-intranet-php-info.png
diff --git a/docs/_includes/figures/devilbox/devilbox-intranet-php-info.rst b/docs/_includes/figures/devilbox/devilbox-intranet-php-info.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/devilbox/devilbox-intranet-php-info.png
+
+   Devilbox intranet: php info
diff --git a/docs/_static/img/devilbox-vhosts-empty.png → ...vilbox/devilbox-intranet-vhosts-empty.png b/docs/_static/img/devilbox-vhosts-empty.png → ...vilbox/devilbox-intranet-vhosts-empty.png
diff --git a/docs/_includes/figures/devilbox/devilbox-intranet-vhosts-empty.rst b/docs/_includes/figures/devilbox/devilbox-intranet-vhosts-empty.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/devilbox/devilbox-intranet-vhosts-empty.png
+
+   Devilbox intranet: no projects created
diff --git a/docs/_static/img/devilbox-vhosts-dns.png → .../devilbox-intranet-vhosts-missing-dns.png b/docs/_static/img/devilbox-vhosts-dns.png → .../devilbox-intranet-vhosts-missing-dns.png
diff --git a/docs/_includes/figures/devilbox/devilbox-intranet-vhosts-missing-dns.rst b/docs/_includes/figures/devilbox/devilbox-intranet-vhosts-missing-dns.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/devilbox/devilbox-intranet-vhosts-missing-dns.png
+
+   Devilbox intranet: misssing dns record
diff --git a/..._static/img/devilbox-vhosts-directory.png → ...vilbox-intranet-vhosts-missing-htdocs.png b/..._static/img/devilbox-vhosts-directory.png → ...vilbox-intranet-vhosts-missing-htdocs.png
diff --git a/docs/_includes/figures/devilbox/devilbox-intranet-vhosts-missing-htdocs.rst b/docs/_includes/figures/devilbox/devilbox-intranet-vhosts-missing-htdocs.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/devilbox/devilbox-intranet-vhosts-missing-htdocs.png
+
+   Devilbox intranet: misssing ``htdocs`` directory
diff --git a/.../_static/img/devilbox-vhosts-finished.png → ...lbox/devilbox-intranet-vhosts-working.png b/.../_static/img/devilbox-vhosts-finished.png → ...lbox/devilbox-intranet-vhosts-working.png
diff --git a/docs/_includes/figures/devilbox/devilbox-intranet-vhosts-working.rst b/docs/_includes/figures/devilbox/devilbox-intranet-vhosts-working.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/devilbox/devilbox-intranet-vhosts-working.png
+
+   Devilbox intranet: vhost setup successfully
diff --git a/docs/_static/img/devilbox-vhosts.png → ...res/devilbox/devilbox-intranet-vhosts.png b/docs/_static/img/devilbox-vhosts.png → ...res/devilbox/devilbox-intranet-vhosts.png
diff --git a/docs/_includes/figures/devilbox/devilbox-intranet-vhosts.rst b/docs/_includes/figures/devilbox/devilbox-intranet-vhosts.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/devilbox/devilbox-intranet-vhosts.png
+
+   Devilbox intranet: available virtual hosts
diff --git a/...atic/img/devilbox-project-hello-world.png → ...devilbox/devilbox-project-hello-world.png b/...atic/img/devilbox-project-hello-world.png → ...devilbox/devilbox-project-hello-world.png
diff --git a/docs/_includes/figures/devilbox/devilbox-project-hello-world.rst b/docs/_includes/figures/devilbox/devilbox-project-hello-world.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/devilbox/devilbox-project-hello-world.png
+
+   Devilbox project: hello world on ``index.php``
diff --git a/..._static/img/devilbox-project-no-files.png → ...vilbox/devilbox-project-missing-index.png b/..._static/img/devilbox-project-no-files.png → ...vilbox/devilbox-project-missing-index.png
diff --git a/docs/_includes/figures/devilbox/devilbox-project-missing-index.rst b/docs/_includes/figures/devilbox/devilbox-project-missing-index.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/devilbox/devilbox-project-missing-index.png
+
+   Devilbox project: misssing ``index.php`` or ``index.html``
diff --git a/docs/_static/img/auto-dns-macos-dns.png → ...udes/figures/dns/mac-network-settings.png b/docs/_static/img/auto-dns-macos-dns.png → ...udes/figures/dns/mac-network-settings.png
diff --git a/docs/_includes/figures/dns/mac-network-settings.rst b/docs/_includes/figures/dns/mac-network-settings.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/dns/mac-network-settings.png
+
+   MacOS: network settings
diff --git a/docs/_static/img/auto-dns-windows-dns-02.jpg → ...s/figures/dns/win-ethernet-properties.png b/docs/_static/img/auto-dns-windows-dns-02.jpg → ...s/figures/dns/win-ethernet-properties.png
diff --git a/docs/_includes/figures/dns/win-ethernet-properties.rst b/docs/_includes/figures/dns/win-ethernet-properties.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/dns/win-ethernet-properties.png
+
+   Windows: ethernet properties
diff --git a/docs/_static/img/auto-dns-windows-dns-03.jpg → .../dns/win-internet-protocol-properties.png b/docs/_static/img/auto-dns-windows-dns-03.jpg → .../dns/win-internet-protocol-properties.png
diff --git a/docs/_includes/figures/dns/win-internet-protocol-properties.rst b/docs/_includes/figures/dns/win-internet-protocol-properties.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/dns/win-internet-protocol-properties.png
+
+   Windows: internet protocol properties
diff --git a/docs/_static/img/auto-dns-windows-dns-01.jpg → ...s/figures/dns/win-network-connections.png b/docs/_static/img/auto-dns-windows-dns-01.jpg → ...s/figures/dns/win-network-connections.png
diff --git a/docs/_includes/figures/dns/win-network-connections.rst b/docs/_includes/figures/dns/win-network-connections.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/dns/win-network-connections.png
+
+   Windows: network connections
diff --git a/...https-ssl-02-chrome-advanced-settings.png → ...igures/https/chrome-advanced-settings.png b/...https-ssl-02-chrome-advanced-settings.png → ...igures/https/chrome-advanced-settings.png
diff --git a/docs/_includes/figures/https/chrome-advanced-settings.rst b/docs/_includes/figures/https/chrome-advanced-settings.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/https/chrome-advanced-settings.png
+
+   Click on ``Manage certificates``
diff --git a/...ation/https-ssl-03-chrome-authorities.png → ...ures/https/chrome-manage-certificates.png b/...ation/https-ssl-03-chrome-authorities.png → ...ures/https/chrome-manage-certificates.png
diff --git a/docs/_includes/figures/https/chrome-manage-certificates.rst b/docs/_includes/figures/https/chrome-manage-certificates.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/https/chrome-manage-certificates.png
+
+   Click on ``IMPORT`` in the AUTHORITIES tab
diff --git a/...uration/https-ssl-05-chrome-set-trust.png → ...cludes/figures/https/chrome-set-trust.png b/...uration/https-ssl-05-chrome-set-trust.png → ...cludes/figures/https/chrome-set-trust.png
diff --git a/docs/_includes/figures/https/chrome-set-trust.rst b/docs/_includes/figures/https/chrome-set-trust.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/https/chrome-set-trust.png
+
+   Tell Chrome to trust this CA
diff --git a/...guration/https-ssl-01-chrome-settings.png → ...ncludes/figures/https/chrome-settings.png b/...guration/https-ssl-01-chrome-settings.png → ...ncludes/figures/https/chrome-settings.png
diff --git a/docs/_includes/figures/https/chrome-settings.rst b/docs/_includes/figures/https/chrome-settings.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/https/chrome-settings.png
+
+   Click on ``Advanced``
diff --git a/...bal-configuration/https-ssl-04-import.png → .../figures/https/file-manager-import-ca.png b/...bal-configuration/https-ssl-04-import.png → .../figures/https/file-manager-import-ca.png
diff --git a/docs/_includes/figures/https/file-manager-import-ca.rst b/docs/_includes/figures/https/file-manager-import-ca.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/https/file-manager-import-ca.png
+
+   **Note**: your file manager might look different
diff --git a/...tion/https-ssl-03-firefox-authorities.png → ...res/https/firefox-certificate-manager.png b/...tion/https-ssl-03-firefox-authorities.png → ...res/https/firefox-certificate-manager.png
diff --git a/docs/_includes/figures/https/firefox-certificate-manager.rst b/docs/_includes/figures/https/firefox-certificate-manager.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/https/firefox-certificate-manager.png
+
+   Click on ``Import`` in the Authorities tab
diff --git a/...uration/https-ssl-01-firefox-settings.png → ...des/figures/https/firefox-preferences.png b/...uration/https-ssl-01-firefox-settings.png → ...des/figures/https/firefox-preferences.png
diff --git a/docs/_includes/figures/https/firefox-preferences.rst b/docs/_includes/figures/https/firefox-preferences.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/https/firefox-preferences.png
+
+   Click on ``Privacy & Security`` in the left menu bar
diff --git a/...ttps-ssl-02-firefox-security-settings.png → ...es/https/firefox-privacy-and-security.png b/...ttps-ssl-02-firefox-security-settings.png → ...es/https/firefox-privacy-and-security.png
diff --git a/docs/_includes/figures/https/firefox-privacy-and-security.rst b/docs/_includes/figures/https/firefox-privacy-and-security.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/https/firefox-privacy-and-security.png
+
+   Click on ``View Certificates``
diff --git a/...ration/https-ssl-05-firefox-set-trust.png → ...ludes/figures/https/firefox-set-trust.png b/...ration/https-ssl-05-firefox-set-trust.png → ...ludes/figures/https/firefox-set-trust.png
diff --git a/docs/_includes/figures/https/firefox-set-trust.rst b/docs/_includes/figures/https/firefox-set-trust.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/https/firefox-set-trust.png
+
+   Tell Firefox to trust this CA
diff --git a/...l-configuration/https-ssl-address-bar.png → ...s/figures/https/https-ssl-address-bar.png b/...l-configuration/https-ssl-address-bar.png → ...s/figures/https/https-ssl-address-bar.png
diff --git a/docs/_includes/figures/https/https-ssl-address-bar.rst b/docs/_includes/figures/https/https-ssl-address-bar.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/https/https-ssl-address-bar.png
+
+   Valid HTTPS will automatically be available for all projects
diff --git a/..._includes/figures/terminal/docker-toolbox-terminal-mac-quickstart-launchpad.png b/..._includes/figures/terminal/docker-toolbox-terminal-mac-quickstart-launchpad.png
diff --git a/..._includes/figures/terminal/docker-toolbox-terminal-mac-quickstart-launchpad.rst b/..._includes/figures/terminal/docker-toolbox-terminal-mac-quickstart-launchpad.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/terminal/docker-toolbox-terminal-mac-quickstart-launchpad.png
+
+   Copyright docs.docker.com
diff --git a/.../_includes/figures/terminal/docker-toolbox-terminal-win-quickstart-shortcut.png b/.../_includes/figures/terminal/docker-toolbox-terminal-win-quickstart-shortcut.png
diff --git a/.../_includes/figures/terminal/docker-toolbox-terminal-win-quickstart-shortcut.rst b/.../_includes/figures/terminal/docker-toolbox-terminal-win-quickstart-shortcut.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/terminal/docker-toolbox-terminal-win-quickstart-shortcut.png
+
+   Copyright docs.docker.com
diff --git a/.../_includes/figures/terminal/docker-toolbox-terminal-win-quickstart-terminal.png b/.../_includes/figures/terminal/docker-toolbox-terminal-win-quickstart-terminal.png
diff --git a/.../_includes/figures/terminal/docker-toolbox-terminal-win-quickstart-terminal.rst b/.../_includes/figures/terminal/docker-toolbox-terminal-win-quickstart-terminal.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/terminal/docker-toolbox-terminal-win-quickstart-terminal.png
+
+   Copyright docs.docker.com
diff --git a/...c/img/tutorials/xdebug_phpstorm_proxy.png → ...es/figures/xdebug/phpstorm-dbgp-proxy.png b/...c/img/tutorials/xdebug_phpstorm_proxy.png → ...es/figures/xdebug/phpstorm-dbgp-proxy.png
diff --git a/docs/_includes/figures/xdebug/phpstorm-dbgp-proxy.rst b/docs/_includes/figures/xdebug/phpstorm-dbgp-proxy.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/xdebug/phpstorm-dbgp-proxy.png
+
+   PHPStorm settings: DBGp Proxy
diff --git a/...utorials/xdebug_phpstorm_path_mapping.png → .../figures/xdebug/phpstorm-path-mapping.png b/...utorials/xdebug_phpstorm_path_mapping.png → .../figures/xdebug/phpstorm-path-mapping.png
diff --git a/docs/_includes/figures/xdebug/phpstorm-path-mapping.rst b/docs/_includes/figures/xdebug/phpstorm-path-mapping.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/xdebug/phpstorm-path-mapping.png
+
+   PHPStorm settings: path mapping
diff --git a/...mg/tutorials/xdebug_phpstorm_settings.png → ...udes/figures/xdebug/phpstorm-settings.png b/...mg/tutorials/xdebug_phpstorm_settings.png → ...udes/figures/xdebug/phpstorm-settings.png
diff --git a/docs/_includes/figures/xdebug/phpstorm-settings.rst b/docs/_includes/figures/xdebug/phpstorm-settings.rst
@@ -0,0 +1,3 @@
+.. figure:: /_includes/figures/xdebug/phpstorm-settings.png
+
+   PHPStorm settings: Xdebug
diff --git a/docs/_includes/global/images.rst b/docs/_includes/global/images.rst
@@ -0,0 +1,5 @@
+.. |img_logo_lin| image:: https://raw.githubusercontent.com/cytopia/icons/master/64x64/linux.png
+.. |img_logo_mac| image:: https://raw.githubusercontent.com/cytopia/icons/master/64x64/mac.png
+.. |img_logo_win| image:: https://raw.githubusercontent.com/cytopia/icons/master/64x64/windows.png
+
+.. |img_banner| image:: /img/banner.png
diff --git a/docs/_includes/global/links.rst b/docs/_includes/global/links.rst
@@ -0,0 +1,157 @@
+..
+   ============================================================
+   Docker
+   ============================================================
+
+.. |ext_lnk_install_docker| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/install/">
+     Install Docker <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_link_docker_machine| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/machine/overview/">
+     Docker Machine <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+..
+   ============================================================
+   Docker for Linux
+   ============================================================
+
+.. |ext_lnk_install_docker_centos| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/install/linux/docker-ce/centos/">
+     Get Docker CE for CentOS <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_install_docker_debian| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/install/linux/docker-ce/debian/">
+     Get Docker CE for Debian <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_install_docker_fedora| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/install/linux/docker-ce/fedora/">
+     Get Docker CE for Fedora <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_install_docker_ubuntu| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/install/linux/docker-ce/ubuntu/">
+     Get Docker CE for Ubuntu <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_install_docker_linux_post_steps| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/install/linux/linux-postinstall/">
+     Post-installation steps for Linux <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+
+..
+   ============================================================
+   Docker for Mac
+   ============================================================
+
+.. |ext_lnk_install_docker_mac| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/docker-for-mac/install/">
+     Install Docker for Mac <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_install_docker_mac_get_started| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/docker-for-mac/">
+     Get started with Docker for Mac <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_install_docker_toolbox_mac| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/toolbox/toolbox_install_mac/">
+     Install Docker Toolbox on macOS <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_install_docker_toolbox_mac_native_vs_toolbox| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/docker-for-mac/docker-toolbox/">
+     Docker for Mac vs. Docker Toolbox <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_install_docker_toolbox_mac_shared_directory| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/toolbox/toolbox_install_mac/#optional-add-shared-directories">
+     Docker Toolbox on Mac: add shared directories <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+
+..
+   ============================================================
+   Docker for Windows
+   ============================================================
+
+.. |ext_lnk_install_docker_win| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/docker-for-windows/install/">
+     Install Docker for Windows <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_install_docker_win_get_started| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/docker-for-windows/">
+     Get started with Docker for Windows <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_install_docker_toolbox_win| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/toolbox/toolbox_install_windows/">
+     Install Docker Toolbox on Windows <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_install_docker_toolbox_win_shared_directory| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/toolbox/toolbox_install_windows/#optional-add-shared-directories">
+     Docker Toolbox on Windows: add shared directories <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+
+..
+   ============================================================
+   Docker Compose
+   ============================================================
+
+.. |ext_lnk_install_docker_compose| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/compose/install/">
+     Install Docker Compose <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_docker_cmpose_cmd_reference| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/compose/reference/">
+     Compose command-line reference <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_docker_cmpose_env_file| raw:: html
+
+   <a target="_blank" href="https://docs.docker.com/compose/env-file/">
+     Declare default environment variables in file <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+
+..
+   ============================================================
+   Misc
+   ============================================================
+
+.. -------------------- uid --------------------
+
+.. |ext_lnk_uid| raw:: html
+
+   <a target="_blank" href="https://en.wikipedia.org/wiki/User_identifier">
+     Wikipedia: uid <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+
diff --git a/docs/_static/css/custom.css → docs/_static/css/devilbox.css b/docs/_static/css/custom.css → docs/_static/css/devilbox.css
@@ -1,3 +1,7 @@
+/************************************************************
+ * MENU
+ ***********************************************************/
+
 /* overwrite logo dimensions */
 .wy-side-nav-search>a img.logo,
 .wy-side-nav-search .wy-dropdown>a img.logo {
@@ -9,6 +13,21 @@
 	background-color: #343131;
 }
 
+/* sidebar category headlines */
+.wy-menu-vertical header, .wy-menu-vertical p.caption {
+	margin-top: 25px;
+	margin-bottom: 15px;
+	padding: 0 1.518em;
+	padding-top:10px;
+	border-top: 1px solid #9b9b9b;
+	font-size: 100%;
+}
+
+
+/************************************************************
+ * Code blocks
+ ***********************************************************/
+
 /* Disable annoying scrollbar in code-blocks */
 .codeblock,
 pre.literal-block,