LOFFER是个可以帮助你get off from LOFTER的软件(我知道这个pun很烂)。
这是一个可以通过Fork直接发布在GitHub的Jekyll博客,你不需要编写代码或使用命令行即可获得一个部署在GitHub的博客。
修订目录跳级会坏掉的问题,不算完美解决,但不会坏掉了。
增加对LaTeX渲染的支持,请见这篇说明和示例。
增加置顶功能,只要在一个post的YAML Front Matter(就是文章头部的这段信息)中加入pinned: true
,这篇文章就可以置顶了。
另外介绍一个给LOFFER更换主题颜色的手法。LOFFER用了一个开源的颜色表Open Color,该色表提供的可选颜色有:red, pink, grape, violet, indigo, blue, cyan, teal, green, lime, yellow。
LOFFER的默认状态是teal,要更换主题颜色,只要打开文件_sass/_variables.scss
,将文件中所有的teal全部替换成你想要的颜色。例如,查找teal,替换indigo,全部替换,commit,完成!
新版本增加目录功能,在post的信息中心加入toc: true
,这篇博文就会显示目录了。
这次没有对config的修改,因此应该可以通过这个方法,给自己提pull request来更新。
目录基于jekyll-toc by allejo制作。
目前我试用发现了一点小问题:如果你的标题级数不按套路变化,它就会搞不懂……
# 一级标题
下面必须是## 二级标题
,如果是### 三级标题
它就人工智障了【手动扶额】
注意:目前目录仅在桌面版显示。
新版本进一步优化了一下样式,并且支持了基于GitHub Issues的评论Gitalk(请看下文的配置说明)。
如果你已经fork了LOFFER,想要更新到新版本的话,可以试试这个方法,或者你也可以干脆删掉重来,只要保留自己的大部分config设定和所有的post就好。
LOFFER只是容器,你的posts才是博客的核心。
LOFFER是一个博客模板,使用GitHub Pages发布个人博客是没有任何问题的。 但是:
- 请勿发布成人向内容
- 不要将大量图片上传到GitHub
- 不要用我的Discus账户,请配置你自己的,本文档中有教程
如有疑问,请阅读GitHub Pages官方说明。
另外,同人作品更好的发布平台是AO3,你想你发在AO3还有tag还有kudos还有人看,是吧?
首先,这个博客主题适应手机阅读,但是,要使用它建立你自己的博客,你需要上电脑操作。
请点击GitHub,注册一个GitHub账户。我们可以理解Git就是个文件版本管理系统,本身并不需要会代码即可使用。
现在你看到的LOFFER,是作为一个GitHub上的Repository(代码库)存在的,你可以把这个代码库复制到你自己的GitHub账户中,这个操作叫做Fork。
点击LOFFER,进入LOFFER的GitHub Repository页面,然后点Fork:
然后你立刻就可以看到LOFFER再次出现,这次它已经属于你了,这里我建议你重命名它,点击settings,给你的博客起个名字(请尽量使用字母而非中文)。
然后,向下拉页面,你会看到“GitHub Pages”,这是GitHub内置的网站host服务,选择master,如图所示:
在几秒钟后,刷新此页面,你通常会看到这个绿色的东西(如果没看到,多等一会),你的网站已经发布成功,点击这个链接,即可查看:
你可能会看到网站长得很丑,请继续下一步.
在你的博客的GitHub代码库页面里,选择Code,文件列表里选择_config.yml,点击打开,点击右上角笔形图标修改文档。
修改完成后,点击“Commit changes”。每次修改过代码库并且commit后,GitHub Pages都会自动重新发布网站,只要等上几分钟,再次刷新你的博客页面,就会看到你的修改了。
还有一点,LOFFER使用的是MIT协议,大意就是全部开源随意使用,如果你要保留自己博文的权利,请编辑LICENSE文件,写上类似“_posts中的文档作者保留权利”这样的内容。
在你的博客的GitHub代码库页面里,点开_posts文件夹,这里面就是你的博客文章。
这些文章使用的格式是Markdown,文件后缀名是md,这是一种非常简单易用的有格式文本标记语言,你应该已经注意到,在LOFFER自带的示例性博文中有一篇中文的Markdown语法介绍。
更简单的办法是使用Typora,这是一个全图形化界面,全实时预览的Markdown写作软件,非常轻量,而且免费。
在发布博文前,你需要在文章的头部添加这样的内容,包括你的文章标题,发布日期,作者名,和tag等。
---
layout: post
title: LOFFER文档
date: 2019-06-02
Author: 来自中世界
categories:
tags: [sample, document]
comments: true
---
完成后,保存为.md文件,文件名是date-标题,例如 2019-06-02-document.md (注意这里的标题会成为这个post的URL,所以推荐使用字母而非中文,它不影响页面上显示的标题),然后上传到_posts文件夹,commit,很快就可以在博客上看到新文章了。
少量图片可以上传到images文件夹,然后在博文中添加。
但是GitHub用来当做图床有滥用之嫌,如果你的博客以图片为主,建议选择外链图床,例如sm.ms就是和很好的选择。
如果想要寻找更适合自己的图床,敬请Google一下。
在博文中添加图片的Markdown语法是:![图片名](URL)
LOFFER支持Disqus评论,虽然Disqus很丑,但是它是免费的,设置起来又方便,因此大家也就不要嫌弃它。
首先,注册一个Disqus账户,我们可以选择这个免费方案:
注册成功后,新建一个站点(site),以LOFFER为例设置步骤如下:
首先站点名LOFFER,生成了shortname是loffer,类型可以随便选。
安装时选择Jekyll。
最后填入你的博客地址,语言可以选中文,点Complete,即可!
然后需要回到你的博客,修改_config.yml文件,在disqus字段填上你的shortname,commit,完成!
新增内容,LOFFER 0.2.0版本支持Gitalk评论区(在LOFFER示例站中仍然是Disqus,可以在我的博客查看Gitalk的demo),设置方法如下:
首先,创建一个OAuth application, 设置如图:
点Register后就会看到你所需要的两个值,clientID和clientSecret,把它们复制到你的_config.yml文件中相应的字段:
gitalk:
clientID: <你的clientID>
clientSecret: <你的clientSecret>
repo: <你的repository名称>
owner: <你的GitHub用户名>
然后commit,你的Gitalk评论区就会出现了。对于每一篇文章,都需要你来进入文章页,来初始化评论区,这一操作会在你的repository上创建一个Issue,此后的评论就是对这个Issue的回复。
你可以进入你的repository的Issue页面,点Unsubscribe来避免收到大量相关邮件。
注意:出于很明显的原因,最好不要同时添加Disqus和Gitalk评论区。
这部分由于LOFTER的导出文件十分优秀,需要另外解决。
诸位可以使用墨问非名太太的脚本,其中选择Jekyll输出即可。
我个人也在折腾一个脚本,目前还没有完全debug清楚,不管如何,请先在lofter里导出一下,存在本地也是好的,贴吧可以让2017以前所有内容全部消失,中国互联网,没什么不可能发生的。
- Jekyll - 这是本站存在的根基
- Kiko-now - 我首先是fork这个主题,然后再其上进行修改汉化,才有了LOFFER
- Font Awesome - 社交网络图标来自FontAwesome的免费开源内容
介绍更多人来使用它,摆脱lofter自由飞翔!
当然如果单说写同人的话,我还是建议大家都去AO3,但是自家博客自己架也很酷炫,你还可以选择很多其他的forkable Jeykll主题,GitHub上有很多,或者试试其他博客架设工具,例如Hexo,与代码斗其乐无穷。
最后,回到LOFFER,给我点一个☆吧!