Documentation: replace external links

docs/_includes/links/examples.rst

@@ -0,0 +1,83 @@
+.. |ext_lnk_example_cakephp_documentation| raw:: html
+
+   <a target="_blank" href="https://book.cakephp.org/3.0/en/installation.html">
+     Official CakePHP Documentation <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_example_codeignitor_documentation| raw:: html
+
+   <a target="_blank" href="https://www.codeigniter.com/user_guide/installation/index.html">
+     Official CodeIgniter Documentation <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_example_drupal_documentation| raw:: html
+
+   <a target="_blank" href="https://www.drupal.org/docs/7/install">
+     Official Drupal Documentation <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_example_joomla_documentation| raw:: html
+
+   <a target="_blank" href="https://docs.joomla.org/J3.x:Installing_Joomla">
+     Official Joomla Documentation <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_example_laravel_documentation| raw:: html
+
+   <a target="_blank" href="https://laravel.com/docs/5.4/installation">
+     Official Laravel Documentation <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_example_phalcon_documentation| raw:: html
+
+   <a target="_blank" href="https://docs.phalconphp.com/en/3.2/devtools-usage">
+     Official Phalcon Documentation  <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_example_photon_cms| raw:: html
+
+   <a target="_blank" href="https://photoncms.com/resources/installing">
+     Official Photon CMS Documentation <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_example_shopware_documentation| raw:: html
+
+   <a target="_blank" href="https://en-community.shopware.com/Shopware-5-Installer_detail_1351_730.html/sCoreId,bdd630e6d079964f3f697fccff83a987">
+     Official Shopware Documentation <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_example_shopware_github| raw:: html
+
+   <a target="_blank" href="https://github.com/shopware/shopware">
+     Shopware Github repository <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_example_symfony_documentation| raw:: html
+
+   <a target="_blank" href="https://symfony.com/doc/current/setup.html">
+     Official Symfony Documentation <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_example_typo3_documentation| raw:: html
+
+   <a target="_blank" href="https://docs.typo3.org/typo3cms/InstallationGuide/Index.html">
+     Official Typo3 Documentation <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_example_wordpress_documentation| raw:: html
+
+   <a target="_blank" href="https://codex.wordpress.org/Installing_WordPress">
+     Official Wordpress Documentation <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_example_yii_documentation| raw:: html
+
+   <a target="_blank" href="https://www.yiiframework.com/doc/guide/2.0/en/start-installation">
+     Official Yii Documentation <img src="/_static/img/icons/ext-link.svg" />
+   </a>
+
+.. |ext_lnk_example_zend_documentation| raw:: html
+
+   <a target="_blank" href="https://docs.zendframework.com/tutorials/getting-started/skeleton-application">
+     Official Zend Documentation <img src="/_static/img/icons/ext-link.svg" />
+   </a>

docs/examples/setup-cakephp.rst

@@ -1,3 +1,5 @@
+.. include:: /_includes/all.rst
+
 .. _example_setup_cakephp:
 
 *************
@@ -6,7 +8,7 @@ Setup CakePHP
 
 This example will use ``composer`` to install CakePHP from within the PHP container.
 
-.. seealso:: `Official CakePHP Documentation <https://book.cakephp.org/3.0/en/installation.html>`_
+.. seealso:: |ext_lnk_example_cakephp_documentation|
 
 
 **Table of Contents**

docs/examples/setup-codeigniter.rst

@@ -1,11 +1,12 @@
+.. include:: /_includes/all.rst
+
 .. _example_setup_codeigniter:
 
 *****************
 Setup CodeIgniter
 *****************
 
-
+.. seealso:: |ext_lnk_example_codeignitor_documentation|
-.. seealso:: `Official CodeIgniter Documentation <https://www.codeigniter.com/user_guide/installation/index.html>`_
 
 
 **Table of Contents**

docs/examples/setup-drupal.rst

@@ -1,3 +1,5 @@
+.. include:: /_includes/all.rst
+
 .. _example_setup_drupal:
 
 ************
@@ -6,7 +8,7 @@ Setup Drupal
 
 This example will use ``drush`` to install Drupal from within the PHP container.
 
-.. seealso:: `Official Drupal Documentation <https://www.drupal.org/docs/7/install>`_
+.. seealso:: |ext_lnk_example_drupal_documentation|
 
 
 **Table of Contents**

docs/examples/setup-joomla.rst

@@ -1,3 +1,5 @@
+.. include:: /_includes/all.rst
+
 .. _example_setup_joomla:
 
 ************
@@ -6,7 +8,7 @@ Setup Joomla
 
 This example will install Joomla from within the PHP container.
 
-.. seealso:: `Official Joomla Documentation <https://docs.joomla.org/J3.x:Installing_Joomla>`_
+.. seealso:: |ext_lnk_example_joomla_documentation|
 
 
 **Table of Contents**

docs/examples/setup-laravel.rst

@@ -1,3 +1,5 @@
+.. include:: /_includes/all.rst
+
 .. _example_setup_laravel:
 
 *************
@@ -6,7 +8,7 @@ Setup Laravel
 
 This example will use ``laravel`` to install Laravel from within the PHP container.
 
-.. seealso:: `Official Laravel Documentation <https://laravel.com/docs/5.4/installation>`_
+.. seealso:: |ext_lnk_example_laravel_documentation|
 
 
 **Table of Contents**

