# Introduce

hugo-theme-shoka 是从 hexo-theme-shoka 移植过来的主题。目前支持以下功能:

  • 随机封面图
  • 暗黑模式
  • 各种短代码支持
  • Pjax 支持
  • 图片懒加载,fancybox 支持
  • 评论支持 waline
  • 搜索支持 Algolia
  • 音乐播放器支持

# Quick Start

请直接拷贝下面的基础配置文件至 config.yml, 再自行修改具体配置

  1baseURL:
  2languageCode: zh-cn
  3defaultContentLanguage: zh-cn
  4title: title
  5# 设置主题
  6theme: "hugo-theme-shoka"
  7
  8author:
  9  name: birdgg
 10
 11enableEmoji: true
 12
 13hasCJKLanguage: true
 14summaryLength: 50
 15
 16paginate: 8
 17
 18# 请不要添加 categories, 因为需要使用 hugo section 支持多级分类
 19taxonomies:
 20  tag: tags
 21  series: series
 22
 23permalinks:
 24  posts: /:slug
 25  tags: /tags/:slug/
 26
 27markup:
 28  highlight:
 29    style: 'doom-one2'
 30    guessSyntax: true
 31    lineNumbersInTable: false
 32    lineNos: true
 33    codeFences: true
 34    tabWidth: 2
 35    noClasses: false
 36  goldmark:
 37    renderer:
 38      unsafe: true # enable html in markdown
 39  tableOfContents:
 40    endLevel: 2
 41    ordered: true
 42    startLevel: 2
 43
 44menu:
 45  main:
 46  - identifier: home
 47    name: 首页
 48    params:
 49      icon: ic i-home
 50    weight: 10
 51    url: /
 52  - identifier: articles
 53    name: 文章
 54    params:
 55      icon: ic i-feather
 56    weight: 40
 57  - identifier: archives
 58    name: 归档
 59    params:
 60      icon: ic i-list-alt
 61    url: /archives/
 62    parent: articles
 63    weight: 1
 64  - identifier: categories
 65    name: 分类
 66    params:
 67      icon: ic i-th
 68    url: /categories/
 69    parent: articles
 70    weight: 2
 71  - identifier: tags
 72    name: 标签
 73    params:
 74      icon: ic i-tags
 75    url: /tags/
 76    parent: articles
 77    weight: 3
 78  - identifier: about
 79    name: 关于
 80    params:
 81      icon: ic i-user
 82    url: /about
 83  - identifier: links
 84    name: 链环
 85    params:
 86      icon: ic i-magic
 87  - identifier: friends
 88    name: 友链
 89    params:
 90      icon: ic i-heart
 91    url: /friends/
 92    parent: links
 93  - identifier: websites
 94    name: 网址
 95    params:
 96      icon: ic i-star
 97    url: /webstack/
 98    parent: links
 99
100outputs:
101  home: ["HTML", "RSS",  "Algolia"]
102
103outputFormats:
104  Algolia:
105    baseName: algolia
106    isPlainText: true
107    mediaType: application/json
108    notAlternative: true
109
110params:
111  alternate: Alternate
112  subtitle: Subtitle
113  description: Description
114  statics: /
115  # when your site url is like 'http://site.com/child', set root as '/child/'
116  root: /
117  since: 2022
118
119  sidebar:
120    avatar: avatar.jpg
121    position: right
122
123  # 开启图片 fancybox 支持
124  fancybox: true
125
126  # 开启随机文章和最近评论支持
127  widgets:
128    random_posts: true
129    recent_comments: true
130
131  # 打赏功能,请把图片添加在 /static/images 目录下
132  reward:
133    enable: true
134    account:
135      wechatpay: wechatpay.jpg
136      alipay: alipay.png
137
138  # 社交媒体添加
139  social:
140    github:
141      icon: ic i-github
142      link: https://github.com
143    twitter:
144      icon: ic i-twitter
145      link: https://twitter.com
146
147  # algolia 搜索支持
148  algolia:
149    appid:
150    apikey:
151    indexname:
152    hits: 10
153
154 # 如果使用 github, 可以在这里添加 jsdeliver cdn 来加速css,js 文件
155  publicCDN: https://cdn.jsdelivr.net/gh/birdgg/hugo-theme-shoka@gh-pages
156
157  opengraph:
158    twitter:
159
160  # waline 评论配置
161  waline:
162    serverURL:
163    visitor: true   # 文章访问量统计
164    pageview: true
165    lang: zh-CN     # 语言,默认 zh-CN
166    login: enable   # 登录模式状态,默认值 enable,force 可以强制登录
167    wordLimit: 0    # 评论字数限制,0 为不限制,默认值为 0
168    pageSize: 10    # 评论列表分页,数字为条数,默认值 10
169    highlight: true # 代码高亮,默认 true
170    meta: ['nick', 'mail', 'link'] # 评论者相关属性,默认 ['nick', 'mail', 'link']
171    requiredMeta: ['nick', 'mail'] #设置评论者属性必填项,默认 [](即匿名)
172    placeholder: ヽ(○´∀`)ノ♪
173    copyright: true # 是否显示页脚版权信息
174    emoji: [
175      'https://cdn.jsdelivr.net/gh/walinejs/emojis@1.0.0/bilibili',
176    ]
更新于 阅读次数

请我喝[茶]~( ̄▽ ̄)~*

birdgg 支付宝

支付宝

birdgg 微信支付

微信支付