Skip to content

Commit 9c25049

Browse files
committed
docs: upgrade to Eureka 0.9.3
1 parent 2cdf1c3 commit 9c25049

File tree

4 files changed

+57
-41
lines changed

4 files changed

+57
-41
lines changed

en/CHANGELOG.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,12 @@ draft: false
1313
weight: 7
1414
---
1515

16+
## 0.9.3 (2022-06-01)
17+
18+
### Bug Fixes
19+
20+
- update resource cache for Hugo 0.100 ([749f68c](https://github.com/wangchucheng/hugo-eureka/commit/749f68cfef98e04dd40542e7d298d87648009a6f))
21+
1622
## 0.9.2 (2022-05-27)
1723

1824
### Bug Fixes

en/getting-started.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
---
22
title: Getting Started
3-
description: ''
4-
summary: ''
3+
description: ""
4+
summary: ""
55
toc: true
66
authors: []
77
tags: []
88
categories: []
99
series: []
10-
date: '2020-10-19T22:50:23+08:00'
11-
lastmod: '2020-10-19T22:50:23+08:00'
10+
date: "2020-10-19T22:50:23+08:00"
11+
lastmod: "2020-10-19T22:50:23+08:00"
1212
draft: false
1313
weight: 1
1414
---
@@ -92,6 +92,8 @@ After completing the above steps, use the following command to preview the proje
9292
hugo server
9393
```
9494

95+
> If you encounter error like `Error: Error building site: POSTCSS: failed to transform "css/eureka.css" (text/css): resource "css/css/eureka.css_09b9b8e200b8c676e85ddca87a9596ca" not found in file cache`, please try to update Hugo to 0.100.0 or above.
96+
9597
Drafts will not be deployed by Hugo, so you need to set the `draft` property of the content header to `false` or use `hugo server -D` to preview the website.
9698

9799
If you are not familiar with the basic usage of Hugo or want to know more about Hugo, you can refer to [Hugo Basic Usage](https://gohugo.io/getting-started/usage/).
@@ -117,9 +119,9 @@ authors: []
117119
tags: []
118120
categories: []
119121
series: []
120-
date: '2020-10-20T10:30:48+08:00'
121-
lastmod: '2020-10-20T10:30:48+08:00'
122-
featuredImage: ''
122+
date: "2020-10-20T10:30:48+08:00"
123+
lastmod: "2020-10-20T10:30:48+08:00"
124+
featuredImage: ""
123125
draft: false
124126
---
125127
```
@@ -161,4 +163,4 @@ Similar to `hugo server`, `hugo` will not generate draft content. The generated
161163
<div class="flex flex-col items-center">
162164
<span class="mb-4">Please <a href="https://github.com/wangchucheng/hugo-eureka">Star</a> Eureka if you like it!</span>
163165
<a class="github-button" href="https://github.com/wangchucheng/hugo-eureka" data-size="large" aria-label="Star wangchucheng/hugo-eureka on GitHub">Star</a>
164-
</div>
166+
</div>

zh/CHANGELOG.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,12 @@ draft: false
1313
weight: 7
1414
---
1515

16+
## 0.9.3 (2022-06-01)
17+
18+
### Bug Fixes
19+
20+
- update resource cache for Hugo 0.100 ([749f68c](https://github.com/wangchucheng/hugo-eureka/commit/749f68cfef98e04dd40542e7d298d87648009a6f))
21+
1622
## 0.9.2 (2022-05-27)
1723

1824
### Bug Fixes

zh/getting-started.md

Lines changed: 35 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,53 +1,53 @@
11
---
22
title: 入门
3-
description: ''
4-
summary: ''
3+
description: ""
4+
summary: ""
55
toc: true
66
authors: []
77
tags: []
88
categories: []
99
series: []
10-
date: '2020-10-19T22:50:23+08:00'
11-
lastmod: '2020-10-19T22:50:23+08:00'
10+
date: "2020-10-19T22:50:23+08:00"
11+
lastmod: "2020-10-19T22:50:23+08:00"
1212
draft: false
1313
weight: 1
1414
---
1515

16-
在本文中你将了解到如何快速搭建一个Eureka主题的Hugo网站
16+
在本文中你将了解到如何快速搭建一个 Eureka 主题的 Hugo 网站
1717

1818
<!--more-->
1919

20-
> 如果你的区域存在难以访问GitHub的问题,你可以将所有涉及到GitHub的网址替换为[Gitee镜像](https://gitee.com/wangchucheng/hugo-eureka/)。例如将`https://github.com/wangchucheng/hugo-eureka/`替换为`https://gitee.com/wangchucheng/hugo-eureka/`即可。
20+
> 如果你的区域存在难以访问GitHub的问题,你可以将所有涉及到GitHub的网址替换为[Gitee镜像](https://gitee.com/wangchucheng/hugo-eureka/)。例如将`https://github.com/wangchucheng/hugo-eureka/`替换为`https://gitee.com/wangchucheng/hugo-eureka/`即可。
2121
2222
## 前提
2323

24-
正常使用Eureka需要安装以下内容
24+
正常使用 Eureka 需要安装以下内容
2525

2626
- [Git](https://git-scm.com/)
2727
- [Hugo v0.74.0+](https://gohugo.io/getting-started/installing/)
28-
- [Go 1.12+](https://golang.org/dl/) (使用Hugo Modules安装时)
28+
- [Go 1.12+](https://golang.org/dl/) (使用 Hugo Modules 安装时)
2929

3030
## 快速安装
3131

32-
Eureka可以通过使用Github模板[Hugo Eureka Starters](https://github.com/wangchucheng/hugo-eureka-starters)快速安装。
32+
Eureka 可以通过使用 Github 模板[Hugo Eureka Starters](https://github.com/wangchucheng/hugo-eureka-starters)快速安装。
3333

3434
使用此种方式时请点击页面上的`Use this template`按钮,并设置你的仓库信息。
3535

36-
如果你希望使用Hugo Modules的方式进行安装,在输入信息后直接点击`Create repository from template`按钮即可。
36+
如果你希望使用 Hugo Modules 的方式进行安装,在输入信息后直接点击`Create repository from template`按钮即可。
3737

38-
如果你希望使用Git Submodules的方式进行安装,请参考手动安装的[使用Git Submodules安装](#git-submodules安装)
38+
如果你希望使用 Git Submodules 的方式进行安装,请参考手动安装的[使用 Git Submodules 安装](#git-submodules安装)
3939

4040
## 手动安装
4141

42-
Eureka可以快速集成于Hugo项目中,目前Eureka可以通过[Git Submodules](#使用git-submodules安装)[Hugo Modules](#使用hugo-modules安装)两种方式进行安装。
42+
Eureka 可以快速集成于 Hugo 项目中,目前 Eureka 可以通过[Git Submodules](#使用git-submodules安装)[Hugo Modules](#使用hugo-modules安装)两种方式进行安装。
4343

44-
[Hugo Modules](#使用hugo-modules安装)需要[Go 1.12](https://golang.org/dl/)及以上版本,推荐所有拥有或愿意安装Go的用户使用此方式进行安装
44+
[Hugo Modules](#使用hugo-modules安装)需要[Go 1.12](https://golang.org/dl/)及以上版本,推荐所有拥有或愿意安装 Go 的用户使用此方式进行安装
4545

46-
### 使用Git Submodules安装
46+
### 使用 Git Submodules 安装
4747

4848
> 如果当前环境下拥有或愿意安装[Go 1.12](https://golang.org/dl/)及以上版本,可以使用更为方便快捷的[Hugo Modules](#使用hugo-modules安装)进行安装。
4949
50-
使用Git Submodules安装时您只需在项目位置下执行
50+
使用 Git Submodules 安装时您只需在项目位置下执行
5151

5252
```shell
5353
git submodule add https://github.com/wangchucheng/hugo-eureka.git themes/eureka
@@ -62,23 +62,25 @@ git checkout <eureka_version>
6262

6363
接下来,将[exampleSite](https://github.com/wangchucheng/hugo-eureka/tree/master/exampleSite)中的`config`文件夹复制到项目根目录下,对`config`文件夹的内容进行配置。配置后删除原先的`config.toml`文件即可。
6464

65-
如果你是新建的Hugo项目`content`文件夹下默认没有内容。你可以将[exampleSite](https://github.com/wangchucheng/hugo-eureka/tree/master/exampleSite)中的`content`文件夹复制到项目根目录下预览主题效果。
65+
如果你是新建的 Hugo 项目`content`文件夹下默认没有内容。你可以将[exampleSite](https://github.com/wangchucheng/hugo-eureka/tree/master/exampleSite)中的`content`文件夹复制到项目根目录下预览主题效果。
6666

6767
完成以上步骤后使用以下命令即可在浏览器中预览项目:
6868

6969
```shell
7070
hugo server
7171
```
7272

73-
草稿不会被Hugo部署,所以你需要将内容头部的`draft`属性设为`false`或使用`hugo server -D`预览网站
73+
> 如果你遇到了例如`Error: Error building site: POSTCSS: failed to transform "css/eureka.css" (text/css): resource "css/css/eureka.css_09b9b8e200b8c676e85ddca87a9596ca" not found in file cache`的报错请将 Hugo 升级至 0.100.0 或以上版本
7474
75-
如果你对Hugo的基础用法并不熟悉或想了解更多Hugo相关的内容,可以参考[Hugo Basic Usage](https://gohugo.io/getting-started/usage/)
75+
草稿不会被 Hugo 部署,所以你需要将内容头部的`draft`属性设为`false`或使用`hugo server -D`预览网站
7676

77-
### 使用Hugo Modules安装
77+
如果你对 Hugo 的基础用法并不熟悉或想了解更多 Hugo 相关的内容,可以参考[Hugo Basic Usage](https://gohugo.io/getting-started/usage/)
7878

79-
使用Hugo Modules安装Eureka时需要[Go 1.12](https://golang.org/dl/)及以上版本,推荐所有满足依赖要求的用户使用此方式进行安装。
79+
### 使用 Hugo Modules 安装
8080

81-
首先,在项目根目录下初始化一个新的Hugo Module:
81+
使用 Hugo Modules 安装 Eureka 时需要[Go 1.12](https://golang.org/dl/)及以上版本,推荐所有满足依赖要求的用户使用此方式进行安装。
82+
83+
首先,在项目根目录下初始化一个新的 Hugo Module:
8284

8385
```shell
8486
hugo mod init <module_name>
@@ -88,21 +90,21 @@ hugo mod init <module_name>
8890

8991
最后将`config/_default/config.yaml`中的`theme: eureka`注释并将`theme: wangchucheng.com/hugo-eureka`取消注释。配置后删除原先的`config.toml`文件即可。
9092

91-
如果你是新建的Hugo项目`content`文件夹下默认没有内容。你可以将[exampleSite](https://github.com/wangchucheng/hugo-eureka/tree/master/exampleSite)中的`content`文件夹复制到项目根目录下预览主题效果。
93+
如果你是新建的 Hugo 项目`content`文件夹下默认没有内容。你可以将[exampleSite](https://github.com/wangchucheng/hugo-eureka/tree/master/exampleSite)中的`content`文件夹复制到项目根目录下预览主题效果。
9294

9395
完成以上步骤后使用以下命令即可在浏览器中预览项目:
9496

9597
```shell
9698
hugo server
9799
```
98100

99-
草稿不会被Hugo部署,所以你需要将内容头部的`draft`属性设为`false`或使用`hugo server -D`预览网站。
101+
草稿不会被 Hugo 部署,所以你需要将内容头部的`draft`属性设为`false`或使用`hugo server -D`预览网站。
100102

101-
如果你对Hugo的基础用法并不熟悉或想了解更多Hugo相关的内容,可以参考[Hugo Basic Usage](https://gohugo.io/getting-started/usage/)
103+
如果你对 Hugo 的基础用法并不熟悉或想了解更多 Hugo 相关的内容,可以参考[Hugo Basic Usage](https://gohugo.io/getting-started/usage/)
102104

103105
## 添加内容
104106

105-
安装Eureka后,即可开始向网站中添加相应内容。你可以在`content`文件夹中手动创建文件并添加信息。同时你也可以使用`hugo new`为你完成以上内容。
107+
安装 Eureka 后,即可开始向网站中添加相应内容。你可以在`content`文件夹中手动创建文件并添加信息。同时你也可以使用`hugo new`为你完成以上内容。
106108

107109
在项目中添加一篇默认类型的内容:
108110

@@ -121,28 +123,28 @@ authors: []
121123
tags: []
122124
categories: []
123125
series: []
124-
date: '2020-10-20T10:30:48+08:00'
125-
lastmod: '2020-10-20T10:30:48+08:00'
126-
featuredImage: ''
126+
date: "2020-10-20T10:30:48+08:00"
127+
lastmod: "2020-10-20T10:30:48+08:00"
128+
featuredImage: ""
127129
draft: false
128130
---
129131
```
130132

131133
你可以对其中的值进行修改或在文件最后的`+++`后开始编写你的正文内容。
132134

133-
Eureka还为你提供了其他类型的模板,你可以通过`-k KIND`指定类型:
135+
Eureka 还为你提供了其他类型的模板,你可以通过`-k KIND`指定类型:
134136

135137
```shell
136138
hugo new -k authors authors/new-author
137139
```
138140

139141
这会在`content/authors`文件夹下生成作者类型的内容。
140142

141-
Eureka提供的全部内容类型可以参考[archetypes](https://github.com/wangchucheng/hugo-eureka/tree/master/archetypes)
143+
Eureka 提供的全部内容类型可以参考[archetypes](https://github.com/wangchucheng/hugo-eureka/tree/master/archetypes)
142144

143145
## 修改配置
144146

145-
由于Eureka致力于提供一个高度可定制且功能丰富的主题,因此我们将自动生成的`config.toml`文件替换为`config`文件夹以提供更清晰的结构。你可以修改配置文件中的任意内容:
147+
由于 Eureka 致力于提供一个高度可定制且功能丰富的主题,因此我们将自动生成的`config.toml`文件替换为`config`文件夹以提供更清晰的结构。你可以修改配置文件中的任意内容:
146148

147149
```yaml
148150
title: My Own Title
@@ -158,11 +160,11 @@ title: My Own Title
158160
hugo
159161
```
160162

161-
类似于`hugo server``hugo`不会生成草稿内容。生成的网页位于`public`文件夹内。你可以将其部署于Github Pages或Netlify等静态网页部署平台上
163+
类似于`hugo server``hugo`不会生成草稿内容。生成的网页位于`public`文件夹内。你可以将其部署于 Github Pages 或 Netlify 等静态网页部署平台上
162164

163165
---
164166

165167
<div class="flex flex-col items-center">
166168
<span class="mb-4">喜欢Eureka就请点个<a href="https://github.com/wangchucheng/hugo-eureka">Star</a>吧!</span>
167169
<a class="github-button" href="https://github.com/wangchucheng/hugo-eureka" data-size="large" aria-label="Star wangchucheng/hugo-eureka on GitHub">Star</a>
168-
</div>
170+
</div>

0 commit comments

Comments
 (0)