メインコンテンツへスキップ
  1. メモ/

Hugo Blowfish よく使う構文チートシート

Web Hugo Blowfish 構文 メモ
目次

Inner Cover Image
Hugo と Blowfish テーマで使用する構文は、
大きく以下の3種類に分かれます:
HTML 構文:テンプレートやスタイルの記述に使用。最も汎用性が高い
MD 構文index.md の本文記述に多用。シンプルで扱いやすい
Blowfish ショートコード:Blowfish テーマが提供する Go 構文

よく使う構文
#

コメントアウト
#

<!-- -->

改行
#

<br>

コードブロック
#

👉`👈で左右を囲む

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

画像の挿入
#

HugoPage 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 フォルダ

Markdown の記法は ![画像の説明](画像の相対パス) です

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

Markdown の記法では強制的に全幅・角丸で表示されます。
画像の横幅が 602px 未満の場合、Markdown 記法を使用すると画像がぼやけることがあります

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>


Markdown 構文
#

公式ドキュメント
#

Blowfish Markdown サンプル | Github サンプル記事

リンク
#

[表示テキスト](https://sample/go/) デフォルトで別ウィンドウで開きます

Blowfish ショートコード
#

公式ドキュメント
#

Hugo ショートコード | Blowfish ショートコード

ページ内リンク
#

[表示テキスト]({{ }}) 同一ウィンドウ内でジャンプ
({{ }})の中は< ref "/移動先のパス" >です。コードブロック内に書いても強制的に実行されます!
‼️移動先が見つからない場合、サイト全体がビルドエラーになります!取り扱い注意‼️