summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorrebortg <github@ghlr.de>2022-04-01 11:42:53 +0200
committerrebortg <github@ghlr.de>2022-04-01 13:55:47 +0200
commit58beb33d4fd36456a1057d111fd764842c358474 (patch)
tree0e6761faf1aeb4180d70eec3235840861375ed56 /docs
parent235ca6cdbb39c0e31dec750f97a033638fb072ba (diff)
downloadvyos-documentation-58beb33d4fd36456a1057d111fd764842c358474.tar.gz
vyos-documentation-58beb33d4fd36456a1057d111fd764842c358474.zip
add sphinx panels and create 6 panels on index.rst
(cherry picked from commit 9708481d5e539a4b5c3d13b1a774abcda84df138)
Diffstat (limited to 'docs')
-rw-r--r--docs/_static/css/custom.css5
-rw-r--r--docs/conf.py2
-rw-r--r--docs/index.rst52
3 files changed, 56 insertions, 3 deletions
diff --git a/docs/_static/css/custom.css b/docs/_static/css/custom.css
index 10596a39..331a7720 100644
--- a/docs/_static/css/custom.css
+++ b/docs/_static/css/custom.css
@@ -1,3 +1,8 @@
+div.card-header {
+ font-weight: bold;
+ background: #fdab10;
+}
+
span.opcmd,
span.cfgcmd {
font-weight: bold;
diff --git a/docs/conf.py b/docs/conf.py
index 3d011ad5..661ff06d 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -45,6 +45,8 @@ extensions = ['sphinx.ext.intersphinx',
'sphinx.ext.ifconfig',
'sphinx.ext.graphviz',
'notfound.extension',
+ 'myst_parser',
+ 'sphinx_panels',
'vyos'
]
diff --git a/docs/index.rst b/docs/index.rst
index f81adfc8..603dcb73 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -4,7 +4,53 @@
VyOS User Guide
###############
+.. panels::
+ :container: container-lg pb-3
+ :column: col-lg-4 col-md-4 col-sm-6 col-xs-12 p-2
+
+ Get / Build VyOS
+ ^^^^^^^^^^^^^^^^
+ Quickly :ref:`Build<contributing/build-vyos:build vyos>` your own Image or take a look at how to :ref:`download<installation/install:download>` a free or supported version.
+ ---
+
+ Install VyOS
+ ^^^^^^^^^^^^
+ Read about how to install VyOS on :ref:`Bare Metall<installation/install:installation>` or in a
+ :ref:`Virtual Environment<installation/virtual/index:running vyos in virtual environments>` and
+ how to use an image with the usual :ref:`cloud<installation/cloud/index:running VyOS in Cloud Environments>` providers
+ ---
+
+ Configuration and Operation
+ ^^^^^^^^^^^^^^^^^^^^^^^^^^^
+ Use the :ref:`Quickstart Guide<quick-start:Quick Start>`, to have a fast overview. Or go deeper and
+ set up :ref:`advanced routing<configuration/protocols/index:protocols>`,
+ :ref:`VRFs<configuration/vrf/index:vrf>`, or
+ :ref:`VPNs<configuration/vpn/index:vpn>` for example.
+ ---
+
+ Automate
+ ^^^^^^^^
+ Integrate VyOS in your automation Workflow with
+ :ref:`Ansible<vyos-ansible>`,
+ have your own :ref:`local scripts<command-scripting>`, or configure VyOS with the :ref:`HTTPS-API<vyosapi>`.
+ ---
+
+ Examples
+ ^^^^^^^^
+ Get some inspiration from the :ref:`Configuration Blueprints<configexamples/index:Configuration Blueprints>`
+ to build your infrastructure.
+ ---
+
+ Contribute and Community
+ ^^^^^^^^^^^^^^^^^^^^^^^^
+ | There are many ways to contribute to the project.
+ | Add missing parts or improve the :ref:`Documentation<documentation:Write Documentation>`.
+ | Discuss in `Slack <https://slack.vyos.io/>`_ or the `Forum <https://forum.vyos.io>`_.
+ | Or you can pick up a `Task <https://phabricator.vyos.net/>`_ and fix the :ref:`code<contributing/development:development>`.
+
+
.. toctree::
+ :hidden:
:maxdepth: 1
introducing/about
@@ -14,7 +60,7 @@ VyOS User Guide
.. toctree::
:maxdepth: 2
- :includehidden:
+ :hidden:
:caption: First Steps
installation/index
@@ -23,7 +69,7 @@ VyOS User Guide
.. toctree::
:maxdepth: 2
- :includehidden:
+ :hidden:
:caption: Adminguide
@@ -36,7 +82,7 @@ VyOS User Guide
.. toctree::
:maxdepth: 2
- :includehidden:
+ :hidden:
:caption: Development
contributing/index