mirror of
https://github.com/hugo-fixit/FixIt.git
synced 2026-08-24 15:28:57 +00:00
test: add comprehensive tests for Alerts Markdown syntax and Admonition shortcode
This commit is contained in:
@@ -0,0 +1,156 @@
|
|||||||
|
---
|
||||||
|
title: "Alerts and Admonition Syntax Test"
|
||||||
|
date: 2025-09-05T16:57:58+08:00
|
||||||
|
draft: false
|
||||||
|
collections:
|
||||||
|
- Tests
|
||||||
|
categories:
|
||||||
|
- Markdown
|
||||||
|
- Shortcodes
|
||||||
|
tags:
|
||||||
|
- Alerts
|
||||||
|
- Admonition
|
||||||
|
---
|
||||||
|
|
||||||
|
This article comprehensively tests the **Alerts** Markdown syntax extension and **Admonition** shortcode functionality in the FixIt theme.
|
||||||
|
|
||||||
|
<!--more-->
|
||||||
|
|
||||||
|
## Basic Alerts Syntax
|
||||||
|
|
||||||
|
> [!NOTE]
|
||||||
|
> Highlights information that users should take into account, even when skimming.
|
||||||
|
|
||||||
|
> [!TIP]
|
||||||
|
> Optional information to help a user be more successful.
|
||||||
|
|
||||||
|
> [!IMPORTANT]
|
||||||
|
> Crucial information necessary for users to succeed.
|
||||||
|
|
||||||
|
> [!WARNING]
|
||||||
|
> Critical content demanding immediate user attention due to potential risks.
|
||||||
|
|
||||||
|
> [!CAUTION]
|
||||||
|
> Negative potential consequences of an action.
|
||||||
|
|
||||||
|
## Extended Alerts Syntax
|
||||||
|
|
||||||
|
### Custom Titles
|
||||||
|
|
||||||
|
> [!NOTE] FixIt
|
||||||
|
> A clean, elegant but advanced Hugo theme.
|
||||||
|
|
||||||
|
> [!TIP] This is a title-only alert
|
||||||
|
|
||||||
|
### Foldable Alerts
|
||||||
|
|
||||||
|
Create foldable alerts by adding a plus (+) or minus (-) directly after the type identifier:
|
||||||
|
|
||||||
|
> [!WARNING]+ Radiation Hazard
|
||||||
|
> Do not approach or handle without protective gear.
|
||||||
|
|
||||||
|
> [!QUESTION]- Are alerts foldable?
|
||||||
|
> Yes! In a foldable alert, the contents are hidden when collapsed.
|
||||||
|
|
||||||
|
### Nested Alerts
|
||||||
|
|
||||||
|
Alerts can be nested in multiple levels:
|
||||||
|
|
||||||
|
> [!question] Can alerts be nested?
|
||||||
|
> > [!todo] Yes! They can be nested.
|
||||||
|
> > > [!example] You can even use multiple layers of nesting.
|
||||||
|
|
||||||
|
### Supported types
|
||||||
|
|
||||||
|
> [!note]+
|
||||||
|
> This is a note type alert example.
|
||||||
|
|
||||||
|
> [!abstract]-
|
||||||
|
> This is an abstract type alert example. Aliases: `summary`, `tldr`
|
||||||
|
|
||||||
|
> [!info]-
|
||||||
|
> This is an info type alert example.
|
||||||
|
|
||||||
|
> [!todo]-
|
||||||
|
> This is a todo type alert example.
|
||||||
|
|
||||||
|
> [!tip]-
|
||||||
|
> This is a tip type alert example. Aliases: `hint`, `important`
|
||||||
|
|
||||||
|
> [!success]-
|
||||||
|
> This is a success type alert example. Aliases: `check`, `done`
|
||||||
|
|
||||||
|
> [!question]-
|
||||||
|
> This is a question type alert example. Aliases: `help`, `faq`
|
||||||
|
|
||||||
|
> [!warning]-
|
||||||
|
> This is a warning type alert example. Aliases: `caution`, `attention`
|
||||||
|
|
||||||
|
> [!failure]-
|
||||||
|
> This is a failure type alert example. Aliases: `fail`, `missing`
|
||||||
|
|
||||||
|
> [!danger]-
|
||||||
|
> This is a danger type alert example. Aliases: `error`
|
||||||
|
|
||||||
|
> [!bug]-
|
||||||
|
> This is a bug type alert example.
|
||||||
|
|
||||||
|
> [!example]-
|
||||||
|
> This is an example type alert example.
|
||||||
|
|
||||||
|
> [!quote]-
|
||||||
|
> This is a quote type alert example. Aliases: `cite`
|
||||||
|
|
||||||
|
## Admonition Shortcode
|
||||||
|
|
||||||
|
{{< admonition >}}
|
||||||
|
This is the default note type admonition.
|
||||||
|
{{< /admonition >}}
|
||||||
|
|
||||||
|
{{< admonition abstract "" false >}}
|
||||||
|
This is the default abstract type admonition. Aliases: `summary`, `tldr`
|
||||||
|
{{< /admonition >}}
|
||||||
|
|
||||||
|
{{< admonition info "" false >}}
|
||||||
|
This is the default info type admonition.
|
||||||
|
{{< /admonition >}}
|
||||||
|
|
||||||
|
{{< admonition todo "" false >}}
|
||||||
|
This is the default todo type admonition.
|
||||||
|
{{< /admonition >}}
|
||||||
|
|
||||||
|
{{< admonition tip "" false >}}
|
||||||
|
This is the default tip type admonition. Aliases: `hint`, `important`
|
||||||
|
{{< /admonition >}}
|
||||||
|
|
||||||
|
{{< admonition success "" false >}}
|
||||||
|
This is the default success type admonition. Aliases: `check`, `done`
|
||||||
|
{{< /admonition >}}
|
||||||
|
|
||||||
|
{{< admonition question "" false >}}
|
||||||
|
This is the default question type admonition. Aliases: `help`, `faq`
|
||||||
|
{{< /admonition >}}
|
||||||
|
|
||||||
|
{{< admonition warning "" false >}}
|
||||||
|
This is the default warning type admonition. Aliases: `caution`, `attention`
|
||||||
|
{{< /admonition >}}
|
||||||
|
|
||||||
|
{{< admonition failure "" false >}}
|
||||||
|
This is the default failure type admonition. Aliases: `fail`, `missing`
|
||||||
|
{{< /admonition >}}
|
||||||
|
|
||||||
|
{{< admonition danger "" false >}}
|
||||||
|
This is the default danger type admonition. Aliases: `error`
|
||||||
|
{{< /admonition >}}
|
||||||
|
|
||||||
|
{{< admonition bug "" false >}}
|
||||||
|
This is the default bug type admonition.
|
||||||
|
{{< /admonition >}}
|
||||||
|
|
||||||
|
{{< admonition example "" false >}}
|
||||||
|
This is the default example type admonition.
|
||||||
|
{{< /admonition >}}
|
||||||
|
|
||||||
|
{{< admonition quote "" false >}}
|
||||||
|
This is the default quote type admonition. Aliases: `cite`
|
||||||
|
{{< /admonition >}}
|
||||||
Reference in New Issue
Block a user