Mirages主题帮助文档

时间:2022-07-22
本文章向大家介绍Mirages主题帮助文档，主要内容包括其使用实例、应用技巧、基本知识点总结和需要注意事项，具有一定的参考价值，需要的朋友可以参考一下。

给自己备份一份 原文档

快速上手

安装主题和插件

主题安装压缩包里包含了主题、插件两项内容，其目录结构如下：

主题安装压缩包
  -- 1.主题文件
  -- 2.插件文件
  -- 9.静态文件未压缩版(不需要上传至主机)

1. 安装主题文件

将压缩包内1.主题文件文件夹中的Mirages文件夹完整上传到服务器上 Typecho 的/usr/themes/文件夹内，然后到 Typecho 后台，启用主题即可。

2. 安装插件文件

Mirages专用插件是用于增强 Mirages主题功能的部分，其提供了诸如友链样式、在线更新、云存储优化等功能，推荐安装。

安装方法：

将压缩包内2.插件文件文件夹中的Mirages文件夹完整上传到服务器上 Typecho 的/usr/plugins/文件夹内，然后到 Typecho 后台，启用插件即可。

静态文件未压缩版不需要上传至您的服务器，其中包含了 Mirages 主题的 css 和 js 未压缩版文件，根据需要保存到您的计算机上即可。

更新主题和插件

主题在后台的控制台->外观->设置外观页面提供了主题最新版本的检测功能。在有新版本之后，您可以选择使用在线更新或手动更新来完成主题和插件的更新操作。

1. 在线更新

Mirages 主题提供了方便的主题新版本提醒和在线更新功能，在更新时，仅需到 控制台 -> 插件 -> Mirages -> 设置，点击更新主题和插件至最新版本按钮即可。更新过程视服务器环境差异约在3秒至180秒左右。请耐心等待。

在线更新完成后，旧版主题暂时不会删除，如果您没有修改过主题的源代码，则可以点击下方的删除旧版主题功能清理旧版主题，否则，请在执行必要的备份或迁移工作后再对旧版主题进行清理。

请不要启用旧版主题或其他主题，该操作会导致当前主题配置项完全丢失！

另外，如果该功能提示服务器环境无法进行在线更新，则可以手动对主题和插件进行更新。

2. 手动更新

将主题压缩包内的主题文件和插件文件解压出来，然后参照安装步骤对旧版主题进行上传覆盖即可。

强迫症同学可以将原有主题和插件进行删除，再参照安装步骤上传新的主题和插件。

但请注意：不管是在线更新还是手动更新，请不要轻易启用其他主题（包括旧版主题），启用其他主题的操作会导致当前主题的配置项完全丢失！

后面可能会用到的简称：

主题设置页面：Typecho后台的 控制台->外观->设置外观 页面

插件设置页面：Typecho后台的 控制台->插件->Mirages->设置 页面

必须的配置项

归档页

归档页必须要创建，否则文章页的 「返回文章列表」会出现 404 错误。

新建方法：

新建一个独立页面（管理-独立页面-新增）：

  • 标题根据自身喜好填写即可。例如：归档 或 Archive 等；
  • slug（标题下面的那个）填写为：archives。
  • 自定义模板选择Archives。
  • 发布页面

关于页

如果关于页面不存在，则点击侧边栏头像跳转时会出现 404 错误

新建方法：

新建一个独立页面（管理-独立页面-新增）：

  • 标题根据自身喜好填写即可。例如：关于 或 About 等；
  • slug（标题下面的那个）填写为：about。
  • 内容部分按需发挥
  • 发布页面

建议了解的内容

侧边栏及导航条菜单项

侧边栏及导航条菜单项为你的「独立页面」，可以在管理 -> 独立页面进行隐藏、排序等操作。

阅读更多按钮

目前主题首页及其他文章列表中使用带格式的文章输出，而不是将正文文本去格式后截断。

如果你只想输出部分文章，那么你可以在需要截断的地方使用``标签截断文章。截断后列表页预览时将仅显示标签前的内容，并显示阅读更多按钮。

编辑器工具区有「摘要分割线」按键，可以在你当前编辑区域光标所在位置插入上述标签。

文章头图 Banner

文章头图可以在文章页最下方自定义字段的第一项：Banner这里设置。

设置后，文章页标题上方将会显示横幅图片。

卡片式友链样式

卡片式友链样式需要Mirages专用插件的支持，若要使用此项功能，请启用插件。

卡片式友链样式可以在任何页面中启用，仅需按照下面的书写格式书写即可。

基本语法为：[名称](链接)+(头像链接)

头像大小建议为400*400

Links 可以分组，在两个链接之间加入可见字符即可。

参考：

