目錄: Table of Contents

目錄: Table of Contents

2025-02-02·
Mars Lo
Mars Lo
· 3 分鐘

我在這篇文章中展示我做的的 Hugo Shortcodes。

Hugo

Hugo 是使用 Go 語言開發的靜態網站生成器,是一個快速、輕量、易於使用、可擴展的網站生成器。

Frameworks/Theme: Hugo Blox

Hugo Blox 是 Hugo 的框架,提供了很多現成的元件,可以快速建立網站。

Hugo Shortcodes

Hugo 的 Shortcodes 是 Hugo 提供的一種功能,允許開發者在文章中插入自定義的 HTML 片段,這些片段可以包含動態內容、圖片、表單等。

為了日常使用方便,我製作了這些 Shortcodes,並放在 Repo: mars-made-hugo-blox-and-shortcodes 中。

我在本頁中提供了這些 Shortcodes 的使用範例。

Demo

Toc-block

Customized-callout

  • 可自定義的提示框
    • 支援不同類型(info, warning)
    • 可自定義標題和內容
    • 包含圖示和樣式
Info

有時候 TOC 會出現,有時候不會出現,這是因為有下了參數:

  • mobile_only=true 如果是手機版 / 較窄的視窗,才會顯示 TOC
  • is_open=true 預設是關閉的,如果想要預設打開,可以下 is_open=true

shortcode sample

{{<customized-callout type="info">}}
有時候 TOC 會出現,有時候不會出現,這是因為有下了參數:
- mobile_only=true 如果是手機版 / 較窄的視窗,才會顯示 TOC
- is_open=true 預設是關閉的,如果想要預設打開,可以下 is_open=true
{{</customized-callout>}}
有 Title

有時候 TOC 會出現,有時候不會出現,這是因為有下了參數:

  • mobile_only=true 如果是手機版 / 較窄的視窗,才會顯示 TOC
  • is_open=true 預設是關閉的,如果想要預設打開,可以下 is_open=true

shortcode sample

{{<customized-callout type="info" title="有 Title">}}
有時候 TOC 會出現,有時候不會出現,這是因為有下了參數:
- mobile_only=true 如果是手機版 / 較窄的視窗,才會顯示 TOC
- is_open=true 預設是關閉的,如果想要預設打開,可以下 is_open=true
{{</customized-callout>}}
  • 美觀的連結預覽卡片
    • 支援圖片、標題、描述
    • 顯示網站域名和日期
    • 響應式設計

shortcode sample

{{<link-preview-card 
    url="https://anelive.today"
    title="匠活筆記 | 在忙碌與平衡之間,找到屬於你的節奏"
    description="聰明工作,從容生活。生活不該只剩忙碌,工作也能有溫度。這裡談構築理想生活,聊生涯規劃,分享那些利用科技讓人生運轉順暢的小技巧;從專案管理到心智模型,從問題解決到產品思維。來吧,一起用匠人的態度,勾勒屬於你的生活藍圖。"
    image="https://anelive.today/media/icon_hu13349831664580004083.png"
    date="2025-02-02"
>*/}}

Universal-announcement

  • 通用公告區塊
    • 顯示最新消息列表
    • 可自定義連結和標題
    • 簡潔的設計風格
    • 方便一次性修改

{{< universal-announcement >}}

shortcode sample

{{</* universal-announcement >}}

如何安裝

  1. 到 github repo 按個 star
自製 Shortcodes
  1. 選擇你要的 shortcode

  2. 下載 .html 檔案,放到 layouts/shortcodes/ 目錄下

  3. 指定語法使用

Mars Lo
作者
Mars Lo
自動化 | 產品思維 | 專案管理 | 職涯諮詢
偷懶是為了更好地浪費