概述
本主题由欧雷于 2015 年开始设计与开发,并在个人网站「欧雷流」及个人各种开源软件的文档站上使用多年;在设计时以提高阅读体验和保持简洁风格为最高原则,体现个性在其次。
因而,适用于博客、个人网站、API 文档站等以内容为主的网站。
兼容环境
在编写主题代码时,尽可能地使用兼容性高的写法,并适配多种网站构建方式:
环境 | 兼容性 |
---|---|
浏览器 | 大部分 PC 与移动端现代浏览器 |
静态网站生成器 | Jekyll、Hexo |
相关技术
既然你来了解本主题了,那我就假定你已具备 HTML、CSS 和 JavaScript 相关知识——无论你通过何种方式使用本主题,它们都是本主题得以在浏览器中呈现效果的基本条件。
为了更好地搭建页面与提供更丰富的使用体验,本主题依赖(并包含)下列库和服务:
名称与版本 | 说明 |
---|---|
Bootstrap v3.3.6 |
界面交互 |
Font Awesome v4.7 |
字体图标 |
LinXoid | 链接到互联网名片 |
Disqus | 国外的评论托管服务,因众所周知的缘由而无法正常访问,主题支持通过 DisqusJS 为国内用户代理查看评论 |
Share.js | 将页面便捷分享到社交网络 |
若是搭配静态网站生成器使用,除了 Markdown 和 YAML 之外,根据你的选择,还需额外了解一些技术:
静态网站生成器 | 特定技术 |
---|---|
Jekyll | kramdown、Liquid |
Hexo | EJS |
当你想利用主题内的可复用资源以及打算修改源码或为主题做贡献的话,需要了解下编写源码的语言(方言):
构成部分 | 语言或方言 |
---|---|
模板 | Liquid(Jekyll)、EJS(Hexo) |
样式 | Sass(SCSS) |
脚本 | CoffeeScript(遗留代码,新功能不用) |
如何使用
本主题支持多种使用方式,详见《快速上手》。
主题署名
虽说本主题源码开放并免费使用,但还是希望能够在使用时保留主题和提供者的名字与来源——
在使用时,默认会在页面底部(即 footer
中)的版权声明右边显示主题和提供者的名字与来源相关信息:

但这并非是强制的,可通过在网站配置文件中将 copyright.provider
设为 false
以关闭显示;或把 footer.partial
改为自定义的页脚去覆盖。
如果可以,请不要关闭默认页脚中主题和提供者的名字与来源的显示;如需完全使用自定义页脚文件,也请在页脚加上如下 HTML 代码:
|
感谢理解与配合!🙏🏼🙏🏼🙏🏼
反馈问题
若看遍本站内的文档和 GitHub Issues 上的已有问题后仍无法解决所遇到的问题,请尽可能地详细描述并提交你的问题,我会尽快处理。
或者你有条件帮忙修复,欢迎提 PR!👏🏼👏🏼👏🏼