feat: add excerpt_type, close #6

README.md

@@ -50,6 +50,14 @@ TeXt 是针对博客的一款简洁的主题，它虽然简洁但并不简单。
 
 需要注意的是，该主题的文章列表摘要会默认文章的全部内容。若想控制摘要内容，需要在文章中想要显示到的地方加上 `<!--more-->` 行，具体详见 [Jekyll: 文章摘要](http://jekyll.com.cn/docs/posts/#_6)。
 
+#### 摘要
+
+该主题的摘要有两种模式——TEXT 模式和 HTML 模式。 当 _config.yml 配置项 `excerpt_type` 的值为 `text` 时是 TEXT 模式，为 `html` 时是 HTML 模式。**默认为 TEXT 模式**。
+
+TEXT 模式的摘要为纯文本，会过滤掉一切非文本元素（标题，链接，列表，表格，图片等等），且截取前 350 个字符。
+
+HTML 模式的摘要为 HTML 文档，与文章内容一致，并且 **默认展示整篇文章的内容**。若想控制摘要内容，需要在文章中想要显示到的地方加上 `<!--more-->` 行，具体详见 [Jekyll: 文章摘要](http://jekyll.com.cn/docs/posts/#_6)。
+
 ### 安装环境（非必须）
 
 请确保你的电脑上配置好了 Ruby 开发环境。(ruby, bundle, Command Line Tools ...)

_config.test.yml

@@ -6,7 +6,7 @@
 # 'jekyll serve'. If you change this file, please restart the server process.
 
 ## Base settings ##
-url: https://www.someone.com # the base hostname & protocol for your site e.g. https://www.someone.com
+# url:  # the base hostname & protocol for your site e.g. https://www.someone.com
 baseurl: '/'
 title: Someone's blog
 description: > #this means to ignore newlines until "nav_lists:"
@@ -49,12 +49,15 @@ leancloud:
   # app_key:  #LeanCloud App key
   # app_class:  #LeanCloud App class
 
+# mathjax: true
+
 ## Paginate ##
 paginate: 5
 paginate_path: /blog/page:num
 
 ## Post excerpts ##
 excerpt_separator: <!--more-->
+excerpt_type: html
 
 ## Build ##
 markdown: kramdown

_config.yml

@@ -57,6 +57,7 @@ paginate_path: /blog/page:num
 
 ## Post excerpts ##
 excerpt_separator: <!--more-->
+excerpt_type: text ## text | html
 
 ## Build ##
 markdown: kramdown

_layouts/home.html

@@ -11,7 +11,11 @@ <h1>
                         <a href="{{ post.url | prepend: site.baseurl | replace: '//', '/' }}">{{ post.title }}</a>
                     </h1>
                     <div class="m-article-content">
-                        {{ post.excerpt }}
+                        {% if site.excerpt_type == 'html' %}
+                            {{ post.excerpt }}
+                        {% else %}
+                            {{ post.excerpt | strip_html | truncate: 350 }}
+                        {% endif %}
                     </div>
                     <a href="{{ post.url | prepend: site.baseurl | replace: '//', '/' }}">Click to read more ...</a>
                     {% include blog/article-data.html %}

_posts/2016-10-10-paragraphs.md

@@ -10,6 +10,7 @@ Vestibulum posuere, quam sed bibendum posuere, orci est semper libero, nec congu
 Vestibulum posuere, quam sed bibendum posuere
 Pellentesque habitant morbi tristique senectus
 
+<!--more-->
 
 Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Nullam et ligula lacus. Maecenas tellus massa, tempus sit amet scelerisque sed, ultrices id massa. Donec massa augue, imperdiet in egestas luctus, hendrerit ut sem. Quisque pretium egestas arcu ut pellentesque. Vestibulum vestibulum eros quis dui condimentum hendrerit. Ut laoreet consectetur quam, non molestie sapien imperdiet porttitor. Nullam a purus non nisi feugiat euismod. Curabitur euismod odio at neque consectetur commodo. Sed tincidunt consequat mi, vitae tincidunt ipsum eleifend eu. Donec scelerisque risus purus. Etiam vitae est felis.
 

_posts/2016-12-12-footnote.md

@@ -5,34 +5,11 @@ key: 20161212
 tags: test
 ---
 
-## 临江仙
+Here is a footnote reference,[^1] and another.[^longnote]
 
-滚滚长江东逝水[^1]，浪花淘尽[^2]英雄。
+[^1]: Here is the footnote.
 
-<!--more-->
+[^longnote]: Here's one with multiple blocks.
 
-是非成败[^3]转头空，青山[^4]依旧在，几度[^5]夕阳红。
-
-白发渔樵[^6]江渚上，惯看秋月春风[^7]。
-
-一壶浊[^8]酒喜相逢，古今[^9]多少事，都付笑谈中[^10]。
-
-[^1]: 东逝水：是江水向东流逝水而去，这里将时光比喻为江水。
-
-[^2]: 淘尽：荡涤一空。
-
-[^3]: 成败：成功与失败。《战国策·秦策三》：“良医知病人之死生，圣主明於成败之事。”
-
-[^4]: 青山：青葱的山岭。《管子·地员》：“青山十六施，百一十二尺而至于泉。”
-
-[^5]: 几度：虚指，几次、好几次之意。
-
-[^6]: 渔樵：此处并非指渔翁、樵夫，联系前后文的语境而为动词：隐居。此处作名词，指隐居不问世事的人。渚（zhǔ）：原意为水中的小块陆地，此处意为江岸边。
-
-[^7]: 秋月春风：指良辰美景。也指美好的岁月。白居易《琵琶行》：“今年欢笑复明年，秋月春风等闲度。”
-
-[^8]: 浊（zhuó）：不清澈；不干净。与“清”相对。浊酒：用糯米、黄米等酿制的酒，较混浊。
-
-[^9]: 古今：古代和现今。《史记·太史公自序》：“故礼因人质为之节文，略协古今之变。”
-
-[^10]: 都付笑谈中：在一些古典文学及音乐作品中，也有作“尽付笑谈中”。
+    Subsequent paragraphs are indented to show that they
+belong to the previous footnote.

_posts/2016-12-31-chinese.md

@@ -0,0 +1,34 @@
+---
+layout: post
+title: Markdown Example - Chinese | 中文示例
+key: 20161212
+tags: test
+---
+
+## 标题标题标题标题标题标题标题
+
+中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例。
+
+<!--more-->
+
+中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例。
+
+## 标题标题标题标题标题标题标题
+
+中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例。
+
+### 小标题小标题小标题小标题
+
+中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例。
+
+### 小标题小标题小标题小标题小标题小标题小标题小标题小标题小标题小标题小标题小标题小标题
+
+中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例
+
+### 小标题小标题小标题小标题
+
+中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例。
+
+## 标题标题标题标题标题标题标题
+
+中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例中文示例。