📌 Hugo PaperMod 與 GitHub Pages

  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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138

baseURL: "https://examplesite.com/"
title: ExampleSite
defaultContentLanguage: zh-tw
paginate: 5 # 每頁顯示的文章數
theme: PaperMod

enableInlineShortcodes: true
enableRobotsTXT: true # 是否生成 robots.txt 檔案
buildDrafts: false
buildFuture: false
buildExpired: false
enableEmoji: true
pygmentsUseClasses: true
#googleAnalytics: UA-123-45

minify:
  disableXML: true
  #minifyOutput: true

params:
  env: production # to enable google analytics, opengraph, twitter-cards and schema.
  title: ExampleSite
  description: "ExampleSite description"
  keywords: [Blog, Portfolio, PaperMod]
  author: Me
  # author: ["Me", "You"] # multiple authors
  images: ["<link or path of image for opengraph, twitter-cards>"]
  DateFormat: "2006-01-02"
  defaultTheme: auto # dark, light
  #disableThemeToggle: true

  ShowReadingTime: true
  ShowShareButtons: true # 顯示分享文章按鈕
  ShowPostNavLinks: true
  ShowBreadCrumbs: true # 於頂部顯示文章路徑
  ShowCodeCopyButtons: true # 顯示代碼複製按鈕
  ShowWordCount: true
  ShowRssButtonInSectionTermList: true
  UseHugoToc: true
  #disableSpecial1stPost: true
  displayFullLangName: true
  disableScrollToTop: false
  #comments: false # 評論
  hidemeta: false # 是否隱藏文章發布日期、作者...
  hideSummary: false
  showtoc: true # 是否顯示目錄
  tocopen: true # 是否打開目錄

  assets:
    disableHLJS: true
    # disableHLJS: true # to disable highlight.js
    # disableFingerprinting: true
    favicon: "<link / abs url>"
    favicon16x16: "<link / abs url>"
    favicon32x32: "<link / abs url>"
    apple_touch_icon: "<link / abs url>"
    safari_pinned_tab: "<link / abs url>"

  label:
    text: "Home"
    icon: /apple-touch-icon.png
    iconHeight: 35

  # profile-mode
  profileMode:
    enabled: false # needs to be explicitly set
    title: ExampleSite
    subtitle: "This is subtitle"
    imageUrl: "<img location>"
    imageWidth: 120
    imageHeight: 120
    imageTitle: my image
    buttons:
      - name: Posts
        url: posts
      - name: Tags
        url: tags

  # home-info mode
  homeInfoParams:
    Title: "Hi there \U0001F44B"
    Content: Welcome to my blog

  socialIcons:
    - name: twitter
      url: "https://twitter.com/"
    - name: email
      url: "mailto:"
    - name: github
      url: "https://github.com/"

  #analytics:
  #  google:
  #    SiteVerificationTag: "XYZabc"

  cover:
    hidden: true # hide everywhere but not in structured data
    hiddenInList: true # hide on list pages and home
    hiddenInSingle: false # hide on single page

  # for search
  # https://fusejs.io/api/options.html
  #fuseOpts:
    #isCaseSensitive: false
    #shouldSort: true
    #location: 0
    #distance: 1000
    #threshold: 0.4
    #minMatchCharLength: 0
    #keys: ["title", "permalink", "summary", "content"]
menu:
  main:
    - identifier: categories
      name: categories
      url: /categories/
      weight: 10
    - identifier: tags
      name: tags
      url: /tags/
      weight: 20
    - identifier: example
      name: example.org
      url: https://example.org
      weight: 30


# Read: https://github.com/adityatelange/hugo-PaperMod/wiki/FAQs#using-hugos-syntax-highlighter-chroma
markup:
  goldmark:
    renderer:
      unsafe: true
  highlight:
    noClasses: false
    # anchorLineNos: true
    # codeFences: true
    # guessSyntax: true
    # lineNos: true
    # style: monokai

1
2
3
4
5
6
7
8

cd public
git init
git remote add origin git@github.com:diy99/diy99.github.io.git
git add .
git commit -m 'Initial'
git branch -M main
git push -u origin main
cd ..

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

#!/bin/bash
# Linux: chmod +x publish.sh
# sh publish.sh
hugo
cd public
#git init
#git remote add origin git@github.com:your-username/your-username.github.io.git
git add .
git commit -m 'Update'
#git branch -M main
#git push -u origin main
git push
cd ..

 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

---
title: '{{ replace .File.ContentBaseName "-" " " | title }}'
date: {{ .Date }}
draft: false # 文章草稿狀態
summary: "" # 首頁顯示的文字總結段落
categories: ["分類1", "分類2"]
tags: ["標籤1", "標籤2"]
#author: ["Author"]
#keywords: [Blog, PaperMod] # 標示文章的關鍵字
description: "" #描述
weight: # 輸入1可以置頂文章，不填就按時間
isCJKLanguage: true # 是否是中文(chinese,japanese,korea) 字數判斷用
comments: false #是否展示評論
showToc: true # 顯示目錄
TocOpen: false # 自動打開目錄
UseHugoToc: true
hidemeta: false # 是否隱藏發布日期、作者
disableShare: false # 取消社群分享文章欄
showbreadcrumbs: true # 於頂部顯示文章路徑
ShowWordCounts: true
ShowReadingTime: true

cover:
    image: "" # 封面圖片路徑 
    alt: "<alt text>" # alt text
    caption: "" # 封面圖片描述
    relative: false  # when using page bundles set this to true
    hidden: false # only hide on current single page
---