Caution
You're viewing documentation for an unstable version of Scylla Sphinx Theme. Switch to the latest stable version.
A custom directive to create a header on the root index.rst file.
Warning
Do not use the hero-box on the subordinate index.rst files.
.. hero-box::
<options>
<text>
The hero-box directive supports the following options:
Option |
Type |
Required |
Example Value |
Description |
|---|---|---|---|---|
|
string |
Lorem ipsum |
Hero box title. |
|
|
string |
Custom CSS class. |
||
|
string |
fa fa-home |
A list of CSS classes to render an icon, separated by comma or space. |
|
|
string |
Lorem ipsum |
Text for the call to action. |
|
|
string |
Relative link or external URL for the call to action. Do not use leading and trailing (“/”) symbols to define relative links. (e.g. instead of |
||
|
string |
/_static/img/mascots/scylla-enterprise.svg |
Path to the image. The image should be located in the project’s |
|
|
flag |
If set, displays the site’s search box. |
Using:
.. hero-box::
:title: Lorem Ipsum
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Results in:
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Using:
.. hero-box::
:title: Lorem Ipsum
:image: /_static/img/mascots/scylla-enterprise.svg
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Results in:
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Using:
.. hero-box::
:title: Lorem Ipsum
:search_box:
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Results in:
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Using:
.. hero-box::
:title: Lorem Ipsum
:image: /_static/img/mascots/scylla-enterprise.svg
:button_icon: fa fa-github
:button_url: #
:button_text: Project Name
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Results in: