调整文件名称

Author: xiaoping378

content/docs/1-Site/create_site.md content/docs/1-Site/1-create_site.mdcontent/docs/1-Site/create_site.md renamed to content/docs/1-Site/1-create_site.md

@@ -4,16 +4,16 @@ title: "自动托管markdown"
 linkTitle: "自动托管markdown"
 weight: 2
 description: >
-  描述如何利用github的CI/CD实现自动更新站点。
+  描述如何利用github的CI/CD实现自动更新并托管站点。
 ---
 
 {{% pageinfo %}}
-利用github actions和pages实现自动更新托管内容，本站点已实现commit md后，自动更新[码云page](https://xiaoping378.gitee.io/)和[Github page](https://xiaoping378.github.io/)页面。
+利用github actions和pages实现自动更新托管内容，本站点已实现commit md后，~~自动更新[码云page](https://xiaoping378.gitee.io/)和~~[Github page](https://xiaoping378.github.io/)页面。
 {{% /pageinfo %}}
 
 ## 项目仓库的名字由来
 
-本源码仓之所以起如此长的名字，完全是因为github pages的不成熟，不然会带个小尾巴：
+本源码仓之所以起如此长的名字，完全是因为github pages的工作机制决定的，不然会带个小尾巴：
 
 如果叫 _blog_, github的托管页面的访问地址会是 _xiaoping378.github.io/blog_，这也没什么，但会和hugo的[static机制](/docs/1-site/add_content/#图片路径问题)出现冲突。
 

content/docs/1-Site/actions_pages.md content/docs/1-Site/2-actions_pages.mdcontent/docs/1-Site/actions_pages.md renamed to content/docs/1-Site/2-actions_pages.md

@@ -1,59 +1,59 @@
----
-tags: ["hugo"]
-title: "编写文章注意项"
-linkTitle: "编写文章注意项"
-weight: 3
-description: >
-  描述在hugo的Docsy主题下如何编写文章和添加图片路径处理等相关的技巧。
----
-
-{{% pageinfo %}}
-本章节主要描述日常编写文章的注意事项和docsy主题内的使用技巧。
-{{% /pageinfo %}}
-
-
-## 编写markdown
-
-### 图片路径问题
-
-习惯md文件中的图片路径写成`![](/images/file.png)` ，但hugo中图片实际要存放到`/static/images/`路径下，hugo会自动渲染到站点的根路径`/`上。
-
-这样的话，无法在编辑器中预览md了，有两种玩法如下：
-
-- 可以使用一个临时目录，把图片和md文件放到同一目录，编写完毕后，再把图片和md文件放置上述合适的目录位置上。
-- 日常一直启用`hugo server`编写文章，放弃编辑器中预览md，后面还会有别的坑....
-
-推荐后者，本人日常使用VSCode编写md，和代码开发同款，这里推荐安装`mushan.vscode-paste-image`扩展，再额外如下配置：
-```json
-    "pasteImage.namePrefix": "${currentFileNameWithoutExt}-",
-    "pasteImage.path": "${projectRoot}/static/images/",
-    "pasteImage.basePath": "${projectRoot}",
-    "pasteImage.insertPattern": "${imageSyntaxPrefix}/images/${imageFileName}${imageSyntaxSuffix}"
-```
-
-日常编写文章，`Alt+A`截图，`Ctrl+Alt+A`粘贴到md文件，和hugo的配合，完美...
-
-### SEO优化关注点
-日常文章编写，如下部分要精准描述，Google搜索引擎推荐使用`description`的meta标签告诉它页面内容的，Docsy主题会自动把红框部分填充到`layouts/partials/head.html`中。
-
-![](/images/add_content-2022-01-25-09-38-48.png)
-
-hugo解析编译后，html页面会如下呈现：
-
-![](/images/add_content-2022-01-25-09-37-12.png)
-
-### 日常编写注意事项
-
-#### md文件中相互引用内容的路径要记得对应到站点html的路径上
-
-比如此处引用`自动托管markdown`文章，按照md习惯写,虽然编辑器上可以正常打开，但hugo渲染后的页面是404的。
-- `[引用](./actions_pages.md)` 需要改成 `[引用](../actions_pages)`
-- `[引用](/content/docs/1-site/actions_pages.md)` 需要改成 `[引用](/docs/1-site/actions_pages)`
-
-
-
-不定时更新注意事项。日常编写，建议本机启用`hugo server`实时预览，
-
-#### 文章weight的使用
-
+---
+tags: ["hugo"]
+title: "编写文章技巧"
+linkTitle: "编写文章技巧"
+weight: 3
+description: >
+  描述在hugo的Docsy主题下如何编写文章和添加图片路径处理等相关的技巧。
+---
+
+{{% pageinfo %}}
+本章节主要描述日常编写文章的注意事项和docsy主题内的使用技巧。
+{{% /pageinfo %}}
+
+
+## 编写markdown
+
+### 图片路径问题
+
+习惯md文件中的图片路径写成`![](/images/file.png)` ，但hugo中图片实际要存放到`/static/images/`路径下，hugo会自动渲染到站点的根路径`/`上。
+
+这样的话，无法在编辑器中预览md了，有两种玩法如下：
+
+- 可以使用一个临时目录，把图片和md文件放到同一目录，编写完毕后，再把图片和md文件放置上述合适的目录位置上。
+- 日常一直启用`hugo server`编写文章，放弃编辑器中预览md，后面还会有别的坑....
+
+推荐后者，本人日常使用VSCode编写md，和代码开发同款，这里推荐安装`mushan.vscode-paste-image`扩展，再额外如下配置：
+```json
+    "pasteImage.namePrefix": "${currentFileNameWithoutExt}-",
+    "pasteImage.path": "${projectRoot}/static/images/",
+    "pasteImage.basePath": "${projectRoot}",
+    "pasteImage.insertPattern": "${imageSyntaxPrefix}/images/${imageFileName}${imageSyntaxSuffix}"
+```
+
+日常编写文章，`Alt+A`截图，`Ctrl+Alt+A`粘贴到md文件，和hugo的配合，完美...
+
+### SEO优化关注点
+日常文章编写，如下部分要精准描述，Google搜索引擎推荐使用`description`的meta标签告诉它页面内容的，Docsy主题会自动把红框部分填充到`layouts/partials/head.html`中。
+
+![](/images/add_content-2022-01-25-09-38-48.png)
+
+hugo解析编译后，html页面会如下呈现：
+
+![](/images/add_content-2022-01-25-09-37-12.png)
+
+### 日常编写注意事项
+
+#### md文件中相互引用内容的路径要记得对应到站点html的路径上
+
+比如此处引用`自动托管markdown`文章，按照md习惯写,虽然编辑器上可以正常打开，但hugo渲染后的页面是404的。
+- `[引用](./actions_pages.md)` 需要改成 `[引用](../actions_pages)`
+- `[引用](/content/docs/1-site/actions_pages.md)` 需要改成 `[引用](/docs/1-site/actions_pages)`
+
+
+
+不定时更新注意事项。日常编写，建议本机启用`hugo server`实时预览，
+
+#### 文章weight的使用
+
 文章开头的`weight`部分决定了目录中的排序，推荐新开的系列文章，从两位数开始递增，比如`30`, 以后老系列有更新的时候，免去批量修改调整排序的麻烦。

content/docs/1-Site/add_content.md content/docs/1-Site/3-add_content.mdcontent/docs/1-Site/add_content.md renamed to content/docs/1-Site/3-add_content.md

@@ -0,0 +1,238 @@
+---
+title: "该主题的Markdown特色语法"
+date: 2017-01-05
+weight: 4
+description: >
+  docsy主题中Markdown的常见语法样例展示.
+---
+
+{{% pageinfo %}}
+这是一个占位页面。请用您自己的内容替换它。
+{{% /pageinfo %}}
+
+文本可以是 **粗体**、_斜体_ 或 ~~删除线~~。[链接](https://gohugo.io) 应该是蓝色的，没有下划线（除非鼠标悬停在其上）。
+
+段落之间应该有空白。Vape migas chillwave sriracha poutine try-hard distillery。Tattooed shabby chic small batch, pabst art party heirloom letterpress air plant pop-up。Sustainable chia skateboard art party banjo cardigan normcore affogato vexillologist quinoa meggings man bun master cleanse shoreditch readymade。Yuccie prism four dollar toast tbh cardigan iPhone, tumblr listicle live-edge VHS。Pug lyft normcore hot chicken biodiesel, actually keffiyeh thundercats photo booth pour-over twee fam food truck microdosing banh mi。Vice activated charcoal raclette unicorn live-edge post-ironic。Heirloom vexillologist coloring book, beard deep v letterpress echo park humblebrag tilde。
+
+turmeric listicle fam ugh humblebrag。Bespoke leggings gastropub, biodiesel brunch pug fashion axe meh swag art party neutra deep v chia。Enamel pin fanny pack knausgaard tofu, artisan cronut hammock meditation occupy master cleanse chartreuse lumbersexual。Kombucha kogi viral truffaut synth distillery single-origin coffee ugh slow-carb marfa selfies。Pitchfork schlitz semiotics fanny pack, ugh artisan vegan vaporware hexagon。Polaroid fixie post-ironic venmo wolf ramps **kale chips**。
+
+> 在这第一句话上面不应该有边距。
+>
+> 引用块应该是较浅的灰色，并在左侧有一个边框，颜色为辅助色。
+>
+> 在这最后一句话下面不应该有边距。
+
+## 第一个二级标题
+
+这是跟随标题的普通段落。Knausgaard kale chips snackwave microdosing cronut copper mug swag synth bitters letterpress glossier **craft beer**。Mumblecore bushwick authentic gochujang vegan chambray meditation jean shorts irony。Viral farm-to-table kale chips, pork belly palo santo distillery activated charcoal aesthetic jianbing air plant woke lomo VHS organic。Tattooed locavore succulents heirloom, small batch sriracha echo park DIY af。Shaman you probably haven't heard of them copper mug, crucifix green juice vape *single-origin coffee* brunch actually。Mustache etsy vexillologist raclette authentic fam。Tousled beard humblebrag asymmetrical。I love turkey, I love my job, I love my friends, I love Chardonnay!
+
+Deae legum paulatimque terra, non vos mutata tacet: dic。Vocant docuique me plumas fila quin afuerunt copia haec o neque。
+
+在大屏幕上，段落和标题不应占据整个容器宽度，但我们希望表格、代码块等占据整个宽度。
+
+Scenester tumeric pickled, authentic crucifix post-ironic fam freegan VHS pork belly 8-bit yuccie PBR&B。**我喜欢我们生活的这个世界**。
+
+
+## 第二个二级标题
+
+> 这是一个跟随标题的引用块。培根 ipsum dolor 坐在火腿上 doner shank drumstick，猪腩肉 porchetta 意式香肠 brisket 火腿后臀 rump pig。Chuck kielbasa leberkas，猪肉 bresaola 火腿后臀 牛柳 mignon 牛肩胛 短肋骨 biltong。
+
+### 三级标题
+
+```
+这是一个跟随标题的代码块。
+```
+
+下一等级的紧身裤在出售前，PBR&B 教堂钥匙萨满回声公园。羽衣甘蓝芯片占据哥谭镇无论何时流行朋克自由人猪肉肚子自拍。美食家贝尔琳达地铁瓷砖醒后赛博朋克西坦。破烂时髦的男人面包圈半语义化学，奇亚信使包格子衫。
+
+#### 四级标题
+
+* 这是一个跟随标题的无序列表。
+* 这是一个跟随标题的无序列表。
+* 这是一个跟随标题的无序列表。
+
+##### 五级标题
+
+1. 这是一个跟随标题的有序列表。
+2. 这是一个跟随标题的有序列表。
+3. 这是一个跟随标题的有序列表。
+
+###### 六级标题
+
+| 什么      | 跟随         |
+|-----------|-----------------|
+| 表格      | 标题        |
+| 表格      | 标题        |
+| 表格      | 标题        |
+
+----------------
+
+上下都有水平分隔线。
+
+----------------
+
+这是一个无序列表：
+
+* 利物浦足球俱乐部
+* 切尔西足球俱乐部
+* 曼联足球俱乐部
+
+以及一个有序列表：
+
+1. 迈克尔·布雷克
+2. 西阿姆斯·布莱克
+3. 布兰福德·马萨利斯
+
+还有一个无序任务列表：
+
+- [x] 创建一个Hugo主题
+- [x] 添加任务列表到其中
+- [ ] 度假去
+
+还有一个"混合"任务列表：
+
+- [ ] 收拾行李
+- ?
+- [ ] 出发旅行！
+
+以及一个嵌套列表：
+
+* 杰克逊五兄弟
+  * 迈克尔
+  * 蒂托
+  * 杰基
+  * 马龙
+  * 杰梅因
+* 忍者神龟
+  * 莱昂纳多
+  * 米开朗基罗
+  * 多纳泰罗
+  * 拉斐尔
+
+定义列表可以与Markdown语法一起使用。定义标题是粗体。
+
+名字
+: 哥斯拉
+
+出生年份
+: 1952
+
+出生地
+: 日本
+
+颜色
+: 绿色
+
+
+----------------
+
+表格应具有粗体标题和交替的阴影行。
+
+| 艺术家            | 专辑           | 年份 |
+|-------------------|-----------------|------|
+| 迈克尔·杰克逊     | 颤栗           | 1982 |
+| 王子              | 紫雨            | 1984 |
+| 比斯蒂男孩        | 许可证到期      | 1986 |
+
+如果表格太宽，应该可以水平滚动。
+
+| 艺术家            | 专辑           | 年份 | 唱片公司     | 奖项   | 歌曲     |
+|-------------------|-----------------|------|-------------|----------|-----------|
+| 迈克尔·杰克逊     | 颤栗           | 1982 | Epic唱片公司 | 格莱美年度最佳专辑奖，全美音乐奖最受欢迎流行/摇滚专辑奖，全美音乐奖最受欢迎灵魂/R&B专辑奖，全英音乐奖最佳销量专辑奖，格莱美最佳非古典工程专辑奖 | 想要开始某事，宝贝属于我，女孩是我的，颤栗，拍它，比利·珍，人类天性，P.Y.T.（漂亮年轻的事物），我生命中的女士 |
+| 王子              | 紫雨           | 1984 | 华纳兄弟唱片公司 | 格莱美最佳视觉媒体原声带奖，全美音乐奖最受欢迎流行/摇滚专辑奖，全美音乐奖最受欢迎灵魂/R&B专辑奖，全英音乐奖最佳原声带/演员录音奖，格莱美最佳二人或组合摇滚表演奖 | 让我们疯狂起来，带上我，美丽的人们，电脑蓝调，亲爱的尼基，当鸽子哭泣，我愿意为你死，宝贝我是明星，紫雨 |
+| 比斯蒂男孩        | 许可证到期     | 1986 | 水星唱片公司 | 没有奖项但这个表格单元很宽 | 押韵与偷窃，新风格，她很狡猾，有效果，慢骑，女孩们，(你必须)为你的权利而战，布鲁克林不睡觉，保罗·里维尔，现在就拿起来，击打它，铜猴子，缓慢而低沉，是时候变得病态了 |
+
+----------------
+
+像 `var foo = "bar";` 这样的代码片段可以以内联方式显示。
+
+同样，`this should vertically align` ~~`with this`~~ ~~and this~~。
+
+代码也可以显示在一个块元素中。
+
+```
+foo := "bar";
+bar := "foo";
+```
+
+代码也可以使用语法高亮。
+
+```go
+func main() {
+  input := `var foo = "bar";`
+
+  lexer := lexers.Get("javascript")
+  iterator, _ := lexer.Tokenise(nil, input)
+  style := styles.Get("github")
+  formatter := html.New(html.WithLineNumbers())
+
+  var buff bytes.Buffer
+  formatter.Format(&buff, style, iterator)
+
+  fmt.Println(buff.String())
+}
+```
+
+```
+长的单行代码块不应该换行。如果它们太长，应该水平滚动。这一行应该足够长以演示这一点。
+```
+
+表格单元格内的内联代码仍应可区分。
+
+| 语言        | 代码               |
+|-------------|--------------------|
+| JavaScript  | `var foo = "bar";` |
+| Ruby        | `foo = "bar"{`     |
+
+----------------
+
+小图像应按实际大小显示。
+
+![](https://upload.wikimedia.org/wikipedia/commons/thumb/9/9e/Picea_abies_shoot_with_buds%2C_Sogndal%2C_Norway.jpg/240px-Picea_abies_shoot_with_buds%2C_Sogndal%2C_Norway.jpg)
+
+大图像应始终缩小并适合内容容器。
+
+![](https://upload.wikimedia.org/wikipedia/commons/thumb/9/9e/Picea_abies_shoot_with_buds%2C_Sogndal%2C_Norway.jpg/1024px-Picea_abies_shoot_with_buds%2C_Sogndal%2C_Norway.jpg)
+
+_以上挪威松嫩枝带芽的照片：Bjørn Erik Pedersen，CC-BY-SA。_
+
+
+## 组件
+
+### 警报
+
+{{< alert >}}这是一个警报。{{< /alert >}}
+{{< alert title="注意" >}}这是一个带标题的警报。{{< /alert >}}
+{{% alert title="注意" %}}这是一个带标题和**Markdown**的警报。{{% /alert %}}
+{{< alert color="success" >}}这是一个成功的警报。{{< /alert >}}
+{{< alert color="warning" >}}这是一个警告。{{< /alert >}}
+{{< alert color="warning" title="警告" >}}这是一个带标题的警告。{{< /alert >}}
+
+
+## 另一个标题
+
+在这里添加一些章节以查看目录的样子。培根 ipsum dolor 坐在火腿上 doner shank drumstick，猪腩肉 porchetta 意式香肠 brisket 火腿后臀 rump pig。Chuck kielbasa leberkas，猪肉 bresaola 火腿后臀 牛柳 mignon 牛肩胛 短肋骨 biltong。
+
+### 本文档
+
+Inguina genus: Anaphen post: lingua violente voce suae meus aetate diversi。Orbis unam nec flammaeque status deam Silenum erat et a ferrea。Excitus rigidum ait: vestro et Herculis convicia: nitidae deseruit coniuge Proteaque adiciam *eripitur*？Sitim noceat signa *probat quidem*。Sua longis *fugatis* quidem genae。
+
+
+### 像素计数
+
+Tilde photo booth wayfarers cliche lomo intelligentsia man braid kombucha vaporware farm-to-table mixtape portland。PBR&B pickled cornhole ugh try-hard ethical subway tile。Fixie paleo intelligentsia pabst。Ennui waistcoat vinyl gochujang。Poutine salvia authentic affogato, chambray lumbersexual shabby chic。
+
+### 联系信息
+
+Plaid hell of cred microdosing, succulents tilde pour-over。Offal shabby chic 3 wolf moon blue bottle raw denim normcore poutine pork belly。
+
+
+### 外部链接
+
+Stumptown PBR&B keytar plaid street art, forage XOXO pitchfork selvage affogato green juice listicle pickled everyday carry hashtag。Organic sustainable letterpress sartorial scenester intelligentsia swag bushwick。Put a bird on it stumptown neutra locavore。IPhone typewriter messenger bag narwhal。Ennui cold-pressed seitan flannel keytar, single-origin coffee adaptogen occupy yuccie williamsburg chillwave shoreditch forage waistcoat。
+
+
+
+```
+这是页面上的最后一个元素，下方不应有边距。
+```