1

brew install hugo

1

hugo version

1

hugo new site <your-site-name>

1

cd <your-site-name>

1
2

git init # Gitリポジトリを作成
git submodule add https://github.com/rhazdon/hugo-theme-stack.git themes/stack # テーマをサブモジュールとして追加

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

baseURL = "https://<your-custom-domain>/" # 独自ドメインを設定
languageCode = "ja"
title = "My Tech Blog"
theme = "hugo-theme-stack" # フォルダ名と一致させる
copyright = "<your-name>" # フッターの著作権表記

# ページネーション（記事一覧の件数）
[pagination]
  pagerSize = 6

# ---------------------------------------------------------------------
# メニュー設定 (サイドバーのリンク)
# ---------------------------------------------------------------------
[[menu.main]]
  name = "Home"
  url = "/"
  weight = 1
  [menu.main.params]
    icon = "home" # アイコン名は https://icons.getbootstrap.com/ で確認可能

[[menu.main]]
  name = "Archives"
  url = "/archives/"
  weight = 2
  [menu.main.params]
    icon = "folder"

[[menu.main]]
  name = "GitHub"
  url = "https://github.com/<your-github-username>/"
  weight = 3
  [menu.main.params]
    icon = "brand-github"

[[menu.main]]
  name = "X (Twitter)"
  url = "https://x.com/" # XのURL
  weight = 4
  [menu.main.params]
    icon = "twitter"

# ---------------------------------------------------------------------
# Markdown設定 (数式・HTML・ハイライト)
# ---------------------------------------------------------------------
[markup]
  [markup.goldmark.renderer]
    unsafe = true # HTML埋め込み許可

  # 数式 ($$ ... $$) の設定
  [markup.goldmark.extensions.passthrough]
    enable = true
    [markup.goldmark.extensions.passthrough.delimiters]
      block = [['\[', '\]'], ['$$', '$$']]
      inline = [['\(', '\)'], ['$', '$']]

  [markup.highlight]
    noClasses = false
    codeFences = true
    guessSyntax = true
    lineNos = true
    style = "monokai" # コードの色テーマ（好きに変えられます）
    tabWidth = 4

# ---------------------------------------------------------------------
# Stack独自のパラメータ
# ---------------------------------------------------------------------
[params]
  customCSS = ["custom.css"]
  mainSections = ["post"]
  featuredImageField = "image"
  rssFullContent = true
  favicon = "./favicon/favicon.ico" # ★static/favicon.ico に画像を置いてください

  # 日付フォーマット
  [params.dateFormat]
    published = "2006/01/02"
    lastUpdated = "2006/01/02"

  # --- 左サイドバーの設定 ---
  [params.sidebar]
    emoji = ""
    subtitle = "技術のことについてつらつらと書いていきます"
    
    [params.sidebar.avatar]
      enabled = true
      local = true
      src = "img/icon.png" # ★static/img/icon.png に画像を置いてください

  # --- フッター ---
  [params.footer]
    since = 2025
    customText = "Made with Hugo & Stack"

  # --- 記事ページの設定 ---
  [params.article]
    math = true       # 数式ON
    toc = true        # 目次ON
    readingTime = true
    license = { enabled = true, default = "Licensed under CC BY 4.0" }

  # --- 右サイドバーのウィジェット ---
  [[params.widgets.homepage]]
    type = "search" # 検索窓

  [[params.widgets.homepage]]
    type = "archives" # アーカイブ
    [params.widgets.homepage.params]
      limit = 5

  [[params.widgets.homepage]]
    type = "categories" # カテゴリ
    [params.widgets.homepage.params]
      limit = 10

  [[params.widgets.homepage]]
    type = "tag-cloud" # タグクラウド
    [params.widgets.homepage.params]
      limit = 10

  # 記事ページには目次を表示
  [[params.widgets.page]]
    type = "toc"

1
2
3
4
5

git remote add origin <your-github-repo-url>
git branch -M main
git add .
git commit -m "Initial commit"
git push -u origin main

1
2
3
4
5
6
7
8

hugo -D --destination ../<your-github-username>.github.io
cd ../<your-github-username>.github.io
git init
git remote add origin <your-github-io-repo-url>
git branch -M main
git add .
git commit -m "Initial commit"
git push -u origin main

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

name: github pages

on:
  push:
    branches:
      - main  # ソースコードがあるブランチ名（違えば変更してください）

jobs:
  deploy:
    runs-on: ubuntu-latest
    concurrency:
      group: ${{ github.workflow }}-${{ github.ref }}
    steps:
      - uses: actions/checkout@v4
        with:
          submodules: recursive  # ★重要: Stackテーマを確実に持ってくる設定
          fetch-depth: 0

      - name: Setup Hugo
        uses: peaceiris/actions-hugo@v2
        with:
          hugo-version: 'latest' # ★重要: Stackは最新版が必要です
          extended: true         # ★重要: StackはSCSSを使うためextended版が必須です

      - name: Build
        run: hugo --minify

      - name: Deploy
        uses: peaceiris/actions-gh-pages@v3
        with:
          deploy_key: ${{ secrets.ACTIONS_DEPLOY_KEY }}
          external_repository: <your-github-username>/<your-github-username>.github.io
          publish_branch: main   # ユーザーサイト(username.github.io)はmainブランチで公開されます
          publish_dir: ./public
          # CNAMEファイルも自動生成します
          # baseURLと合わせるため、ネイキッドドメイン(wwwなし)を推奨しますが
          # お好みで www.swimmy2611.com にしても動きます
          cname: <your-custom-domain>

1

ssh-keygen -t ed25519 -C "github-pages-deploy-key" -f gh-pages-deploy-key -N ""