### 菊苣们
[Typecho](http://typecho.org)+(http://image.qiniudn.com/head.png?imageView2/2/w/400/q/50)
[哈哈](http://haha.cn)+(http://image.qiniudn.com/head.png)
[haha](https://haha.en)+(http://image.qiniudn.com/head.png)

### 逗比
[Hran](https://hran.me)+(http://duanjstatic.qiniudn.com/hran/2016/01/07/145213578473155_labtocat.png?imageView2/2/w/400/q/85)
嗯。。。

友链页与关于页

友链页与关于页是我们常用的两个独立页面，主题对其做了简单的样式定义。该样式可以参考我博客的友链页和关于页样式。

若要启用此样式，你需要将友链页的 URL 变更为 /links.html、关于页的 URL 变更为 /about.html

另外，这两个页面会预留 Banner 的位置，所以建议设置Banner。

主题常用设置

配图及图像管理 - 站点背景大图地址

这里可以设置一张图片，以在博客首页展示一张大图。效果的话。。。见过我主题的应该都知道的吧。。

自定义颜色 - 自定义主题主色调

可以设置主题的主色调，用于加载条、链接、选中文字等内容。

评论系统

默认的话，主题使用的是 Typecho 内置的评论系统，不需要做什么特殊的配置。

另外，主题还内置了 Disqus，如果需要使用这些评论系统则可以在主题外观设置中设置对应的Disqus Short Name即可。

PJAX - 页面无刷新更新

默认的话并没有启用，你可以到主题外观设置中选择启用即可。

常见问题

下面会列出一些经常被问到的问题，排名不分先后，且从不做排序，请善用Ctrl + F 或 Command + F进行网页搜索，谢谢。

主题可以对文章进行加密吗？

对文章进行密码保护是Typecho的功能。在编辑文章的时候右边（手机的话是下方）高级选项里可以选择密码保护或私密，密码保护的文章所有人都能看到，但需要输入密码后才能查看文章的标题和内容，私密则仅有自己可以看到，隐藏的话，所有人都不能在文章列表里看到，但均可以通过URL进行访问。

在哪里可以下载到主题？

主题是付费的哦，没有提供免费下载的地方。 如需购买可以到 小商店 进行购买。

对于各位已经购买的用户，需要下载主题的时候也是需要到小商店去下载了。 已购用户注册时请使用之前给你们发过主题附件的邮箱进行注册。 需要变更邮箱以及邮箱限制无法注册的同学私我解决。 注册完成后，不要购买主题，直接到我的订单里同步历史订单即可。有不听劝的我是不会退款的。

简陋的小商店传送门

启用主题后出现了 Server Error / Database Error / 页面空白 / 主题报错 / 5XX 错误 等异常

一般是由于环境缺失某些组件或 Typecho 配置错误导致的。

如果出现了 Typecho 的页面错误，需要开启 Typecho 的调试模式，然后将显示的错误详情发给我进行处理。

Typecho 开启调试模式：

在config.inc.php里加入:

define('__TYPECHO_DEBUG__', true);

如果是其他错误，可以尝试通过下面的方法开启打印报错信息，然后将具体的报错信息发给我进行处理，如果没有打印报错信息，则通常不是由于主题或插件造成的。 在 Typecho 的 index.php 文件中（注意，不是主题的 index.php 文件），添加如下内容：

error_reporting(E_ALL);
ini_set('display_errors', '1');

具体的添加位置示例：

<?php
/**
 * Typecho Blog Platform
 *
 * @copyright  Copyright (c) 2008 Typecho team (http://www.typecho.org)
 * @license    GNU General Public License 2.0
 * @version    $Id: index.php 1153 2009-07-02 10:53:22Z magike.net $
 */

// =============   在这行下面添加   ==================
error_reporting(E_ALL);
ini_set('display_errors', '1');
// =============   在这行上面添加   ==================

/** 载入配置支持 */
if (!defined('__TYPECHO_ROOT_DIR__') && !@include_once 'config.inc.php') {
    file_exists('./install.php') ? header('Location: install.php') : print('Missing Config File');
    exit;
}

在问题处理完成后建议删除以上添加的内容。

主题有没有更新？最新版是多少？

在主题的外观设置页面可以查看到主题的版本及最新版是多少，默认情况下仅展示正式版，若想接收开发版主题，则可以在主题专用插件设置的 仅接受正式版更新 选项选择 否，我愿意更新到开发版 。

主题首页文章怎么设置成卡片式样式

卡片式文章列表仅在 1.7.4 及以上版本可用。

启用的话，到主题外观设置页面，使用卡片式文章列表选项启用即可。

主题支持插入表格吗？

表格有专用的Markdown语法，可以参考Markdown 语法简介，另外，Typecho需要1.1（15.5.12）及以上版本才支持表格解析。

文章置顶要怎么搞？

文章要置顶的话可以使用插件Sticky，百度搜一下Typecho Sticky好了，或参考：https://github.com/hitop/typechoSticky 主题已经内置了代码，你只需要安装并配置相关设置即可。

文章浏览数 / 阅读数统计要怎么搞？

需要使用TePostViews插件，下载后上传到插件目录然后启用即可。不需要修改代码，主题已经内置了。

插件下载地址 备用下载地址

侧边栏菜单怎么配置？

侧边栏菜单的内容来源于你的独立页面，新增或删除独立页面后，侧边栏菜单会相应更改。

侧边栏菜单如何排序？

侧边栏菜单的内容来源于你的独立页面，所以你可以在 管理 -> 独立页面 对独立页面进行隐藏、排序等操作，侧边栏菜单会相应更改。

侧边栏头像怎么修改？

侧边栏头像有两种修改方式：

  1. 直接修改 导航栏 -> 侧边栏头像，在选项中填入头像链接即可。
  2. 修改 Gravatar 头像。关于如何修改 Gravatar 头像请参考下一条。

建议使用第二种方式。 Gravatar 头像会在你评论自己或其他 Typecho、WordPress等博客的评论时作为头像展示。

如何修改 Gravatar 头像 / 自己的评论头像如何修改？

你在评论时展示的头像为 Gravatar 头像。Gravatar 是一个头像服务，他通过你评论时留下的邮箱进行匹配。因此注册此服务时需要注意注册时使用的邮箱。

你可以通过点击：控制台 -> 个人设置 -> 点击左侧的头像 进入 Gravatar 注册账号并上传头像。

为什么我主题的菜单/导航栏/导航条和你的不一样？

主题提供两种导航栏样式，可以通过主题外观设置：导航栏 -> 导航栏样式 处自由切换。 需要注意的是：顶部导航栏会在较小屏幕下(屏幕横向宽度小于 768) 回退到 侧边栏模式。目前也不排除后续会对此进行修改。

横向导航条 / 顶部导航栏最左侧的 Mirages 怎么修改？

前往主题外观设置: 导航栏 -> 网站 Logo 处进行修改。

默认评论/自带评论/原生评论的默认头像怎么改?[]()

在主题外观设置的 默认 Gravatar 头像 处填入默认的头像URL即可。

如何修改默认评论/自带评论/原生评论的 Gravatar 服务，使用国内的Gravatar服务?

在Typecho 1.1(17.10.24)及以上版本可以在config.inc.php文件中定义常量：__TYPECHO_GRAVATAR_PREFIX__，例如：

define('__TYPECHO_GRAVATAR_PREFIX__', 'https://cdn.v2ex.com/gravatar/');

1.1(17.10.24)以下的版本可以通过插件进行修改。

图片阴影怎么添加？

博主的图片阴影都是截图工具自带的，因大部分情况下平台不同，所以就不介绍截图工具了，有兴趣的可以自行搜索。

博客提供了另外一种方式添加图片阴影：只需在图片 Url 后面加上#shadow即可。

例如：

![图片描述](http://img.example.com/path/to/image.jpg#shadow)

效果：

友情链接要怎么添加？

可以参考这篇文章：固定页面（友链、关于、归档等）的使用说明

友情链接按照格式书写了但不生效是什么原因？

如果确定是按照上个问题中提供的文档中的方式书写的，那么可以看看以下原因是否满足：

  • 必须安装并启用主题专用插件
  • 必须使用Markdown的格式进行书写，即控制台 -> 个人设置 -> 使用 Markdown 语法编辑和解析内容 这个选项要打开。
  • 如果使用了第三方的可见即可得编辑器插件，则可能会影响上一条条件中的设置。

友情链接头像错位是什么情况？

出现这种情况是因为友链头像尺寸要求为严格的正方形，及图片的长宽相等，差一个像素都不可以。头像图片大小建议为 400*400。

我在用 Meting/APlayer/DPlayer/JWPlayer/其他 插件的时候不生效怎么回事？

请参考：Mirages 插件冲突解决方案

怎么在文章中直接输出 HTML 代码？

请参考：如何在 Typecho 开发版中直接输出 HTML 代码

主题中怎么插入视频？

如果不使用插件的话，可以使用video标签来添加，具体请百度/Google，另外，如果是 Typecho 最新版本的话，需要参考：如何在 Typecho 开发版中直接输出 HTML 代码

使用插件的话，可以尝试 JWPlayer、DPlayer 等。使用方式请参考具体的插件帮助文档。

文章二维码加载失败了怎么办/文章二维码怎么设置？

之前用的是百度云的二维码 API，但最近失效了。目前我这边没有什么比较靠谱的二维码 API，你可以进入主题外观设置更换自己的二维码 API，或者使用热心网友提供的二维码 API。

目前可用的二维码 API有：

//bshare.optimix.asia/barCode?site=weixin&url={{%LINK}}

或者前往：最新可用的二维码生成 api - 不死鸟 查看更多

如何设置网站图标/favicon

默认情况下，取网站根目录的 favicon.ico文件，你可以将图标文件放置在 Typecho 的根目录下。

图标文件转码可以使用搜索引擎搜索ico 转换。

如果想使用链接的形式设置图标/favicon，可以参考高级设置中的相关设置进行处理。

另外，如果需要设置 Apple 设备(主要包括 iOS 及 macOS 设备)的浏览器图标，则可以参考如下代码，并添加到【主题自定义扩展 -> 自定义 HTML 元素拓展 - 标签: head 头部 (meta 元素后)】中：

<meta name="apple-mobile-web-app-capable" content="yes">
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
<link rel="apple-touch-icon" href="http://example.com/icon-36.png">
<link rel="apple-touch-icon" sizes="72x72" href="http://example.com/icon-72.png">
<link rel="apple-touch-icon" sizes="120x120" href="http://example.com/icon-60@2x.png">
<link rel="apple-touch-icon" sizes="144x144" href="http://example.com/icon-72@2x.png">
<link rel="apple-touch-icon" sizes="152x152" href="http://example.com/icon-76@2x.png">
<link rel="apple-touch-icon" sizes="180x180" href="http://example.com/icon-60@3x.png">

图片的格式为 png 格式，均为正方形。图片的批量生成可以使用 PhotoShop 脚本完成。

下载 PhotoShop Scripts

主题自动更新有什么要求 / 哪些目录需要写入权限？

主题自动更新要求以下目录有写入权限：

/usr/themes
/usr/plugins

部分环境可能需要配置 777 权限才能正常使用。

另外，自动更新功能还有如下要求：

  1. 访问外网的功能
  2. PHP 的 zip 模块

启用主题后没有显示主题的 404 页面 / 404 页面没有效果 / 404 页面还是以前的 / 404 页面还是默认的

出现这个原因是因为你的 Nginx / Apache 接管了 404 页面的处理，因此将 Nginx / Apache 中的 404 页面的相关配置注释掉即可。

文章分类的主图 / 头图 / Banner 怎么设置？

分类的主图不可以手动设置。分类的主图的获取逻辑为：

随机取当前分类下非第一篇文章设置的文章主图，如果文章中没有设置主图则取不到主图。

主题目前不支持取文章中的随机主图，必须是手动设置的文章主图才可以展示。

Typecho 后台登录 / 启用主题 / 启用插件 / 编辑文章 等 Typecho 后台操作出现 404 错误

Typecho 伪静态配置错误。

如果使用宝塔面板，可以尝试切换伪静态为 Typecho 后重试

Nginx 的伪静态配置参考：

    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php$1 last;
    }

Apache 伪静态配置参考：

RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ /index.php/$1 [L]

如果仍然无法解决，建议移除（或关闭虚拟主机）的伪静态配置后重试，或 百度/Google 搜索其他解决方案，该问题不是由主题或插件造成的。

启用云存储优化后，样式丢失了 / 样式错乱 / 页面错乱

该问题可能因为 云存储回源配置错误。 云存储中，镜像 / 回源的设置应该为博客的地址。 检验方式如下（假设 你的云存储域名为 http://cdn.yuncunchu.com）：

在浏览器中访问：http://cdn.yuncunchu.com/usr/themes/Mirages/screenshot.png，可以访问则代表成功。

主题中 CDN 镜像加速域 应该为的云存储域名，且必须包含 http:// 或 https:// 建议修改后重试。

主题首页大图 / 文章主图 / banner 无法加载，显示为黑色

建议检查一下图片链接是否正确，图片链接通常需要以 http:// 或 https:// 开头，且链接没有防盗链限制（从我博客复制的图片链接是会有防盗链的哦）。

主题首页大图 / 文章主图 / banner 电脑端可以显示，但手机上显示为黑色

建议检查一下图片的格式，不是图片的后缀，而是图片真实的格式。

通常造成这个的原因是使用了 webp 等电脑端支持但手机端可能不支持的图片格式。

自定义字段

自定义字段的设置在文章或独立页面的编辑区下方的自定义字段处。

自定义字段的作用范围为当前编辑的文章或独立页面，不会影响其他的文章或独立页面。通常优先级回比主题外观设置及高级设置中的全局设置要高。

文章主图高度

字段名：bannerHeight

设置页面 Banner 的高度，不设置则使用主题默认高度， 取值范围 0-100，为浏览器可视区域的高度百分比

禁用文章主图

字段名：disableBanner

在该页面不显示文章主图，即使配置了文章主图。

文章标题显示主图中

字段名：headTitle

作用与同名高级设置相同，但优先级更高。

将文章标题显示在文章主图中，取值范围为整数，大于 0 则表示开启，否则不开启。文章主图中的标题可以使用 mastheadTitle 和 mastheadSubtitle 自定义

文章主图标题

字段名：mastheadTitle

自定义展示在文章大图内的标题，该选项可以替换掉默认的文章标题

文章主图副标题

字段名：mastheadSubtitle

自定义展示在文章大图内的副标题（展示在标题下方）

文章主图标题颜色

字段名：mastheadTitleColor

设置展示在文章大图内的标题及副标题的颜色，默认为白色，在文章标题颜色与图片冲突时可以使用

对齐方式

字段名：textAlign

设置文章或独立页面的对齐方式，值有left、center、right、justify，默认为justify(两端对齐)。

文章最大宽度

字段名：contentWidth

设置文章或独立页面的最大宽度，当然一般情况下文章宽度就是你设置的值，除非受设备宽度限制。

自定义 CSS

字段名：css

自定义 css。注意仅在当前文章页生效。

自定义 JS

字段名：js

自定义 js。注意仅在当前文章页生效。

显示文章目录树

字段名：showTOC

1.7.2 及以上版本请使用「显示文章目录树」设置。

为当前文章生成目录树，目录树按钮会显示在文章右侧屏幕边缘（需1.6.0及以上版本）。值为1时生效。

另外，该字段可以简写为 TOC

重定向页面

1.7.10 及以上版本可用

字段名：redirect

将页面重定向到指定的页面。该处值请填写完整的网页链接。

独立页面

侧边栏内容

侧边栏菜单项为你的「独立页面」，可以在 管理 -> 独立页面 进行隐藏、排序等操作。

归档页

归档页必须要创建，否则文章页的"返回文章列表"会出现404错误

新建一个独立页面，自定义模板选择 Archives 即可。

友链页

友链页的卡片样式可以在任何页面中启用，仅需按照下面的书写格式书写即可。

如果你的友链页 URL 为 /links.html

那么，必须要添加一个背景图才会显示标题，样式将和我博客上的一样。背景图的添加方法见：主题自定义字段使用帮助

另外对于标题的位置，你可以以填写自定义字段 css 的方式修改。

如将标题放置在左下角：

#masthead {
    text-align: left;
}
.align-middle .inner {
    vertical-align: bottom;
}

友链页的书写格式

1.7.0及以上版本需要启用 Mirages 插件

基本语法为：[名称](链接)+(头像链接)

头像图片必须为正方形(差一个像素都不可以)，大小建议为400*400

Links 可以分组，在两个链接之间加入可见字符即可。

参考：

### 菊苣们
[Typecho](http://typecho.org)+(http://image.qiniudn.com/head.png?imageView2/2/w/400/q/50)
[哈哈](http://haha.cn)+(http://image.qiniudn.com/head.png)
[haha](https://haha.en)+(http://image.qiniudn.com/head.png)
### 逗比
[Hran](https://get233.com)+(http://duanjstatic.qiniudn.com/hran/2016/01/07/145213578473155_labtocat.png?imageView2/2/w/400/q/85)
嗯。。。

关于

如果你的关于页 URL 为 /about.html

那么，必须要添加一个背景图才会显示标题及头像，样式将和我博客上的一样。

导航栏操作按钮

说明

Mirages 主题在1.6.0版本中添加了侧边栏 Toolbar，你可以在此放置你喜欢的图标，如 RSS、社交账户链接、夜间模式切换等。

Toolbar 默认显示两个按钮：RSS 和夜间模式切换。

自定义方式

配置 Toolbar 也很简单，只要一行一个配置即可。

Toolbar 最多可以设置5个按钮

一个 Toolbar 包含两个部分：Font-awesome图标名称和链接。

例如：

github:https://github.com/Dalodd

github即为Font-awesome图标名称，:后面的部分即为链接，当然你也可以放入其他可以放入 href 中的东西，如 javascript 等。

更多的Font-awesome图标可以点击这里查看（4.7.0以上版本新增的图标可能不受支持）。

另外：

Toolbar 默认显示两个按钮：RSS 和夜间模式切换也可以设置隐藏，链接部分设置为hide即可。可以只隐藏一个，也可以全部隐藏。当可显示的按钮数量为0的时候即可隐藏 Toolbar。

例如：

RSS:hide
Night-shift:hide

1.7.4及以上版本

1.7.4版本移除了原有的「夜间模式切换」按钮，并替换为了「阅读设置」按钮，其隐藏方式如下：

Read-settings:hide

短代码

短代码是主题提供的一种快速生成特定内容的方式。

目前主题支持的短代码还不多，后续会进行扩充（真的，不管你信不信，反正我是信了）

短代码的书写方式为：

 [shortcode param="value"]内容[/shortcode]
 [shortcode param="value"/]

基本为以上两种写法，需要 Content 的使用第一行的写法，不需要的采用第二行的写法。

其中，shortcode 为短代码的名称，后面的列表中会提供，同一种样式可能会有一个或多个别名；例如短代码 hint 及 tip 其实是同一个短代码。

param="value" 为短代码的参数，内容 为短代码的内容（参数说明中将简称为 内容）。

目前可能可用的短代码列表

具体的示例及使用说明请参考页面：短代码 - Mirages 帮助文档

高级设置

设置说明

由于设置项越来越多，且在可预见的未来内，由于各种需求可能会加进去更多的设置项，所以在本来就已经存在非常非常多的设置项的情况下，我决定要做出一点小小的改变。

所以，一些(我认为)不常用的设置项就惨遭删除了。但是，并不是说这些设置项以后就没办法使用了，它们只是换了一种方式存在。

真 • 高级设置

这是一个新的选项，位置在 高级设置->真 • 高级设置 ，是所有其他类设置的归宿。

像上面那种被删除(目前实际是被隐藏)的设置项，都可以在这里进行配置。不止这些，一些新加的且我觉得并不常用的设置项也可以在这里进行配置。

配置方法

和其他的一些多行配置一样，也是一行一个，每一个配置由设置名 + 设置值组成。

设置名 = 设置值

必须要等于号哦(两边的空格无所谓)，且最后不能有;哦

示例：

tagLimit = 25
themeSelectionBackgroundColor = #C0F4AF
themeSelectionColor = #333
customFontFace = head_font_hran.php
otherOptions.enableSSCROnWindows = 1
#greyBackground = 1
#这条及上面这条都是注释，不生效。

高级设置列表

自定义 Selection Color

设置名：themeSelectionColor

说明

使用鼠标选中文字时文字的颜色, 默认为白色, 你可以自定义任何你喜欢的颜色, 但必须使用 Hex Color, 即#233333或#333的格式。填写错误的格式可能不会生效。 建议根据颜色色调使用黑色或白色。

示例

themeSelectionColor = #233333

自定义 Selection Background Color

设置名：themeSelectionBackgroundColor

说明

使用鼠标选中文字时文字、图片等元素的背景颜色, 默认(此项不填)和自定义主题主色调相同, 你可以自定义任何你喜欢的颜色, 但自定义主色调必须使用 Hex Color, 即#233333或#333的格式。填写错误的格式可能不会生效。

示例

themeSelectionBackgroundColor = #233333

主题字体加载方式

设置名：webFont

说明

不设置为使用主题(主机)内置字体，值设置为1则为使用Google字体。

示例

# 使用 Google Fonts 加载字体
webFont = 1


# 使用主题内嵌的字体文件加载
webFont = 0

Shortcut Icon/网站图标/favicon

设置名：shortcutIcon

说明

值填写 URL 或网站相对路径。 不设置则使用网站根目录下的「favicon.ico」文件

示例

shortcutIcon = https://example.com/favicon.ico

为 Windows 平台的 Chrome 浏览器启用平滑滚动

设置名：otherOptions.enableSSCROnWindows

说明

顾名思义。值大于 0 时启用

示例

# 启用
otherOptions.enableSSCROnWindows = 1


# 不启用
otherOptions.enableSSCROnWindows = 0

自定义Font face

设置名：customFontFace

说明

用于设置自定义的字体信息。若要配置此项，你可以参照主题目录下的 head_font.php 在/usr目录创建一份自己的 php 文件, 在此文件中定义 font-face, 然后在这里填入你新建的 php 文件的文件名(包括".php").

你只能自定义以下字体名称(font-family):

Mirages Custom : 优先级最高，可作用于所有屏幕。若不自定义该 font-family，则自动使用之后的字体。

Merriweather : 较高的优先级，仅可作用于高分辨率(pixel-ratio >= 1.5)屏幕。若不自定义该 font-family，则将在高分辨率屏幕使用主题默认设定的字体。

Open Sans : 较高的优先级，仅可作用于低分辨率(pixel-ratio < 1.5)屏幕。若不自定义该 font-family，则将在低分辨率屏幕使用主题默认设定的字体。 该选项仅在「主题字体加载方式」设置为「主题内置」的情况下生效。

示例

# my_font_face.php 文件位于 /usr/themes/Mirages/usr/my_font_face.php
customFontFace = my_font_face.php

标签云数量限制

设置名：tagLimit

说明

设置归档页标签云的数量限制，默认为30。

示例

tagLimit = 25

启用灰色背景

1.7.8及以上版本已移除此功能

设置名：greyBackground

说明

设置后主题的白色背景将被替换为灰色，值大于1时即启用。

示例

# 启用
greyBackground = 1


# 不启用
greyBackground = 0

设置行内代码高亮颜色

1.7.2及以上版本可用

设置名：codeColor

说明

设置行内代码的高亮颜色。

示例

codeColor = #233333

评论关闭后仍然显示历史评论

1.7.4及以上版本可用

设置名：showHistoryCommentEvenClosed

说明

在文章评论关闭后，默认设定下是隐藏已有的评论列表的。

在开启此功能后，即使关闭了文章评论，已有的评论仍然会显示出来。

该功能对所有文章生效

示例

# 开启功能
showHistoryCommentEvenClosed = 1

禁用所有评论

1.7.4fix1及以上版本可用

设置名：commentDisabled

说明

关闭所有文章的评论功能

示例

# 开启功能
commentDisabled = 1

禁用文章最后修改时间

1.7.8 及以上版本可用，之前版本没有文章最后修改时间功能

设置名：disableModifyTime

说明

禁用文章的最后修改时间功能

示例

# 禁用文章最后修改时间
disableModifyTime = 1

全局文本对齐方式设置

1.7.8 及以上版本可用

设置名：textAlign

说明

设置全局的文本对齐方式，可用的参数为：

  • 左对齐：left
  • 右对齐：right
  • 居中对齐：center
  • 两端对齐：justify

主题默认设置为 justify

示例

# 禁用文章最后修改时间
textAlign = left

禁用文章页显示默认背景图

1.7.9 及以上版本可用，之前的版本这个属于默认值，不需要设置

设置名：disableDefaultBannerInPost

说明

如果文章未设置文章主图，则会默认到「卡片式文章列表的背景图列表」中选取图片显示。该高级设置可以关闭此功能

示例

# 禁用文章页显示默认背景图
disableDefaultBannerInPost = 1

以高斯模糊的形式加载文章主图

1.7.9 及以上版本可用

设置名：blurBanner

说明

以高斯模糊的形式加载文章主图，效果为对文章主图进行高斯模糊处理。 该效果依赖图片加载动画功能，浏览器端仅需要加载 64 像素的小图片即可，图片处理在浏览器端进行。

另外可以通过 自定义字段 blurBanner 覆盖某篇文章的全局设置

该功能的具体效果为banner在图片加载动画加载到高斯模糊阶段即停止，不会加载完整的 banner 图片。

示例

# 以高斯模糊的形式加载文章主图
blurBanner = 1

顶部导航栏最大菜单数量

1.7.9 及以上版本可用

设置名：maxNavbarMenuNum

说明

设置显示在顶部导航栏的最大菜单个数，默认值为 7，超出的菜单会显示在「更多」里。 需要注意的是，过多的菜单栏会导致在较小宽度的浏览器下菜单一行显示不下而折行的问题，因此该值不建议修改。

示例

maxNavbarMenuNum = 8

归档页按年度分组

1.7.9 及以上版本可用

设置名：archivesGroupByYear

说明

归档页按年度分组

示例

archivesGroupByYear = 1

从文章加载第一篇文章作为主图

7.10.0 及以上版本可用

设置名：enableLoadFirstImageFromArticle

说明

在没有配置文章主图的时候，默认从文章加载第一篇文章作为主图

示例

enableLoadFirstImageFromArticle = 1

对所有图片启用图片阴影效果

7.10.0 及以上版本可用

设置名：enableImageShadow

说明

对所有文章中的所有图片启用图片阴影效果

示例

enableImageShadow = 1

横向导航栏 Logo 的跳转链接

7.10.0 及以上版本可用

设置名：navbarLogoUrl

说明

设置横向导航栏 Logo 的跳转链接，仅对横向导航栏中的 Logo 有效，(Logo 即为横向导航栏最左边的可选项，7.10.0 默认名称为「首页」，在此之前默认名称为 「Mirages」)

示例

navbarLogoUrl = https://get233.com

文章主图下边界添加弧型遮罩

7.10.1 及以上版本可用

设置名：showBannerCurveStyle

说明

在文章主图下方添加一个与背景色相同的弧形遮罩。

示例

showBannerCurveStyle = 1

站点背景大图高度

7.10.1 及以上版本可用

设置名：showBannerCurveStyle

说明

站点背景大图及文章主图高度占屏幕总高度的百分比，取值范围 1 ~ 100。默认值为 55

示例

defaultBgHeight = 55

站点背景大图手机端高度

7.10.1 及以上版本可用

设置名：defaultMobileBgHeight

说明

站点背景大图及文章主图高度占屏幕总高度的百分比，取值范围 1 ~ 100，该选项区别于上一个，仅作用于手机端（竖屏）。默认值为 40

示例

defaultMobileBgHeight = 40

标题显示在文章主图中

7.10.1 及以上版本可用

设置名：headTitle

说明

该选项默认启用，在这里可以设置进行关闭

标题默认显示在文章主图中，没有文章主图会显示默认背景色。

你仍然可以通过自定义字段对某篇文章进行单独设置。

示例

headTitle = 0

文章目录树显示模式

7.10.1 及以上版本可用

设置名：TOCDisplayMode

说明

主题文章目录树选项需要在文章中手动启用后才会展示

这里的设置是文章目录树显示的位置及默认是否打开及是否可以关闭等。

显示模式可选值：

1 ==> 页面打开时目录树【隐藏】在文章【右侧】，页面仅展示展开按钮，【可通过】页面边缘的展开按钮展开或隐藏目录树。该选项是默认选项
2 ==> 页面打开时目录树【展示】在文章【右侧】，【可通过】页面边缘的展开按钮展开或隐藏目录树
3 ==> 页面打开时目录树【展示】在文章【左侧】，【可通过】页面边缘的展开按钮展开或隐藏目录树
4 ==> 页面打开时目录树【展示】在文章【右侧】，页面不会展示展开按钮，因此【不可通过】展开按钮展开或隐藏目录树
5 ==> 页面打开时目录树【展示】在文章【左侧】，页面不会展示展开按钮，因此【不可通过】展开按钮展开或隐藏目录树

文章目录树在手机端不会自动展开，不可隐藏的设置也将不生效。

示例

TOCDisplayMode = 2

字体风格选择

7.10.1 及以上版本可用

设置名：enableSerifFonts

说明

在这里，你可以简单的把 衬线体 理解为宋体，无衬线体 理解为黑体，如微软雅黑、苹方等。具体的区别可以参考百科。

在本主题中，二者的优劣如下：

无衬线体使用的范围较广，但在大篇幅文字的情况下阅读体验并不如衬线体。

衬线体更适合阅读，但适合的文章类型有限，并不适合带有代码的文章，适合的类型为大篇幅的文字，附带少量配图的文章，如小说、叙事、甚至作文等。衬线体对屏幕和渲染引擎的要求较高，但经测试，在低分屏 Windows 的主流浏览器（Chrome）上效果可以接受。另外，由于主题通过 webFont 的方式引入字体，所以启用衬线体后页面的加载流量会更大些（一篇 1000 字文章大概多 200KB 左右），且因网速的限制，在 webFont加载完成前会使用回退字体（除了 macOS，几乎其他系统都会会退到黑体，Windows 本人手动回退到了微软雅黑，默认宋体不能忍），在加载完成后，会有字体变更的问题，体验一般。

另外，由于中文 WebFont 字体实在太大，所以要启用衬线体，需要使用 Google Fonts 字体服务

说了这么多，如果你经常要放置代码，那我并不推荐你使用衬线体，请使用无衬线体选项，如果你文章的主要内容通常为大篇幅文字，那么可以设置衬线体尝试一下效果。

另外，用户也可以通过页面上的阅读设置进行选择，但仅对该用户生效。

示例

enableSerifFonts = 1

博客文章语言

7.10.1 及以上版本可用

设置名：contentLang

说明

针对特定语言的排版优化。如果为英文博客，则请将此选项设置为英语，否则请保持默认。

可选项：

zh ==> 中文(默认值)
en ==> 英语
en_serif ==> 英语(衬线体)

示例

contentLang = en_serif

始终显示控制台菜单

7.10.1 及以上版本可用

设置名：alwaysShowDashboardInSideMenu

说明

该选项目前仅在侧边栏生效

默认情况下，在你后台(Admin)保持登录状态时，将会在侧边栏显示「Dashboard」菜单可以快速进入后台。

勾选此选项后将始终显示此菜单项，未登录时将跳转到登录页面

示例

alwaysShowDashboardInSideMenu = 1

默认评论头像

7.10.1 及以上版本可用

设置名：defaultGravatar

说明

自带评论使用 Gravatar 服务，这里可以自定义评论者未定义头像时默认使用的头像

示例

defaultGravatar = https://example.com/head.jpg

不加载评论者的 QQ 头像

7.10.1 及以上版本可用

设置名：embedCommentOptions.disableQQAvatar

说明

自带评论系统中，默认情况下，在用户输入了数字前缀的 QQ 邮箱后，会将该用户的评论头像变更为邮箱对应的 QQ 的头像，启用该选项后，将禁用这一特性。

示例

embedCommentOptions.disableQQAvatar = 1

评论回复可见严格模式

7.10.1 及以上版本可用

设置名：embedCommentOptions.comment2ViewStrict

说明

启用该选项后，「评论回复可见」功能要求评论必须为通过状态（评论待审核或垃圾评论等不会使隐藏内容可见）

示例

embedCommentOptions.comment2ViewStrict = 1

更换评论系统为 Disqus

7.10.1 及以上版本可用

设置名：disqusShortName

说明

在这里设置你的 Disqus Short Name，即可将评论系统更换为 Disqus

示例

disqusShortName = example

横向导航条上展开一级分类

7.10.1 及以上版本可用

设置名：expandTopCategoryInNavbar

说明

默认情况下，横向导航条的分类仅展示一个「分类」下拉框，展开后显示所有一级分类。启用该选项后，导航条上将平铺所有的一级分类，一级分类下有二级分类的，将以下拉框的形式展示。

示例

expandTopCategoryInNavbar = 1

横向导航条高度

7.10.1 及以上版本可用

设置名：navbarSize

说明

修改横向导航条的高度，可选的参数有：

lg ==> 较高
md ==> 中等
sm ==> 较窄

默认为较高：lg

示例

navbarSize = md

随机文章
本站知识点必读
最近更新