Merge branch 'dev' into feat/gist

2026-01-30 16:31:52 +01:00 · 2025-05-27 00:36:19 +01:00
parent eb0d04a014 26f3f0510b
commit 68bd843e73
66 changed files with 987 additions and 505 deletions
--- a/exampleSite/content/docs/shortcodes/index.it.md
+++ b/exampleSite/content/docs/shortcodes/index.it.md
@@ -18,7 +18,7 @@ In addition to all the [default Hugo shortcodes](https://gohugo.io/content-manag
 <!-- prettier-ignore-start -->
 | Parameter   | Description                                                                                                                                                                                  |
 | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `icon`      | **Optional.** the icon to display on the left side.<br>**Default:** `exclaimation triangle icon` (Check out the [icon shortcode](#icon) for more details on using icons.)                    |
+| `icon`      | **Optional.** the icon to display on the left side.<br>**Default:** `triangle-exclamation` (Check out the [icon shortcode](#icon) for more details on using icons.)                    |
 | `iconColor` | **Optional.** the color for the icon in basic CSS style.<br>Can be either hex values (`#FFFFFF`) or color names (`white`)<br>By default chosen based on the current color theme .            |
 | `cardColor` | **Optional.** the color for the card background in basic CSS style.<br>Can be either hex values (`#FFFFFF`) or color names (`white`)<br>By default chosen based on the current color theme . |
 | `textColor` | **Optional.** the color for the text in basic CSS style.<br>Can be either hex values (`#FFFFFF`) or color names (`white`)<br>By default chosen based on the current color theme .            |
@@ -286,6 +286,26 @@ Blowfish also supports automatic conversion of images included using standard Ma

 <br/><br/><br/>

+## Forgejo Card
+
+`forgejo` allows you to quickly link a Forgejo repository via the forgejo API, providing real-time updates on stats such as stars and forks.
+
+<!-- prettier-ignore-start -->
+| Parameter | Description                                           |
+| --------- | ----------------------------------------------------- |
+| `repo`    | [String] forgejo repo in the format of `username/repo`|
+| `server`  | [String] server URL like `https://v8.next.forgejo.org`|
+<!-- prettier-ignore-end -->
+
+**Example 1:**
+
+```md
+{{</* forgejo server="https://v8.next.forgejo.org" repo="forgejo/forgejo" */>}}
+```
+{{< forgejo server="https://v8.next.forgejo.org" repo="forgejo/forgejo" >}}
+
+<br/><br/><br/>
+
 ## Gallery

 `gallery` allows you to showcase multiple images at once, in a responsive manner with more varied and interesting layouts.
@@ -361,7 +381,6 @@ In order to add images to the gallery, use `img` tags for each image and add `cl
 {{</* gist "octocat" "6cad326836d38bd3a7ae" */>}}
 ````

-{{< gist "octocat" "6cad326836d38bd3a7ae" >}}

 **Example 2: Embed specific file from Gist**

@@ -369,7 +388,25 @@ In order to add images to the gallery, use `img` tags for each image and add `cl
 {{</* gist "rauchg" "2052694" "README.md" */>}}
 ```

-{{< gist "rauchg" "2052694" "README.md" >}}
+<br/><br/><br/>
+
+## Gitea Card
+
+`gitea` allows you to quickly link a Gitea repository via the gitea API, providing real-time updates on stats such as stars and forks.
+
+<!-- prettier-ignore-start -->
+| Parameter | Description                                           |
+| --------- | ----------------------------------------------------- |
+| `repo`    | [String] gitea repo in the format of `username/repo`  |
+| `server`  | [String] server URL like `https://git.fsfe.org`       |
+<!-- prettier-ignore-end -->
+
+**Example 1:**
+
+```md
+{{</* gitea server="https://git.fsfe.org" repo="FSFE/fsfe-website" */>}}
+```
+{{< gitea server="https://git.fsfe.org" repo="FSFE/fsfe-website" >}}

 <br/><br/><br/>

@@ -706,7 +743,7 @@ With other shortcodes
 {{< timeline >}}

 {{< timelineItem icon="github" header="header" badge="badge test" subheader="subheader" >}}
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus non magna ex. Donec sollicitudin ut lorem quis lobortis. Nam ac ipsum libero. Sed a ex eget ipsum tincidunt venenatis quis sed nisl. Pellentesque sed urna vel odio consequat tincidunt id ut purus. Nam sollicitudin est sed dui interdum rhoncus. 
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus non magna ex. Donec sollicitudin ut lorem quis lobortis. Nam ac ipsum libero. Sed a ex eget ipsum tincidunt venenatis quis sed nisl. Pellentesque sed urna vel odio consequat tincidunt id ut purus. Nam sollicitudin est sed dui interdum rhoncus.
 {{</ timelineItem >}}


--- a/exampleSite/content/docs/shortcodes/index.md
+++ b/exampleSite/content/docs/shortcodes/index.md
@@ -418,9 +418,10 @@ In order to add images to the gallery, use `img` tags for each image and add `cl
 `github` allows you to quickly link a github repository, all while showing and updating in realtime stats about it, such as the number of stars and forks it has.

 <!-- prettier-ignore-start -->
-| Parameter | Description                                           |
-| --------- | ----------------------------------------------------- |
-| `repo`    | [String] github repo in the format of `username/repo` |
+| Parameter       | Description                                                   |
+|-----------------|---------------------------------------------------------------|
+| `repo`          | [String] github repo in the format of `username/repo`         |
+| `showThumbnail` | **Optional** [boolean] display a thumbnail for the repository |
 <!-- prettier-ignore-end -->

 **Example 1:**
--- a/exampleSite/content/docs/shortcodes/index.zh-cn.md
+++ b/exampleSite/content/docs/shortcodes/index.zh-cn.md
@@ -18,7 +18,7 @@ series_order: 8
 <!-- prettier-ignore-start -->
 | 参数        | 功能                                                                                                                             |
 | ----------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| `icon`      | **可选** 显示在左侧的图标。<br>**默认：** `exclaimation triangle icon` (查看[图标简码](#icon)，了解有关使用图标的更多详细信息。) |
+| `icon`      | **可选** 显示在左侧的图标。<br>**默认：** `exclaimation triangle icon` (查看[图标简码](#图标)，了解有关使用图标的更多详细信息。) |
 | `iconColor` | **可选** 基本 CSS 样式中图标的颜色。<br>可以是十六进制值 (`#FFFFFF`) 或颜色名称 (`white`)<br>默认情况下由当前配色方案决定。      |
 | `cardColor` | **可选** 基本 CSS 样式中卡片背景的颜色。<br>可以是十六进制值 (`#FFFFFF`) 或颜色名称 (`white`)<br>默认情况下由当前配色方案决定。  |
 | `textColor` | **可选** 基本 CSS 样式中文本的颜色。<br>可以是十六进制值 (`#FFFFFF`) 或颜色名称 (`white`)<br>默认情况下由当前配色方案决定。      |
@@ -362,7 +362,6 @@ Blowfish 还支持使用标准 Markdown 语法自动转换图像。只需使用
 {{</* gist "octocat" "6cad326836d38bd3a7ae" */>}}
 ```

-{{< gist "octocat" "6cad326836d38bd3a7ae" >}}

 **示例 2：嵌入 Gist 中的特定文件**

@@ -370,7 +369,27 @@ Blowfish 还支持使用标准 Markdown 语法自动转换图像。只需使用
 {{</* gist "rauchg" "2052694" "README.md" */>}}
 ```

-{{< gist "rauchg" "2052694" "README.md" >}}
+<br/><br/><br/>
+
+
+## Gitea 卡片
+
+`gitea` 允许你通过 gitea API 快速链接一个 Gitea 仓库，提供诸如 stars 和 forks 等统计数据的实时更新。
+
+<!-- prettier-ignore-start -->
+| 参数       | 描述                                      |
+| -------- | --------------------------------------- |
+| `repo`   | \[字符串] 以 `用户名/仓库名` 格式表示的 gitea 仓库       |
+| `server` | \[字符串] 服务器 URL，如 `https://git.fsfe.org` |
+<!-- prettier-ignore-end -->
+
+**示例 1：**
+
+```md
+{{</* gitea server="https://git.fsfe.org" repo="FSFE/fsfe-website" */>}}
+```
+
+{{< gitea server="https://git.fsfe.org" repo="FSFE/fsfe-website" >}}

 <br/><br/><br/>

@@ -707,17 +726,17 @@ With other shortcodes

 {{< timelineItem icon="github" header="header" badge="badge test" subheader="subheader" >}}
 Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus non magna ex. Donec sollicitudin ut lorem quis lobortis. Nam ac ipsum libero. Sed a ex eget ipsum tincidunt venenatis quis sed nisl. Pellentesque sed urna vel odio consequat tincidunt id ut purus. Nam sollicitudin est sed dui interdum rhoncus. 
-{{</ timelineItem >}}
+{{< /timelineItem >}}


-{{< timelineItem icon="code" header="Another Awesome Header" badge="date - present" subheader="Awesome Subheader">}}
+{{< timelineItem icon="code" header="Another Awesome Header" badge="date - present" subheader="Awesome Subheader" >}}
 With html code
 <ul>
  <li>Coffee</li>
  <li>Tea</li>
  <li>Milk</li>
 </ul>
-{{</ timelineItem >}}
+{{< /timelineItem >}}

 {{< timelineItem icon="star" header="Shortcodes" badge="AWESOME" >}}
 With other shortcodes
@@ -730,12 +749,13 @@ With other shortcodes
  <img src="gallery/06.jpg" class="grid-w33" />
  <img src="gallery/07.jpg" class="grid-w33" />
 {{< /gallery >}}
+{{< /timelineItem >}}
+
 {{< timelineItem icon="code" header="Another Awesome Header">}}
 {{< github repo="nunocoracao/blowfish" >}}
-{{</ timelineItem >}}
-{{</ timelineItem >}}
+{{< /timelineItem >}}

-{{</ timeline >}}
+{{< /timeline >}}


 <br/><br/><br/>