このパートではブログの細かい設定を紹介します．

言語設定 & タイトル設定

Stackのデフォルト設定では[英語・中国語・アラビア語？]の3つが選択できるようになっています．が，日本語のみでブログを書く場合，この選択肢は邪魔なので消します．

hugo.yamlの以下のセクションを

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


languages:
    en:
        languageName: English
        title: Example Site
        weight: 1
        params:
            sidebar:
                subtitle: Example description
    zh-cn:
        languageName: 中文
        title: 演示站点
        weight: 2
        params:
            sidebar:
                subtitle: 演示说明
    ar:
        languageName: عربي
        languagedirection: rtl
        title: موقع تجريبي
        weight: 3
        params:
            sidebar:
                subtitle: وصف تجريبي

次のように修正します．

1
2
3
4
5
6
7
8


languages:
    ja:
        languageName: 日本語
        title: じんらぼ
        weight: 1
        params:
            sidebar:
                subtitle: 

titleはブラウザの上に表示されるタブのタイトル名を決定します．

管理人紹介の設定

ページ左の管理人紹介の設定をします．

themes/hugo-theme-stack/assets/img/に設置したい写真をおきます．

hugo.yamlのsidebarのセクションを例のように変更します．

1
2
3
4
5
6
7


    sidebar:
        emoji: 
        subtitle: "理系大学生の技術ブログです。ちょくちょく関係ないこともつぶやきます。"
        avatar:
            enabled: true
            local: true
            src: img/avatar.png

すると以下のように変更が反映されます．

ソーシャルメディア設定

TwitterやGitHubなどを公開したい場合は，hugo.yamlの以下のセクションを修正します．

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


    social:
        - identifier: github
          name: GitHub
          url: https://github.com/CaiJimmy/hugo-theme-stack
          params:
              icon: brand-github

        - identifier: twitter
          name: Twitter
          url: https://twitter.com
          params:
              icon: brand-twitter

公開したくない場合は，ここのセクションを削除すると，ブログでもアイコンが消えます．

faviconの設定

タイトルの左に表示するアイコンを設定します．

static/にアイコン画像favicon.pngを設置します．

hugo.yamlを以下のセクションを修正します．

1
2
3
4
5
6


params:
    mainSections:
        - post
    featuredImageField: image
    rssFullContent: true
    favicon: ./favicon.png 

うまく読み込めない場合は，/favicon.pngや/と置き換えてみてください．

左メニューの設定

サイト左に配置されている「About」や「Archive」はcontent/pageの下に配置されています．

新しく増やしたい場合は，hugo new page/<new-page>/<new-page>.mdを実行します．

逆にいらないページがあればディレクトリごと削除します．

右メニューの設定

サイトの右に配置されている「CATEGORIES」や「TAG」は自動で生成されています．

表示させたくない項目がある場合はhugo.yamlのwidgetのセクションを編集し，該当の項目を削除します．

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11



    widgets:
        homepage:
            - type: tag-cloud
              params:
                  limit: 10
            - type: archives
              params:
                  limit: 5
        page:
            - type: toc

google アナリティクスについて

Github pagesではアクセス数などの測定ができないので，代わりにgoogle analyticsを使用します．

「google analytics」と検索し，googleのサイトから初期設定を行うとIDが発行されます．

そのIDをhugo.yamlのgoogleAnalyticsのセクションに貼り付けると測定が可能になります．

貼り付けた後は必ずビルドしてください．

目次（Table of Content）について

Stackでは，記事に目次(TOC：Table of Content)を自動でつけてくれる機能があります．

ただし，どうやら記事の文量が少ないとつけてくれないようです．

記事のURLについて

記事のURLはデフォルトでは，baseURL + 記事title で設定されています．

記事のURLを指定したい場合は，以下の例のように記事の先頭にslugというタグを追加してください．

1
2
3
4


---
title: 記事のタイトル
slug: URL
---