docs: create an example site

exampleSite/config.toml

@@ -0,0 +1,107 @@
+baseURL = "http://localhost:1313/example-site/"
+languageCode = "en"
+defaultContentLanguage = "en"
+title = "Even"
+enableRobotsTXT = true
+enableEmoji = true
+theme = "even"
+
+hasCJKLanguage = true     # has chinese/japanese/korean ? # 自动检测是否包含 中文\日文\韩文
+paginate = 3                                              # （可选）首页显示的文章条目数量，默认为10
+disqusShortname = ""      # disqus_shortname
+googleAnalytics = ""      # UA-XXXXXXXX-X
+copyright = ""            # default: author.name ↓        # 默认为下面配置的author.name ↓
+
+[author]                  # require                       # 必需
+  name = "olOwOlo"
+
+[sitemap]                 # require                       # 必需
+  changefreq = "weekly"
+  priority = 0.5
+  filename = "sitemap.xml"
+
+[[menu.main]]             # config your menu              # 配置目录
+  name = "Home"
+  weight = 10
+  identifier = "home"
+  url = "/"
+[[menu.main]]
+  name = "Archives"
+  weight = 20
+  identifier = "archives"
+  url = "/post/"
+[[menu.main]]
+  name = "Tags"
+  weight = 30
+  identifier = "tags"
+  url = "/tags/"
+[[menu.main]]
+  name = "Categories"
+  weight = 40
+  identifier = "categories"
+  url = "/categories/"
+
+[params]
+  version = "2.5.0" # theme version, don't change it!     # 请勿更改
+  since = "2017"    # Site creation time                  # 站点建立时间
+  
+  # site info (option)                                    # 站点信息（可选）
+  keywords = ["olOwOlo", "blog"]
+  description = "olOwOlo blog."
+
+  # paginate of archives, tags and categories             # 归档、标签、分类每页显示的文章数目
+  archive-paginate = 3
+  
+  # 一些全局开关，你可以在每一篇内容的 front matter 中单独关闭某些选项
+  # Some global options, you can close something in front matter.
+  toc = true                                                                            # 是否开启目录
+  fancybox = true           # see https://github.com/fancyapps/fancybox                 # 是否启用fancybox（图片可点击）
+  bootcdn = false           # In china.                                                 # 是否使用bootcdn(针对大陆推荐使用)
+  mathjax = true            # see https://www.mathjax.org/                              # 是否使用mathjax（数学公式）
+  linkToMarkDown = false    # if you config contentCopyright and hugo output .md files. # 是否在链接到markdown原始文件（如果你配置了下面的许可协议并允许hugo生成markdown文件）
+
+  contentCopyright = "<a rel=\"license\" href=\"https://en.wikipedia.org/wiki/Wikipedia:Text_of_Creative_Commons_Attribution-ShareAlike_3.0_Unported_License\" target=\"_blank\">Creative Commons Attribution-ShareAlike License</a>"
+
+  [params.reward]                                         # 文章打赏
+    enable = false
+    wechat = "/path/to/your/wechat-qr-code.png"           # 微信二维码
+    alipay = "/path/to/your/alipay-qr-code.png"           # 支付宝二维码
+  
+  changyanAppid = ""        # Changyan app id             # 畅言
+  changyanAppkey = ""       # Changyan app key
+  baidu_push = false        # baidu push                  # 百度
+  baidu_analytics = ""      # Baidu Analytics
+  baidu_verification = ""   # Baidu Verification
+  google_verification = ""  # Google_Verification         # 谷歌
+
+  [params.social]                                         # 社交链接
+    a-email = "your@email.com"
+    b-stack-overflow = "http://localhost:1313"
+    c-twitter = "http://localhost:1313"
+    d-facebook = "http://localhost:1313"
+    e-linkedin = "http://localhost:1313"
+    f-google = "http://localhost:1313"
+    g-github = "http://localhost:1313"
+    h-weibo = "http://localhost:1313"
+    i-zhihu = "http://localhost:1313"
+    j-douban = "http://localhost:1313"
+    k-pocket = "http://localhost:1313"
+    l-tumblr = "http://localhost:1313"
+
+# 将下面这段配置取消注释可以使 hugo 生成 .md 文件
+# Uncomment these options to make hugo output .md files.
+#[mediaTypes]
+#  [mediaTypes."text/plain"]
+#    suffix = "md"
+#
+#[outputFormats.MarkDown]
+#  mediaType = "text/plain"
+#  isPlainText = true
+#  isHTML = false
+#
+#[outputs]
+#  home = ["HTML", "RSS"]
+#  page = ["HTML", "MarkDown"]
+#  section = ["HTML", "RSS"]
+#  taxonomy = ["HTML", "RSS"]
+#  taxonomyTerm = ["HTML"]

