基本配置

设置你的 Miracle! 主题

设置分类

目前(截至 Beta.0.1.2 版本),Miracle! 的设置项共分为信息(info)、显示(display)、优化(improvement)、高级(advanced)、开发者设置(developer settings) 这几个分类。

分类是为了帮助你更快地找到你需要的设置,这些设置被折叠在对应分类的分类栏里,点击即可展开,也可以点击设置面板上方的「展开所有设置项」一键展开。

以后可能会添加设置搜索功能

信息(Information)

信息分类下的设置通常是用来配置博客的基本信息,例如:博客名字、博客描述、博主名字。比较好理解,这里就不赘述了。

不过还是要讲一下,这里的设置和 Typecho 的基础设置不一样,Typecho 设置中的站点信息通常是用在 meta 标签这样用户看不到的地方,而这里的设置则是用来显示的,例如「博客名称」这一设置会被放在首页大图的标题位置。

显示(Display)

显示分类下的设置通常与布局、排版、图片有关。

第一个设置就是基本布局,Miracle! 提供四种不同的布局,不过目前只有第一种可用,选择其他的会导致样式错误。

首页大图是展示在页面顶部的图片,对尺寸没有严格要求,但尽量选择宽度大于一千,高度不小于五百的图片,留空则会显示比较简洁的灰色。以后会考虑将移动端和电脑端大屏的首页大图分开。

主题色设置目前不可用,以后可能会在之后的三种布局中应用,也可能会被移除。

导航栏默认会读取所有可见的页面和分类,如果不想要默认的导航栏,可以按照以下格式对导航栏进行自定义。注意,一定要按照格式书写,否则会产生错误。

{
"首页": "/",
"项目": "#item",
"名字": "url",
"下拉导航": {
"测试": "https://test.com/"
},
......
}

Favicon 指的是显示在浏览器标签页左边的小图标,你可以填入一个图片 url 来自定义这个 favicon,留空则显示主题默认的 favicon

优化(Improvement)

Pjax 能让页面切换更流畅,加快网站整体加载速度,提升用户体验,建议保持开启。Pjax 回调函数是在 Pjax 完成页面切换之后会调用的函数,通常用来重载切换页面后失效的一些 JavaScript 脚本,通常留空。

如果你使用了 Meting 音乐插件,你可能需要在 Pjax 回调函数里写上 loadMeting(); 来重载 Aplayer,避免播放器失效。

HTML 压缩用来去除 html 源代码之间多余的空格和换行并删除注释,以压缩页面的体积,能在一定程度上优化传输速度和节省流量,对后端不会有太大影响,建议打开。

高级(Advanced)

字体 CDN 默认调用的是 Google Font,如果速度不佳或无法访问,可以切换成 lolinet 提供的字体镜像源。目前主题只支持思源黑体作为全站字体,自定义 CDN 里写的,也只能是引入思源黑体的 CSS。若关闭 CDN,则显示系统默认非衬线字体。

Gravatar CDN 是用来调用评论头像的镜像源,默认使用的是 V2EX 提供的镜像源,相对稳定,目前还不支持自定义镜像源。

TimThumb 白名单目前没用,保持默认即可。

多语言是为了国际化而准备的(但现在最多是弄着好玩),默认是 zh-cn (简体中文),目前主题也只内置了这一个语言包,以后会添加更多。你可以复制 libs/lang/ 目录下的 zh-cn.php 文件制作新的语言包。多语言设置里填写的是语言包的标识名,也就是语言包文件的名字(去掉 .php

全站评论开关是用来一键关闭/开启评论功能的,当你在备案或者有其他特殊需求的时候可以打开这个设置。

开发者设置(Developer Settings)

开发者设置是为了帮助有前端基础的用户改造主题而添加的,可以自定义页眉、页脚以及 CSS 和 JS,设置页面写得很清楚,这里也不赘述了。