Jekyll博文内链和返回顶部按钮

有些时候,写的文章会很长,在开始看的时候,有目录会很方便,能即刻跳到需要阅读的地方,为了更方便回到顶部目录的地方,还得需要添加返回顶部的按钮,本文就说一下Jekyll博文用markdown书写时为文章添加锚点和返回顶部按钮。

添加目录锚点

其实说起来就是添加一个内部链接,能使点一下目录立马跳到内容链接处,分两步:

添加目录

首先,得添加一个清晰醒目的目录,添加目录时只需按照markdown添加超链接的方式,为每一个目录点添加锚点链接,不同于一般超链接的是,链接以『#』开头,紧接着『锚点名』,如以下例子:

1. [访问模式](#no1)
2. [时钟相关](#no2)
   * [时钟控制命令](#no2-1)
   * [时钟控制状态](#no2-2)
   * [睡眠控制命令](#no2-3)
   * [睡眠控制状态](#no2-4)
3. [端口寄存器](#no3)
4. [方向寄存器](#no4)
5. [外设控制](#no5)
6. [ADC输入配置](#no6)
7. [功能选择](#no7)
8. [输入模式](#no8)
9. [中断状态标志](#no9)
10. [中断控制](#no10)
11. [中断屏蔽](#no11)
12. [串口及SPI相关](#no12)
    * [USART0的控制和状态](#no12-1)
    * [UART的控制](#no12-2)
    * [USART0的通用控制](#no12-3)
    * [USART0的数据缓存](#no12-4)
    * [USART0波特率](#no12-5) 

添加锚点

紧接着在目录所对应内容处添加锚点,如下:

注意:添加锚点要添加到内容标题的前一行,这样能保证跳转时能以标题顶头,主要是我之前总是与内容处的目录标题同行,导致跳转后跳到了目录下一行,就看不到目录对应内容的标题了。

<a name="no1"/>

#### 访问模式

...

...

...

<a name="no12"/>

#### 12. 串口及SPI相关

<a name="no12-1"/>

##### 12.1. USART0的控制和状态(U0CSR,0x86)

...


<a name="no12-5"/>

##### 12.5. USART0波特率(U0BAUD,0xC2)

...

1.3 效果展示

效果就像是下面展示的一样,点击目录即跳转到对应内容处:

1

添加返回顶部按钮

只需两步就可以在页面添加一个固定的返回顶部按钮,这里没有加JS代码,没什么漂亮的效果,只是功能的实现。

添加返回按钮块

将以下代码添加到博文采用的布局html文件的最后,比如我的是post.html。

<div id="backtop">
   <a href="#">TOP</a>
</div> 

添加按钮的css样式

这里我把我的css样式粘上,可以按照自己喜欢修改样式即可。

#backtop a { /* back to top button */
    text-align: center;
    line-height: 50px;
    font-size: 16px;
    width:50px;
    height: 50px;
    position: fixed;
    bottom: 10px; /* 小按钮到浏览器底边的距离 */
    right: 60px; /* 小按钮到浏览器右边框的距离 */
    color: rgb(64,120,192); /* 小按钮中文字的颜色 */
    z-index: 1000;
    background: #fff; /* 小按钮底色 */
    padding: auto; /* 小按钮中文字到按钮边缘的距离 */
    border-radius: 50px; /* 小按钮圆角的弯曲程度(半径)*/
    -moz-border-radius: 50px;
    -webkit-border-radius: 50px;
    font-weight: bold; /* 小按钮中文字的粗细 */
    text-decoration: none !important;
    box-shadow:0 1px 2px rgba(0,0,0,.15), 0 1px 0 #ffffff inset;
}

#backtop a:hover { /* 小按钮上有鼠标悬停时 */
    background: rgba(64,120,192,0.8); /* 小按钮的底色 */
    color: #fff; /* 文字颜色 */
}

展示效果

2


jekyll

1148 字

2015-10-28 12:00 +0800