【Hugo】新しく記事を追加する方法

サンプルや以前に書いたファイルをコピーして名前を変更して、必要事項を変更して記事を掛けばOKです。

あ、パーマリンク(URL)をデフォルトで設定している場合はファイル名がURLになるので、しっかりと考えてつけましょう！

ファイル上でctrlcしてctrlvでコピペできます(もちろん右クリックからも可能です)。

ファイル上でF2で名前の変更ができます(もちろん右クリックからも可能です)。

あとはファイル上部の設定部分を適時変更します。

私の場合は、タイトルや日付を中心に、アイキャッチへのパス、カテゴリ、タグなんかを変えていますね。

VSCodeでタイトル部分を選択してあげれば文字数も出るので、SEO対策もバッチリです(30文字程度が良いとされています)！

書いた記事が表示されない原因のほとんどもここなので、気を使う必要が有ります。(ここ見直してもだめなら再起動連打です)

やっぱりコマンドを使いたい

contentフォルダの上の階層に行き、下記コマンドを入力してください。

$ hugo new post/hello-world.md

これでやってください。

newだけで、dafault.mdを参考にしてファイルを作ってくれます。

postの部分はフォルダパスです。テーマによっては「blog」だったり、「posts」だったりといろいろなので、

サンプルサイトを使った方法が無難かと…

記事作成に必要な最低限のマークダウン記法

タイトルと改行だけ習得してください。

(テーブルとかは反映されないので、HTML直打ちです。)

タイトルタグ

HTMLにするとh2タグになる書き方です。

SEOの観点からも大切ですし、Hugoの場合はこの書き方でないと目次が反映されません。

(この原理を利用して目次に出したくないタイトルを<h3>タイトル3</h3>って書く小技もありますが…)

# 大見出しは基本使わないかなって(h1)

## 見出しは#で表します。(h2)

### 見出しのネストは好きじゃないです(h3)

### 使ってもここまでですかね(h4)

俗に言う改行

だた改行するだけです。

こうやって

改行すると

こうなります。

<p>こうやって</p>
<p>改行すると</p>

WordPressライクで結構好きなんですよね。

装飾は基本的にHTMLタグで書ける

装飾にこだわる場合は、おとなしくHTMLを書いて、スタイルを当てる必要が有あります。

マークダウンの美しさは消え失せてしまいますが、日本のサイトはデザインありきなので仕方ないかなって。

私の執筆状況こんなんですよ。

リード文

<!-- more -->

## 見出しは#で表します。

改行するとpタグが入ります。

こうやって記事を書いていきます。

<div class="message">
  <div class="message-body">
   <p>装飾はHTMLで書いています</p>
  </div>
</div>

<table class="table is-bordered is-striped is-narrow is-hoverable is-fullwidth">
  <tr>
    <th>表も</th>
    <th>テーブル直書き</th>
  </tr>
</table>

私のテーマで使える装飾用クラスは以下の記事で紹介しています。