使用的markdown解析工具为kramdown。
引用块
引用块的样式借用了kramdown语法文档中的样式。
在/sass/custom/_style.scss
中添加样式定义
1 | /* 引用 */ |
然后在markdown文件中的写法如下
1 | > This is a blockquote. > 这是一个引用块。 {: .information} |
就会显示成这个样子
This is a blockquote.
这是一个引用块。 {: .information}
表格
参考kramdown关于表格的参考手册,或者是kramdown关于表格的快速参考手册。下面表格的样式也是在这个基础上修改的。
首先看一下表格样式的定义,在/sass/custom/_styles.scss
中定义样式
1 | /* 表格 */ |
然后可以用以下代码显示表格
1 | | Header1 | Header2 | Header3 | |:--------|:-------:|--------:| | cell1 | cell2 | cell3 | | cell4 | cell5 | cell6 | |---- | cell1 | cell2 | cell3 | | cell4 | cell5 | cell6 | |===== | Foot1 | Foot2 | Foot3 {: .mytable} |
显示的表格为
| Header1 | Header2 | Header3 | |:——–|:——-:|——–:| | cell1 | cell2 | cell3 | | cell4 | cell5 | cell6 | |—- | cell1 | cell2 | cell3 | | cell4 | cell5 | cell6 | |===== | Foot1 | Foot2 | Foot3 {: .mytable}
kramdown参考文档中的其它几个例子
1 | |-----------------+------------+-----------------+----------------| |
注意里面的对齐方式的定义(代码的第三行),还有第7,10行中关于表格分块的定义,显示
|—————–+————+—————–+—————-| | Default aligned |Left aligned| Center aligned | Right aligned | |—————–|:———–|:—————:|—————:| | First body part |Second cell | Third cell | fourth cell | | Second line |foo | strong | baz | | Third line |quux | baz | bar | |—————–+————+—————–+—————-| | Second body | | | | | 2 line | | | | |=================+============+=================+================| | Footer row | | | | |—————–+————+—————–+—————-| {: .mytable}
当然也有屌丝专用的丑陋,但简单的方式,与上面的表格一样
1 | |--- |
最后的显示的表格与上面是一样的。
|— | Default aligned | Left aligned | Center aligned | Right aligned |-|:-|:-:|-: | First body part | Second cell | Third cell | fourth cell | Second line |foo | strong | baz | Third line |quux | baz | bar |— | Second body | 2 line |=== | Footer row {: .mytable}
当然还可以有没有那么复杂的直接上最简单的表格的方式
1 | | First cell|Second cell|Third cell |
显示为
| First cell|Second cell|Third cell | First | Second | Third | First | Second | | Fourth | {: .mytable}
首行缩进
blog的样式中是没有缩进的,这样多少还是有点难看。加入的方法如下,在/sass/custom/_styles.scss
中加入如下代码
1 | #content .entry-content > p { |
然后就有了现在的缩进样式。需要注意,在markdown文件中,如果在一行的后面加入空格来换行的话,生成的html文件中,是用<br/>来换行的,不是用<p>换行,就没有缩进的样式了。正确的方法是在两行文字之间插入空行。
但后来发现一个问题,在一行里面加入的代码块也有了缩进的样式, 就像这样子这里有了缩进
, 我用了比较土的方法解决,还是在上面的custom/_styles.scss中加入
1 | #content .entry-content > p > code { |
这种解决办法不是很好,因为总有可能导致其它标签里面意外出现缩进,但我也不熟悉css,只有先这么办了,先解决眼前的问题。
添加豆瓣的侧边栏
豆瓣收藏秀可以为你的博客生成一个侧边栏,放入到你的博客中。访问这个网址http://www.douban.com/service/badgemakerjs,可以生成一段js代码,然后讲这段代码嵌入到侧边栏的html中即可。
具体的做法,显示在收藏秀的页面里面选择好需要显示的内容,例如:我选择了,我想看的、书、每次随机选择、共显示9个 每行3个、图片小,下面两个选择隐藏,然后生成了这样的JS代码
1 | <script type="text/javascript" src="http://www.douban.com/service/badge/63148093/?show=wishlist&select=random&n=9&columns=3&hidelogo=yes&hideself=yes&cat=book" ></script> |
然后创建文件/source/_includes/custom/asides/douban-wishreading.html
, 在这个html文件中加入如下代码
1 | <section class="well"> |
其中第5行为豆瓣收藏秀生成的JS代码,其它的样式代码为blog的样式, 用于不同的blog可能需要修改。然后需要在_config.yml
里修改配置,在default_asides
中加入custom/asides/douban-wishreading.html
,就像这样
1 | default_asides: [asides/recent_posts.html, custom/asides/douban-reading.html, custom/asides/douban-wishreading.html, asides/github.html, asides/twitter.html, asides/delicious.html, asides/pinboard.html, asides/googleplus.html] |
最后展现的样子可以参考猪猫的生活。
文章摘要
当文章比较长的时候,如果在文章的前面有一个摘要,就会方便很多。下面就就是一个添加摘要的简单方法。
首先在文章的markdown文件中添加一个变量abstract
如下
1 | --- |
然后修改source/_include/article.html
1 | diff --git a/source/_includes/article.html b/source/_includes/article.html |
之后修改样式文件sass/custom/_styles.scss
, 添加如下的样式
1 | .abstract, .warning{ |
就可以显示和本文开始一样的摘要了。