Hugoで日本語タグを英語URLにしてみたデモサイト。

Hugoで日本語タグを英語URLにしてみたデモサイト

あばうと

あばうとのページ。

サンプル画像

これは赤文字です。

サンプル画像

画像は「static/images」へ入れて管理していく方針。

  • themes/テーマ名/static では無い

固定ページと記事投稿は、相対リンクの階層が異なるので、記述に注意する。

記事投稿

  • ../../images/xxx.jpg
  • ![テキスト](../../images/xxx.jpg)

固定ページ

  • ../images/xxx.jpg
  • ![テキスト](../images/xxx.jpg)

環境

  • パソコン: X230(Lenovo ThinkPad)
  • OS: Linux Mint 20.3 Una(Xfce)

補足

サクッと使う個人的な用途で小規模を想定。

blogフォルダへ投稿を詰め込んで、タグで仕分けるイメージ。

HUGOで個人的に使うシンプルなテーマ。

短時間で作ったので、大雑把にやっつけです。(改善: 2023-08-01)

日本語のタグを英語URLに変換してみたテストサイト。(日本語タグが多いほど手間は増える)

基本的な仕様

ドメイン直下、サブディレクトリでも、とりあえず使えるはず。(config.tomlのbaseURLによる)

  • hugo v0.115.4
  • pure.css
  • config.toml
    • baseURL(最後のスラッシュ有り)
  • toml形式を採用(記事投稿のデフォルト設定)
  • カテゴリー無し
  • タグ(tags)有効
  • デフォルトは、10件ごとのページ送り
    • config.toml,Paginate = 10
    • blog
    • tags/xxx
  • 固定ページ(デフォルト:日付表示なし)
    • hugo-fruits/layouts/_default/single.html
    • コメントアウト
  • メニューページ(固定ページ)

マークダウン

注意点と覚え書き

  • Hugoは多機能なので、シンプルに記事投稿へ集中するほうが負担は少ない。
  • config.tomlは、記述のルールや順番がある。(Configure Hugo
  • 日本語タグが多いほど手間は増える。(英語URLにしたい場合)

ビルドまでの流れ

記事に日本語タグを使用の場合は「content/tags」に「日本語の該当フォルダ+_index.md」の設置が必要。

ビルドを実行すると「日本語タグ」が「英語URLのフォルダ」へ変換される。(public/tagsにて確認できる)

  • config.tomlの編集
    • baseURL(最後のスラッシュ有り)
    • title
    • description
  • templatesを必要に応じて編集
    • hugo-fruits/layouts/partial/_analytics.html
    • hugo-fruits/layouts/partial/_sidebar.html
    • hugo-fruits/layouts/index.html
  • 記事の作成
    • mdファイル(content/blog)
  • 日本語タグの設定をする
    • hugo-fruits/content/tags
    • 「日本語の該当フォルダ+_index.md」の設置
  • ローカルチェック
    • hugo server
    • hugo server -D
  • ビルド
    • hugo
    • hugo -D
  • publicフォルダが生成される