docs/examples/setup-other-frameworks.rst

@@ -9,3 +9,5 @@ and the list is in no way complete.
 
 The Devilbox itself is a normal development stack and is capable of running *any* framework, CMS
 or custom written PHP software.
+
+If you wish to see more install guides, open up an issue at Github: https://github.com/cytopia/devilbox/issues

docs/examples/setup-phalcon.rst

@@ -1,3 +1,5 @@
+.. include:: /_includes/all.rst
+
 .. _example_setup_phalcon:
 
 *************
@@ -6,7 +8,7 @@ Setup Phalcon
 
 This example will use ``phalcon`` to install Phalcon from within the PHP container.
 
-.. seealso:: `Official Phalcon Documentation <https://docs.phalconphp.com/en/3.2/devtools-usage>`_
+.. seealso:: |ext_lnk_example_phalcon_documentation|
 
 
 **Table of Contents**

docs/examples/setup-photon-cms.rst

@@ -1,3 +1,5 @@
+.. include:: /_includes/all.rst
+
 .. _example_setup_photon_cms:
 
 ****************
@@ -6,7 +8,7 @@ Setup Photon CMS
 
 This example will use ``photon`` cli to install Photon CMS from within the PHP container.
 
-.. seealso:: `Official Photon CMS Documentation <https://photoncms.com/resources/installing>`_
+.. seealso:: |ext_lnk_example_photon_cms|
 
 
 **Table of Contents**

docs/examples/setup-shopware.rst

@@ -1,3 +1,5 @@
+.. include:: /_includes/all.rst
+
 .. _example_setup_shopware:
 
 **************
@@ -7,8 +9,8 @@ Setup Shopware
 This example will use ``git`` to install Shopware from within the PHP container.
 
 .. seealso::
-   * `Official Shopware Documentation <https://en-community.shopware.com/Shopware-5-Installer_detail_1351_730.html/sCoreId,bdd630e6d079964f3f697fccff83a987>`_
+   * |ext_lnk_example_shopware_documentation|
-   * `Shopware Github repository <https://github.com/shopware/shopware>`_
+   * |ext_lnk_example_shopware_github|
 
 
 **Table of Contents**
@@ -111,7 +113,7 @@ following line to your host operating systems ``/etc/hosts`` file
 ---------------------------------------
 
 All set now, you can visit http://my-sw.loc in your browser and follow the installation steps as
-described in the `Official Shopware Documentation <https://en-community.shopware.com/Shopware-5-Installer_detail_1351_730.html/sCoreId,bdd630e6d079964f3f697fccff83a987>`_:
+described in the |ext_lnk_example_shopware_documentation|:
 
 .. important::
    When setting up database connection use the following values:

docs/examples/setup-symfony.rst

@@ -1,3 +1,5 @@
+.. include:: /_includes/all.rst
+
 .. _example_setup_symfony:
 
 *************
@@ -6,7 +8,7 @@ Setup Symfony
 
 This example will use ``symfony`` to install Symfony from within the PHP container.
 
-.. seealso:: `Official Symfony Documentation <https://symfony.com/doc/current/setup.html>`_
+.. seealso:: |ext_lnk_example_symfony_documentation|
 
 
 **Table of Contents**

docs/examples/setup-typo3.rst

@@ -1,3 +1,5 @@
+.. include:: /_includes/all.rst
+
 .. _example_setup_typo3:
 
 ***********
@@ -6,7 +8,7 @@ Setup Typo3
 
 This example will use ``composer`` to install Typo3 from within the PHP container.
 
-.. seealso:: `Official Typo3 Documentation <https://docs.typo3.org/typo3cms/InstallationGuide/Index.html>`_
+.. seealso:: |ext_lnk_example_typo3_documentation|
 
 
 **Table of Contents**

docs/examples/setup-wordpress.rst

@@ -1,3 +1,5 @@
+.. include:: /_includes/all.rst
+
 .. _example_setup_wordpress:
 
 ***************
@@ -6,7 +8,7 @@ Setup Wordpress
 
 This example will use ``git`` to install Wordpress from within the PHP container.
 
-.. seealso:: `Official Wordpress Documentation <https://codex.wordpress.org/Installing_WordPress>`_
+.. seealso:: |ext_lnk_example_wordpress_documentation|
 
 
 **Table of Contents**

docs/examples/setup-yii.rst

@@ -1,3 +1,5 @@
+.. include:: /_includes/all.rst
+
 .. _example_setup_yii:
 
 *********
@@ -6,7 +8,7 @@ Setup Yii
 
 This example will use ``composer`` to install Yii from within the PHP container.
 
-.. seealso:: `Official Yii Documentation <https://www.yiiframework.com/doc/guide/2.0/en/start-installation>`_
+.. seealso:: |ext_lnk_example_yii_documentation|
 
 
 **Table of Contents**

docs/examples/setup-zend.rst

@@ -1,3 +1,5 @@
+.. include:: /_includes/all.rst
+
 .. _example_setup_zend:
 
 **********
@@ -6,7 +8,7 @@ Setup Zend
 
 This example will use ``composer`` to install Zend from within the PHP container.
 
-.. seealso:: `Official Zend Documentation <https://docs.zendframework.com/tutorials/getting-started/skeleton-application/>`_
+.. seealso:: |ext_lnk_example_zend_documentation|
 
 
 **Table of Contents**