跳过正文
  1. 笔记/

Hugo Blowfish 常用语法速查

Web Hugo Blowfish 语法 笔记
目录

Inner Cover Image
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/ExampleImage.png" alt="Example Image" >
< figure 
  src="images/ExampleImage.png"
  alt="Example Image"
  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 "/目标位置" > 强制触发,用程式码框也没用!
‼️找不到目标时,会整个网站出不出来!慎用‼️