V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
Akkuman
V2EX  ›  分享创造

还记得纸小墨静态博客生成器吗,为它移植了一款主题

  •  
  •   Akkuman · 2018-08-21 20:40:36 +08:00 · 3332 次点击
    这是一个创建于 2270 天前的主题,其中的信息可能已经有所发展或是发生改变。

    主题介绍

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

    Demo

    ink-theme-story

    主题的一些食用说明

    菜单

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

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

    一些功能

    • 评论点击加载, 可以应对一些墙导致无法加载的场景
    • 图片懒加载
    • 支持来必力和 Disqus 评论系统, 默认为 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 和来必力评论系统

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

    写在最后

    致谢

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

    5 条回复    2018-08-23 23:18:18 +08:00
    Akkuman
        1
    Akkuman  
    OP
       2018-08-21 21:45:22 +08:00 via Android
    nicoljiang
        2
    nicoljiang  
       2018-08-22 12:53:57 +08:00
    想知道它那个客户端什么适合能出来。
    Akkuman
        3
    Akkuman  
    OP
       2018-08-22 22:33:49 +08:00 via Android
    @nicoljiang 哈哈,是的,都好久了
    Akkuman
        4
    Akkuman  
    OP
       2018-08-23 14:57:39 +08:00
    增加了来必力和 Gitment 评论
    jichuan
        5
    jichuan  
       2018-08-23 23:18:18 +08:00 via iPhone
    666
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2909 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 31ms · UTC 14:47 · PVG 22:47 · LAX 06:47 · JFK 09:47
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.