diff --git a/docs/index.md b/docs/index.md index 927c554d..02a0c6da 100644 --- a/docs/index.md +++ b/docs/index.md @@ -11,10 +11,33 @@ Documentation for LUG @ USTC technical infrastructure. Our documentation is divided into these sections, as laid out on the left navigation menu: -- The **Workflow** section provides guidance to (a few) common maintenance tasks. -- The **Infrastructure** section describes our infrastructure, as well as common configurations across different servers (networking, firewalls, security, monitoring, etc.). -- The **Services** section documents specific configurations on individual servers and service units (software and/or Docker containers). -- The **Common Issues** (a.k.a. **FAQ**) section records our troubleshooting experiences and serves partially as a "notebook" for known traps and workarounds. +
+ +- :fontawesome-solid-wrench:{ .lg .middle } **Workflow** + + --- + + Provides guidance to (a few) common maintenance tasks. + +- :material-toy-brick:{ .lg .middle } **Infrastructure** + + --- + + Describes our infrastructure, as well as common configurations across different servers (networking, firewalls, security, monitoring, etc.). + +- :fontawesome-solid-certificate:{ .lg .middle } **Services** + + --- + + Specific configurations on individual servers and service units (software and/or Docker containers). + +- :fontawesome-solid-circle-question:{ .lg .middle } **Common Issues** (a.k.a. **FAQ**) + + --- + + For our troubleshooting experiences and serves partially as a "notebook" for known traps and workarounds. + +
## References {#links} diff --git a/mkdocs.yml b/mkdocs.yml index 634f9a0e..4a2a455c 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -57,6 +57,7 @@ markdown_extensions: - attr_list - footnotes - markdown.extensions.def_list + - md_in_html - pymdownx.details - pymdownx.emoji: emoji_index: !!python/name:material.extensions.emoji.twemoji