Skip to content

Latest commit

 

History

History
198 lines (137 loc) · 5.87 KB

README.md

File metadata and controls

198 lines (137 loc) · 5.87 KB

主题介绍

为纸小墨写的一款主题,该主题移植自Yumoe

Demo

ink-theme-story

主题的一些食用说明

菜单

标题旁边有一个 · 字符,点击后便可显示菜单。1,2,3 分别代表 独立页面菜单导航树(仅在文章界面有用)以及搜索框

具体介绍可见https://yumoe.com/archives/story.html

一些功能

  • 评论点击加载, 可以应对一些墙导致无法加载的场景
  • 图片懒加载
  • 评论系统支持来必力, Disqus, Gitment, Valine, 默认为Disqus
  • ...

主题截图

Screenshot_20180820_143859.png

使用方法

基础设置

进入到纸小墨程序的目录下, 也就是ink主程序的目录, 然后进入该目录下的blog目录

然后执行

git clone https://github.com/akkuman/ink-theme-story.git

或者下载git压缩包后解压到blog文件夹

现在你可以看到blog目录下的ink-theme-story目录

然后修改站点配置文件blog/config.yml

站点配置文件一般如下:

site:
    title: "Akkuman"
    subtitle: "Akkuman的技术博客"
    limit: 8
    theme: ink-theme-story
    lang: zh
    url: "ink-theme-story.pancakeapps.com"
    comment: Akkuman
    logo: "-/images/avatar.png"
    # link: "{category}/{year}/{month}/{day}/{title}.html"
    link: "{year}/{month}/{day}/{title}.html"
    # root: "/blog"

authors:
    me:
        name: "Akkuman"
        intro: "编程小白|技术菜鸟"
        avatar: "-/images/avatar.png"

build:
    # output: "public"
    port: 8000
    # Copied files to public folder when build
    copy:
        - "source/images"
    # Excuted command when use 'ink publish'
    publish: |
        git add . -A
        git commit -m "update"
        git push origin

我们需要修改的地方有:

title   #title字段是截图中的左上角Akkuman字段, 比如我设置为Akkuman那么就是和我截图中一样
subtitle    #网站子标题, 在标签页和归档能看到
limit: 8    #每页可显示的文章数目, 为了美观建议设置为8
theme: ink-theme-story    #网站主题目录, 设置为该主题ink-theme-story

其他地方根据自己需求更改, 纸小墨说明文档见简洁的静态博客构建工具 —— 纸小墨(InkPaper)

关于页面

在纸小墨中,每篇文章是有作者的,我现在按上面我给出的例子配置为例进行说明

纸小墨中每一篇文章的头配置大致如下:

title: "简洁的静态博客构建工具 —— 纸小墨(InkPaper)"
date: 2015-03-01 18:00:00 +0800
update: 2016-07-11 17:00:00 +0800
author: me
cover: "-/images/example.png"
tags:
    - 设计
    - 写作
preview: 纸小墨(InkPaper)是一个GO语言编写的开源静态博客构建工具,可以快速搭建博客网站。它无依赖跨平台,配置简单构建快速,注重简洁易用与更优雅的排版。

其中的preview是文章预览,也可在正文中使用<!--more-->分割, 是一个可选字段,我们不必管

对我们有影响的字段配置除了基础的title等等之外, 需要关注一下author这个字段

纸小墨每一篇文章的作者的关于页面是about.{{.Author.Id}}.html, 比如我上面的站点配置文件中authors有一个值是me, 那么这个作者的关于页面就是about.me.html, 也就是我们需要建立一个page, 纸小墨主程序打包中有一个文件about.me.md, 可以参见这个文件的格式, 我在这里给出来:

type: page
title: "关于作者"
author: me

---

## 纸小墨

构建只为纯粹书写的博客。

[http://www.chole.io/](http://www.chole.io/)

那么这个文件生成后就会在站点根目录下生成about.me.html文件.

重点来了

上面我说的关于页面是单个作者的关于页面, 在这个主题中, 我有定义一个站点的关于页面

<a href="{{.Site.Root}}/about.html"><li>{{i18n "about"}}</li></a>

我们只需要按照上面about.me.md的格式新建一个about.md即可, 我在这里给出一个about.md例子:

type: page
title: "关于本站"

---

我是一个站点关于页面例子 

author字段可省略,看自己的喜好

评论系统切换

本主题的评论采用点击再动态加载的方式, 所以不用担心因为Disqus被墙的原因导致页面打不开, 只有当你点击show comments时才会开始加载评论

本主题的评论系统支持来必力, Disqus, Gitment

来必力Livere

切换为来必力的话只需要修改站点配置文件blog/config.yml, 把comment字段的值修改成来必力的data-uid(可在来必力后台代码管理中看到), 然后打开blog/ink-theme-story/_comment.html文件, 把来必力评论的注释去掉, 然后把Disqus评论加上注释即可

Gitment

切换为Gitment的话同上修改, comment字段的格式为

comment: "owner:repo:client_id:client_secret"

其中各个的属性为

owner           #你的 GitHub ID
repo            #存储评论的 repo
client_id       #你的 client ID
client_secret   #你的 client secret

然后打开blog/ink-theme-story/_comment.html文件, 把Gitment评论的注释去掉, 然后把Disqus评论加上注释即可

Valine

切换为Gitment的话同上修改, comment字段的格式为

comment: "API_ID:API_Key"

其中各个的属性为

API_ID           #从LeanCloud的应用中得到的AppId
API_Key          #从LeanCloud的应用中得到的APP Key.

然后打开blog/ink-theme-story/_comment.html文件, 把Valine评论的注释去掉, 然后把Disqus评论加上注释即可

写在最后

致谢

特别感谢Yumoe提供了这么简洁大方的主题