TODO

• 博文置顶
• 内置pdf阅读器
• 修改搜索框
• 字体修改
• 404页面自定义
• 回到顶部
• 文章加密

博客建立教程

参考：博客教程

居中显示图片和说明

<div align=center>
    <img src="图片地址"/>
    <p style="font-size:14px;color:#C0C0C0;text-decoration:underline">
        图片说明
    </p>
</div>

效果：

添加文章摘要和目录

只需要修改文章头部即可：

---
layout: post
title: "博客搬运笔记"
date: 2020-10-23
tags: ["技术"]
comments: true
author: oneman233
excerpt: "搬家"      //在此处攥写文章摘要
toc: true            //是否开启文章目录
---

注意文章的目录会自动识别html文档里的<h>标签

并且想要在markdown中直接显示html标签的话需要加上反斜杠转义

显示作者

我fork的这个项目不能更换gitpage主题，于是我到_layouts目录下的post.html，修改成了下面这样：

<h1>博客搬运笔记</h1>

written by oneman233
<!-- 显示作者 -->

嵌入音频

使用 APlayer && MetingJS 实现。

参考：使用指南

项目原Github地址：项目原地址

markdown公式显示不全

参考：如何采用MathJax

SimpleJekyllSearch报错

报错：SimpleJekyllSearch --- You must specify a json

首先参考这一个issue：issue，大概看出跟json格式有一定关系

之后参考了这个项目的README：项目地址，里面有一段关于中间件的代码：

SimpleJekyllSearch({
  ...
  templateMiddleware: function(prop, value, template){
    if( prop === 'bar' ){
      return value.replace(/^\//, '')
    }
  }
  ...
})

仍然没能解决问题，之后参考了一个commit：commit地址，解决的是与我一样的问题，把json格式修改成下面这样：

---
---
[
  {/% for post in site.posts /%}
   {
     "title"    : "{/% if post.title != "" /%}{/% else /%}{/% endif /%}",
     "url"      : "{/{ site.baseurl /}}",
     "category" : "{/{ post.categories | join: ', '/}}",
     "date"     : "{/{ post.date | date: "/%B /%e, /%Y" /}}"
   } {/% unless forloop.last /%},{/% endunless /%}
  {/% endfor /%}
]

注意：注意去掉百分号和大括号前的注释，这里为了防止markdown把它识别为html才注释掉

问题仍然存在，最后的解决方案是：把DOM放在Script之前，这样Script在getElementID的时候才找得到

问题解决。

文章标题重复

主要是之前写过很多标题为“无题”的文章，虽然在_post目录下名字不一样，但是渲染之后的html会重名

目前的命名方法是在可能重复的标题后面后面再加上发布日期

代码块周围的滚动条

参考：如何去除不必要的滚动条

pdf显示

使用以下代码即可：

\<embed src="文件路径" type="application/pdf" />

注意去掉行首的反斜杠。

效果如下：