Skip to content

PAJK-FE/PAJK-FE.github.io

Repository files navigation

PAJK-FE Blog

Build Status

基于静态博客HexoNexT主题的博客。

Source分支为博客源码,Master分支为编译生成的HTML静态文件。

依赖Travis CI自动编译部署。

Updated Feature

2017/6/2

  1. 采用Hypercomments作为新评论系统
  2. 新增作者超链功能,详见如何给文章添加标签,分类和作者(个人主页)
  3. 补全如何插入图片教程

How to publish new Post

  1. 准备环境
npm install -g hexo-cli   #如果已安装可跳过
git clone https://github.com/PAJK-FE/PAJK-FE.github.io.git
cd PAJK-FE.github.io
npm install

拉完代码后,默认是source分支,如果不是,请切换到source分支后操作

  1. 生成新文章
hexo new title   #title替换为文章标题

用编辑器打开source/_posts/title,用Markdown方式以及NexT特有标签写文章

  1. 预览文章(非必要)
hexo s -o

浏览器会自动打开预览页面,保存文件后,刷新页面能看到最新结果

  1. 发布文章
git add .
git commit -m 'update new post'  #随意填写commit信息
git push -u origin source        #不要提交到master分支,不要提交到master分支,不要提交到master分支

push到source分支后,Travis CI会自动编译部署。1~2分钟后刷新博客地址,确认发布成功

注意:因为每次source提交都会触发Travis CI,所以请尽量完成文章后再push代码

常见问题

如何设置阅读全文?

推荐在文章中使用<!-- more -->手动进行截断

文章发布后可以修改吗?

可以。编辑已有文章后push即可,但是不建议修改时间和文件名,这样会丢失所有评论和阅读数

如何删除文章?

直接删除source/_posts下对应文件,push代码

如何插入图片

新建文章后,会在_posts文件夹下生成一个title同名的文件夹。将需要插入的图片放到同名文件夹下。 在md文章内使用{% asset_img slug [title] %}语法插入图片。详见hexo教程

例如文件夹下有一个example.jpg图片,通过{% asset_img example.jpg This is an example image %}在文章中插入example.jpg图片。

如何给文章添加标签,分类和作者(个人主页)

标签,分类,作者模板如下

其中authorLink(作者个人主页)为非必填项,目前链接必须带上http或https协议

---
title: title
date: 2017-05-22 10:23:59
tags:
- 标签1
- 标签2
categories:
- 分类
author: '+1s'
authorLink: https://www.google.com
---
  • tags后填写标签,多标签用-换行添加
  • categories后填写分类,如填多个分类会处理为父子分类,因此不建议填写多个分类,详见这儿
  • author后填写作者名称。目前通过修改主题简单实现,待官方支持后更改

TODO

  • 多作者支持(现采用临时方案,修改主题)待NexT5.2.0官方支持多作者

Any issues

有任何问题请联系chengandpeng@gmail.com