exampleSite/content/_index.md

@@ -0,0 +1,3 @@
+---
+mathjax: false
+---

exampleSite/content/about.md

@@ -0,0 +1,24 @@
+---
+title: "About"
+date: 2017-08-20T21:38:52+08:00
+lastmod: 2017-08-28T21:41:52+08:00
+menu: "main"
+weight: 50
+
+# you can close something for this content if you open it in config.toml.
+comment: false
+mathjax: false
+---
+
+Hugo is a static site engine written in Go.
+
+
+It makes use of a variety of open source projects including:
+
+* [Cobra](https://github.com/spf13/cobra)
+* [Viper](https://github.com/spf13/viper)
+* [J Walter Weatherman](https://github.com/spf13/jWalterWeatherman)
+* [Cast](https://github.com/spf13/cast)
+
+Learn more and contribute on [GitHub](https://github.com/gohugoio).
+

exampleSite/content/post/chinese-preview.md

@@ -0,0 +1,91 @@
+---
+title: "中文 《长恨歌》"
+date: 2017-08-30T01:37:56+08:00
+lastmod: 2017-08-30T01:37:56+08:00
+draft: false
+tags: ["preview", "中文", "tag-1"]
+categories: ["中文"]
+author: "Wikipedia"
+# you can close something for this content if you open it in config.toml.
+comment: false
+# toc: false
+# reward: false
+mathjax: false
+
+# you can define another contentCopyright. e.g. contentCopyright: "This is an another copyright."
+# contentCopyright: false
+---
+
+>《长恨歌》是中国唐朝诗人白居易的一首长篇叙事诗。
+
+# 第一段：贵妃受宠爱
+
+汉皇重色思倾国，御宇多年求不得。杨家有女初长成，养在深闺人未识。
+
+天生丽质难自弃，一朝选在君王侧。回眸一笑百媚生，六宫粉黛无颜色。
+
+春寒赐浴华清池，温泉水滑洗凝脂。侍儿扶起娇无力，始是新承恩泽时。
+
+云鬓花颜金步摇，芙蓉帐暖度春宵。春宵苦短日高起，从此君王不早朝。
+
+<!--more-->
+
+承欢侍宴无闲暇，春从春游夜专夜。后宫佳丽三千人，三千宠爱在一身。
+
+金屋妆成娇侍夜，玉楼宴罢醉和春。姊妹弟兄皆列士，可怜光彩生门户。
+
+遂令天下父母心，不重生男重生女。骊宫高处入青云，仙乐风飘处处闻。
+
+缓歌慢舞凝丝竹，尽日君王看不足。渔阳鼙鼓动地来，惊破霓裳羽衣曲。
+
+# 第二段：马嵬惊变
+
+九重城阙烟尘生，千乘万骑西南行。翠华摇摇行复止，西出都门百余里。
+
+六军不发无奈何，宛转蛾眉马前死。花钿委地无人收，翠翘金雀玉搔头。
+
+君王掩面救不得，回看血泪相和流。黄埃散漫风萧索，云栈萦纡登剑阁。
+
+峨嵋山下少人行，旌旗无光日色薄。蜀江水碧蜀山青，圣主朝朝暮暮情。
+
+行宫见月伤心色，夜雨闻铃肠断声。
+
+# 第三段：玄宗皇帝思念
+
+天旋地转回龙驭，到此踌躇不能去。马嵬坡下泥土中，不见玉颜空死处。
+
+君臣相顾尽霑衣，东望都门信马归。归来池苑皆依旧，太液芙蓉未央柳。
+
+芙蓉如面柳如眉，对此如何不泪垂。春风桃李花开日，秋雨梧桐叶落时。
+
+西宫南内多秋草，落叶满阶红不扫。梨园弟子白发新，椒房阿监青娥老。
+
+夕殿萤飞思悄然，孤灯挑尽未成眠。迟迟钟鼓初长夜，耿耿星河欲曙天。
+
+鸳鸯瓦冷霜华重，翡翠衾寒谁与共。悠悠生死别经年，魂魄不曾来入梦。
+
+# 第四段：仙界寻妃
+
+临邛道士鸿都客，能以精诚致魂魄。为感君王辗转思，遂教方士殷勤觅。
+
+排空驭气奔如电，升天入地求之遍。上穷碧落下黄泉，两处茫茫皆不见。
+
+忽闻海上有仙山，山在虚无缥缈间。楼阁玲珑五云起，其中绰约多仙子。
+
+中有一人字太真，雪肤花貌参差是。金阙西厢叩玉扃，转教小玉报双成。
+
+闻道汉家天子使，九华帐里梦魂惊。揽衣推枕起徘徊，珠箔银屏迤逦开。
+
+云髻(鬓?)半偏新睡觉，花冠不整下堂来。风吹仙袂飘飘(飖)举，犹似霓裳羽衣舞。
+
+玉容寂寞泪阑干，梨花一枝春带雨。含情凝睇谢君王，一别音容两渺茫。
+
+昭阳殿里恩爱绝，蓬莱宫中日月长。回头下望人寰处，不见长安见尘雾。
+
+唯将旧物表深情，钿合金钗寄将去。钗留一股合一扇，钗擘黄金合分钿。
+
+但教心似金钿坚，天上人间会相见。临别殷勤重寄词，词中有誓两心知。
+
+七月七日长生殿，夜半无人私语时。在天愿作比翼鸟，在地愿为连理枝。
+
+天长地久有时尽，此恨绵绵无绝期。

exampleSite/content/post/even-preview.md

@@ -0,0 +1,173 @@
+---
+title: "Theme preview"
+date: 2017-08-23T18:03:09+08:00
+lastmod: 2017-08-23T18:03:09+08:00
+draft: false
+tags: ["preview", "Theme preview", "tag-3"]
+categories: ["Theme preview"]
+
+weight: 10
+
+# you can close something for this content if you open it in config.toml.
+comment: false
+# toc: false
+# reward: false
+# mathjax: false
+
+# you can define another contentCopyright. e.g. contentCopyright: "This is an another copyright."
+author: <a href="https://laozhu.me" target="_blank">米老朱</a>
+contentCopyright: <a href="https://laozhu.me/post/hugo-nuo-post-preview/" target="_blank">See origin</a>
+---
+> Copy from [《Hugo 主题 Nuo 文章样式预览》](https://laozhu.me/post/hugo-nuo-post-preview/)
+
+这篇文章集中说明主题所支持的 Markdown 语法和 Hugo Shortcodes 插件，你也可以在这里预览到他们的样子。如果你不喜欢某些样式，可以去修改 css/ 文件夹下的 .scss 文件。
+
+<!--more-->
+
+# 1.标题
+
+# H1
+## H2
+### H3
+#### H4
+##### H5
+###### H6
+
+## 2. 段落
+
+使用单引号 `*` 或者单下划线 `_` 标记 *斜体强调* 或者 _斜体强调_
+
+使用两个引号 `**` 或者两个下划线 `__` 标记 **加粗强调** 或者 __加粗强调__
+
+引号和下划线可叠加使用 → **只是加粗 _斜体并加粗_**
+
+使用两个波浪线 `~~` 标记 ~~已删除文字~~
+
+插入文字暂无 `Markdown` 标记，直接使用 `HTML` 标签 `<ins>` 标记 <ins>插入文字</ins>
+
+行内代码使用反引号标记 → `print("hello world")`
+
+上标 X<sup>2</sup> / 下标 X<sub>2</sub>
+
+按键 <kbd>Ctrl</kbd>
+
+外链 [chekun's blog](https://chekun.me)
+
+页面内段落 [图片](#section-07)
+
+*注意：你可以通过 `{#section-id}` 方式自定义段落锚点*
+
+参考资料 <sup>[[1]](#ref01)</sup><sup>[[2]](#ref02)</sup>
+
+## 3. 列表
+
+以下的无序、有序和任务列表均支持二级嵌套，不建议使用二级以上嵌套。
+
+### 3.1 无序列表
+
+* 无序列表
+  - 嵌套的无序列表
+  - 嵌套的无序列表
+* 无序列表
+  1. 嵌套的有序列表
+  2. 嵌套的有序列表
+* 无序列表
+
+### 3.2 有序列表
+
+1. 有序列表
+  1. 嵌套的有序列表
+  2. 嵌套的有序列表
+2. 有序列表
+  - 嵌套的无序列表
+  - 嵌套的无序列表
+3. 有序列表
+
+### 3.3 定义列表
+
+CSS
+: 层叠样式表
+
+### 3.4 任务列表
+
+- [ ] Cmd Markdown 开发
+  - [ ] 改进 Cmd 渲染算法，使用局部渲染技术提高渲染效率
+  - [ ] 支持以 PDF 格式导出文稿
+  - [x] 新增Todo列表功能 [语法参考](https://github.com/blog/1375-task-lists-in-gfm-issues-pulls-comments)
+  - [x] 改进 LaTex 功能
+  - [x] 修复 LaTex 公式渲染问题
+  - [x] 新增 LaTex 公式编号功能 [语法参考](http://docs.mathjax.org/en/latest/tex.html#tex-eq-numbers)
+- [ ] 七月旅行准备
+  - [ ] 准备邮轮上需要携带的物品
+  - [ ] 浏览日本免税店的物品
+  - [x] 购买蓝宝石公主号七月一日的船票
+
+## 4. 引用
+
+> 野火烧不尽，春风吹又生。
+>
+> <cite>-- 白居易《赋得古原草送别》</cite>
+
+## 5. 代码
+
+以本站的一段 `JavaScript` 代码做演示。
+
+```javascript
+// Initialize video.js player
+if (document.getElementById('my-player') !== null) {
+  /* eslint-disable no-undef */
+  videojs('#my-player', {
+    aspectRatio: '16:9',
+    fluid: true,
+  });
+}
+```
+
+## 6. 分割线
+
+---
+
+中间能写字的分割线，如果你修改了分割线中字的内容，请配合修改 `CSS` 样式。
+
+## 7. 图片 {#section-07}
+
+不带标题的图片，如下图👇
+
+![这是一张图片](https://raw.githubusercontent.com/olOwOlo/hugo-theme-even/master/images/screenshot.png)
+
+带标题的图片，如下图👇
+
+{{% figure src="https://raw.githubusercontent.com/olOwOlo/hugo-theme-even/master/images/screenshot.png" alt="这是一张图片" title="screenshot.png" %}}
+
+## 8. 表格
+
+使用 `Markdown` 画的表格，如下表👇
+
+| Tables        | Are           | Cool  |
+| :------------ |:-------------:| -----:|
+| col 3 is      | right-aligned | $1600 |
+| col 2 is      | centered      |   $12 |
+| zebra stripes | are neat      |    $1 |
+
+## 9. 数学公式
+
+主题使用了 [MathJax](https://www.mathjax.org/) 开源库来实现对数学公式的支持，使用 `$$` 标记。
+
+$$ evidence\_{i}=\sum\_{j}W\_{ij}x\_{j}+b\_{i} $$
+
+## 10. 网易云音乐
+
+主题文章中可以轻松插入 [网易云音乐](https://music.163.com/) 的指定音乐，你可以根据需要将音乐设置为自动播放，在主题目录 `layouts/shortcodes` 文件夹下的 `music.html` 对该标签进行定义。
+
+{{% music "28196554" %}}
+
+## 11. YouTube
+
+由于不明原因可能无法播放。
+
+{{% youtube "wC5pJm8RAu4" %}}
+
+## 参考资料
+
+1. <a id="ref01">[Markdown Cheatsheet](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet)</a>
+2. <a id="ref02">[Markdown 语法手册](https://www.zybuluo.com/EncyKe/note/120103)</a>

exampleSite/content/post/japanese-preview.md

@@ -0,0 +1,46 @@
+---
+title: "日本語 敬語体系"
+date: 2017-08-30T01:53:34+08:00
+lastmod: 2017-08-30T01:53:34+08:00
+draft: false
+keywords: []
+description: ""
+tags: ["preview", "日本語", "tag-4"]
+categories: ["日本語"]
+author: "Wikipedia"
+
+# you can close something for this content if you open it in config.toml.
+comment: false
+# toc: false
+# reward: false
+mathjax: false
+
+# you can define another contentCopyright. e.g. contentCopyright: "This is an another copyright."
+# contentCopyright: false
+---
+
+> 日本語の敬語体系は、一般に、大きく尊敬語・謙譲語・丁寧語に分類される。文化審議会国語分科会は、2007年2月に「敬語の指針」を答申し、これに丁重語および美化語を含めた5分類を示している。
+
+# 尊敬語
+
+尊敬語は、動作の主体を高めることで、主体への敬意を表す言い方である。動詞に「お（ご）～になる」を付けた形、また、助動詞「（ら）れる」を付けた形などが用いられる。たとえば、動詞「取る」の尊敬形として、「（先生が）お取りになる」「（先生が）取られる」などが用いられる。
+
+<!--more-->
+
+語によっては、特定の尊敬語が対応するものもある。たとえば、「言う」の尊敬語は「おっしゃる」、「食べる」の尊敬語は「召し上がる」、「行く・来る・いる」の尊敬語は「いらっしゃる」である。
+
+# 謙譲語
+
+謙譲語は、古代から基本的に動作の客体への敬意を表す言い方であり、現代では「動作の主体を低める」と解釈するほうがよい場合がある。動詞に「お～する」「お～いたします」（謙譲語＋丁寧語）をつけた形などが用いられる。たとえば、「取る」の謙譲形として、「お取りする」などが用いられる。
+
+語によっては、特定の謙譲語が対応するものもある。たとえば、「言う」の謙譲語は「申し上げる」、「食べる」の謙譲語は「いただく」、「（相手の所に）行く」の謙譲語は「伺う」「参上する」「まいる」である。
+
+なお、「夜も更けてまいりました」の「まいり」など、謙譲表現のようでありながら、誰かを低めているわけではない表現がある。これは、「夜も更けてきた」という話題を丁重に表現することによって、聞き手への敬意を表すものである。宮地裕は、この表現に使われる語を、特に「丁重語」と称している[104][105]。丁重語にはほかに「いたし（マス）」「申し（マス）」「存じ（マス）」「小生」「小社」「弊社」などがある。文化審議会の「敬語の指針」でも、「明日から海外へまいります」の「まいり」のように、相手とは関りのない自分側の動作を表現する言い方を丁重語としている。
+
+# 丁寧語
+
+丁寧語は、文末を丁寧にすることで、聞き手への敬意を表すものである。動詞・形容詞の終止形で終わる常体に対して、名詞・形容動詞語幹などに「です」を付けた形（「学生です」「きれいです」）や、動詞に「ます」をつけた形（「行きます」「分かりました」）等の丁寧語を用いた文体を敬体という。
+
+一般に、目上の人には丁寧語を用い、同等・目下の人には丁寧語を用いないといわれる。しかし、実際の言語生活に照らして考えれば、これは事実ではない。母が子を叱るとき、「お母さんはもう知りませんよ」と丁寧語を用いる場合ももある。丁寧語が用いられる多くの場合は、敬意や謝意の表現とされるが、、稀に一歩引いた心理的な距離をとろうとする場合もある。
+
+「お弁当」「ご飯」などの「お」「ご」も、広い意味では丁寧語に含まれるが、宮地裕は特に「美化語」と称して区別する[104][105]。相手への丁寧の意を示すというよりは、話し手が自分の言葉遣いに配慮した表現である。したがって、「お弁当食べようよ。」のように、丁寧体でない文でも美化語を用いることがある。文化審議会の「敬語の指針」でも「美化語」を設けている。

exampleSite/content/post/syntax-highlighting.md

@@ -0,0 +1,98 @@
+---
+title: "Syntax Highlighting"
+date: 2011-08-30T16:01:23+08:00
+lastmod: 2017-08-30T16:01:23+08:00
+draft: false
+tags: ["preview", "Syntax Highlighting", "tag-5"]
+categories: ["Syntax Highlighting"]
+
+# you can close something for this content if you open it in config.toml.
+comment: false
+toc: false
+# reward: false
+mathjax: false
+
+# you can define another contentCopyright. e.g. contentCopyright: "This is an another copyright."
+# contentCopyright: false
+---
+
+
+```js
+function helloWorld () {
+  alert("Hello, World!")
+}
+```
+
+<!--more-->
+
+```java
+public class HelloWorld {
+  public static void main(String[] args) {
+    System.out.println("Hello, World!");
+  }
+}
+```
+
+```c
+#include <stdio.h>
+
+/* Hello */
+int main(void){
+  printf("Hello, World!");
+  return 0;
+}
+```
+
+```cpp
+// 'Hello World!' program 
+ 
+#include <iostream>
+ 
+int main(){
+  std::cout << "Hello World!" << std::endl;
+  return 0;
+}
+```
+
+```cs
+using System;
+class HelloWorld{
+  public static void Main(){ 
+    System.Console.WriteLine("Hello, World!");
+  }
+}
+```
+
+```html
+<html>
+<body>
+  Hello, World!
+</body>
+</html>
+```
+
+```go
+package main
+import fmt "fmt"
+
+func main() 
+{
+   fmt.Printf("Hello, World!\n");
+}
+```
+
+```scala
+object HelloWorld with Application {
+  Console.println("Hello, World!");
+}
+```
+
+```php
+<?php
+  echo 'Hello, World!';
+?>
+```
+
+```python
+print("Hello, World!") 
+```

exampleSite/data/even/default.toml

@@ -0,0 +1,37 @@
+archive = "Archive"
+tags = "Tags"
+categories = "Categories"
+
+[footer]
+  powered = "Powered by %s"
+  theme = "Theme"
+
+[posts]
+  prev = "Prev"
+  next = "Next"
+  prev_post = "Prev"
+  next_post = "Next"
+  toc = "Contents"
+  readmore = "Read more.."
+  reward = "Reward"
+  seeMarkDown = "The Markdown version »"
+
+[copyright]
+  author = "Author"
+  link = "Link"
+  lastMod = "LastMod"
+  markdown = "Markdown"
+  lincese = "Lincese"
+
+[counter]
+  [counter.archives]
+    zero = "No Posts"
+    other = "%d Posts In Total"
+
+  [counter.tagcloud]
+    zero = "No tags"
+    other = "%d Tags In Total"
+
+  [counter.categories]
+    zero =  "No Categories"
+    other = "%d Categories In Total"