Tag: Hugo

目次

関連ページ

参考情報

  • Goで作られた静的サイトジェネレーター。

インストール

  • MacPortsの場合以下の方法でインストール
    sudo port install hugo

基本的な使用方法

  • HUGOで静的サイトを作成してみた - Qiita
  • サイトの作成(demoというサイトが作られる)
    hugo new site demo
  • テーマの追加。
    cd demo
    git init
    git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke
    echo 'theme = "ananke"' >> config.toml
  • 記事の追加。content/post下に記事が作成される。
    hugo new post/my-first-post.md 
  • hugo server
    hugo server -D
  • 記事の公開。静的サイトジェネレータ「Hugo」〜公開方法〜 - SIS Lab
  • hugoコマンドを実行するとpublicディレクトリの下にhtmlが書き出される。それをscpなりで公開する。

Tips

サブディレクトリで公開

  • とりあえず以下のようにすれば良い?
    baseurl="http://localhost/hugo"
    RelativeURLs=true
    CanonifyURLs=true
    

カテゴリ

コンテンツ管理

  • ディレクトリを「001-about」(/about)「002-home」(/home)のように設定していけばセクションの順番をフォルダ名で管理できる…と思ったがセクションにslugは設定できないようだ。
  • 対して記事に「url」を指定してパーマリンクを設定すると、ディレクトリ部分まで含めてすきなURLを設定できるが(例: /t/hoge.html)、「/t/」に対応したセクションが存在しないと記事一覧は取得できない。
  • 結局about、homeのようなディレクトリを設定し、weightを設定するhugo公式ドキュメントサイトのような方式が一番素直なのか。?

ツリー構造

テーマ

おすすめテーマ

テーマのカスタマイズ

ページリソースをサムネイルとして使用したい。

  • たとえばフロントマターでthumbnailをページリソースとして指定している場合、以下のようにテーマを改造する。
     {{ if .Params.thumbnail }}
       {{ $image := .Resources.GetMatch .Params.thumbnail }}
     <div class="thumb" style="background-image: url('{{ $image.RelPermalink }}');"></div>
      {{ else }}
     <div class="thumb"></div>
     {{ end }}

hugo_theme_robustの使用

参考情報

トラブルシューティング

scssが変換できないとかどうとかのエラー

  • scssを扱うためにはextended版が必要?
    sudo port install hugo +extended

Error: add site dependencies: load resources: loading templates: walk: Readdir: decorate:

  • hugo server -Dでエラー。
  • layoutフォルダ内にEmacsのロックファイルが残っていたのが原因。
  • ドットから始まるファイルがないか確認する。

found no layout file for "HTML" for kind "page"

  • hugo server -Dを実行すると以下の警告メッセージが表示される。
  • 「 found no layout file for "HTML" for kind "page": You should create a template file which matches Hugo Layouts Lookup Rules for this combination.」
  • 原因はテーマを指定していないこと。
  • config.tomlで指定。
    theme = "mytheme"

public以下にファイルが書き出されない

  • コンテンツがdraftになっていないか確認。
  • 「hugo server -D」で確認していて「hugo」でコンパイルするとドラフトが表示されない。

情報が反映されない?


トップ   編集 凍結 差分 バックアップ 添付 複製 名前変更 リロード   新規 一覧 検索 最終更新   ヘルプ   最終更新のRSS
Last-modified: 2020-06-13 (土) 17:15:01