feat: add ansible galaxy card shortcode

This commit is contained in:
Kevin Horst
2026-05-08 19:20:53 +02:00
parent da8ca782aa
commit 88863335fd
4 changed files with 231 additions and 1 deletions
@@ -187,6 +187,37 @@ The alert sign (`+` or `-`) is optional to control whether the admonition is fol
<br/><br/><br/>
## Ansible Galaxy Card
`ansible` renders a card for an [Ansible Galaxy](https://galaxy.ansible.com/) entry, fetched at build time. It accepts either a `role` or a `collection` parameter, both in `namespace.name` form.
<!-- prettier-ignore-start -->
| Parameter | Description |
| ------------ | ------------------------------------------------------------------------------------ |
| `role` | [String] Galaxy role in the format `namespace.name`, e.g. `geerlingguy.docker` |
| `collection` | [String] Galaxy collection in the format `namespace.name`, e.g. `community.general` |
<!-- prettier-ignore-end -->
Set exactly one of `role` or `collection` per call.
**Example 1: Role**
```md
{{</* ansible role="geerlingguy.docker" */>}}
```
{{< ansible role="geerlingguy.docker" >}}
**Example 2: Collection**
```md
{{</* ansible collection="community.general" */>}}
```
{{< ansible collection="community.general" >}}
<br/><br/><br/>
## Article
`Article` will embed a single article into a markdown file. The `link` to the file should be the `.RelPermalink` of the file to be embedded. Note that the shortcode will not display anything if it's referencing it's parent. _Note: if you are running your website in a subfolder like Blowfish (i.e. /blowfish/) please include that path in the link._