常用語法：Hugo網站搭配Blowfish主題

Hugo搭配Blowfish主題的語法，
大致分成：
HTML語法：寫模板、樣式，最通用
MD語法：常用於index.md內頁，簡便
Blowfish 簡碼：Blowfish主題整理的GO語法

將我自己常用的語法列在開頭

常用語法

#

標註

#

<!-- -->

換行

#

<br>

程式碼

#

用👉`👈左右框住

    ```go
    ```markdown
    ```html

插入圖片

#

在 Hugo 中， Page Bundle 圖片的相對路徑要注意規則。
資料夾裡必須要有一個 index.md (・ω・、)
若只有 index.zh-tw.md Page Bundle會無法成立，圖片破光光 (つд`ﾟ)･ﾟ･

content/文章資料夾/
            ├─ index.md   # 必須存在，可以是空白檔案
            ├─ index.zh-tw.md
            └─ images/Export_UV_Layout.png

文章資料夾內同時要有
index.md
index.zh-tw.md
images 資料夾

MD寫法是 ![圖片說明](圖片相對位置)

![Export UV Layout](images/Export_UV_Layout.png)

MD的寫法會強制滿版、圓角，
若圖片寬度低於 602px，使用MD寫法將會導致圖片模糊

figure 寫法的 default=true 能解除強制滿版、圓角，以原尺寸、直角顯示圖片。
不過 figure 寫法無法放入程式碼框，會強制啟動插入圖片，因此拆成
{{ 與 < figure...> 與 }} 之間無空格

{{之間的}}語法如下：

< figure src="images/Export_UV_Layout.png" alt="Export UV Layout" >

< figure 
  src="images/Export_UV_Layout.png"
  alt="Export UV Layout"
  default=true
>

id內文跳轉

#

手動指定目標 id：{#3d}
跳轉連結寫法：[連結文字](#3d)

有時候主題或瀏覽器對中文 id 會有問題，所以在標題手動指定 id：

## 3D筆記 {#3d}
## 架站筆記 {#site}

固定 id 名稱後，再用：

[3D](#3d)、[架站](#site)

連結

#

[顯示文字](https://sample/go/) 預設會另開視窗

HTML語法

#

標註

#

<!-- -->

程式碼

#

用👉`👈左右框住

換行

#

<br>

MD語法

#

官方文檔

#

Blowfish Markdown 示例 | Github 範例文章

連結

#

[顯示文字](https://sample/go/) 預設會另開視窗

Blowfish 簡碼

#

官方文檔

#

Hugo 簡碼 | Blowfish 簡碼

頁面連結

#

[顯示文字]({{ }}) 同視窗內跳轉
({{ }})內是< ref "/目標位置" > 強制觸發，用程式碼框也沒用！
‼️找不到目標時，會整個網站出不出來！慎用‼️