lock_door's Introduction
lock_door's People
lock_door's Issues
LaTex渲染的说明和测试
https://binpro.xyz/blog/math-test/
LaTeX渲染已经在全站头部文件引入,可以直接使用,公式块上下使用$$标明,内联公式则用$.
最好不要让公式出现在文章摘要里。
Jekyll的默认文章摘要是第一段,但是我在使用中发现它选取摘要不是很稳定,因此加入了手动摘要分割线,默认为`
LOFFER文档
https://binpro.xyz/blog/document/
LOFFER是个可以帮助你get off from LOFTER的软件(我知道这个pun很烂)。
这是一个可以通过Fork直接发布在GitHub的Jekyll博客,你不需要编写代码或使用命令行即可获得一个部署在GitHub的博客。
更新内容
2019-07-25 V0.4.0
修订目录跳级会坏掉的问题,不算完美解决,但不会坏掉了。
增加对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,完成!
2019-07-20 V0.3.0
新版本增加目录功能,在post的信息中心加入 toc: true ,这篇博文就会显示目录了。
这次没有对config的修改,因此应该可以通过这个方法,给自己提pull request来更新。
目录基于jekyll-toc by allejo制作。
目前我试用发现了一点小问题:如果你的标题级数不按套路变化,它就会搞不懂……
一级标题 下面必须是 ## 二级标题 ,如果是 ### 三级标题 它就人工智障了【手动扶额】
注意:目前目录仅在桌面版显示。
2019-06-30 V0.2.0
新版本进一步优化了一下样式,并且支持了基于GitHub Issues的评论Gitalk(请看下文的配置说明)。
如果你已经fork了LOFFER,想要更新到新版本的话,可以试试这个方法,或者你也可以干脆删掉重来,只要保留自己的大部分config设定和所有的post就好。
LOFFER只是容器,你的posts才是博客的核心。
注意
LOFFER是一个博客模板,使用GitHub Pages发布个人博客是没有任何问题的。 但是:
请勿发布成人向内容
不要将大量图片上传到GitHub
如有疑问,请阅读GitHub Pages官方说明。
另外,同人作品更好的发布平台是AO3,你想你发在AO3还有tag还有kudos还有人看,是吧?
如何使用
首先,这个博客主题适应手机阅读,但是,要使用它建立你自己的博客,你需要上电脑操作。
第一步 Fork到你的GitHub
请点击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一下。
可选:添加评论区
Disqus
LOFFER支持Disqus评论,虽然Disqus很丑,但是它是免费的,设置起来又方便,因此大家也就不要嫌弃它。
首先,注册一个Disqus账户,我们可以选择这个免费方案:
注册成功后,新建一个站点(site),以LOFFER为例设置步骤如下:
首先站点名LOFFER,生成了shortname是loffer,类型可以随便选。
安装时选择Jekyll。
最后填入你的博客地址,语言可以选中文,点Complete,即可!
然后需要回到你的博客,修改_config.yml文件,在disqus字段填上你的shortname,commit,完成!
Gitalk
新增内容,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的内容
这部分由于LOFTER的导出文件十分优秀,需要另外解决。
诸位可以使用墨问非名太太的脚本,其中选择Jekyll输出即可。
我个人也在折腾一个脚本,目前还没有完全debug清楚,不管如何,请先在lofter里导出一下,存在本地也是好的,贴吧可以让2017以前所有内容全部消失,**互联网,没什么不可能发生的。
致谢
Jekyll - 这是本站存在的根基
Kiko-now - 我首先是fork这个主题,然后再其上进行修改汉化,才有了LOFFER
Font Awesome - 社交网络图标来自FontAwesome的免费开源内容
帮助这个项目
介绍更多人来使用它,摆脱lofter自由飞翔!
当然如果单说写同人的话,我还是建议大家都去AO3,但是自家博客自己架也很酷炫,你还可以选择很多其他的forkable Jeykll主题,GitHub上有很多,或者试试其他博客架设工具,例如Hexo,与代码斗其乐无穷。
最后,回到LOFFER,给我点一个☆吧!
Markdown语法简介
https://binpro.xyz/blog/chinese-markdown-cheatsheet/
本中文版Markdown语法简介来自博客 https://blog.shengbin.me/posts/markdown-syntax
Markdown语法的完整介绍在这里:http://daringfireball.net/projects/markdown/syntax。下面整理的这些为了方便写博客时参考。
分段与分行
以一个或多个空行来隔开段落;以两个或多个空格来段内换行。
标题
This is an H1
This is an H2
This is an H1
This is an H2
This is an H6
引用
在每一行前面写一个>:
This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
效果:
This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.
或者在每一段前面写一个>:
This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
多重引用
This is the first level of quoting.
This is nested blockquote.
Back to the first level.
效果:
This is the first level of quoting.
This is nested blockquote.
Back to the first level.
列表
列表项占一行,以*、+、-开头即可:
- Red
- Green
- Blue
效果:
Red
Green
Blue
有序列表只需要将上述标记符换成数字加句点。而且顺序由书写顺序决定,与数字无关,但数字需要从1开始。例如:
1. Bird
3. McHale
2. Parish
效果:
Bird
McHale
Parish
每一个列表项可以多行:
- Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus. - Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
效果:
Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.
代码块
每一行前面缩进四个或以上个空格,就认为是开始了一段代码块。代码块内原样输出。
This is a normal paragraph:
This is a code block.
效果:
This is a normal paragraph:
This is a code block.
横线
三个或更多个*、-(它们之间可以有空格)会产生横线:
效果:
链接
内嵌链接:
I get 10 times more traffic from [Google](http://google.com/
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.