Initial - 主题使用文档

主题命名为 Initial，意为“初”，专注于文字，算是极极极简风格吧，简约而不简单，希望你能喜欢这种很小众的风格，这篇文档就是来介绍这款 Typecho 主题的用法。

如何使用

下载主题包并解压，把解压出来的文件夹改名为“initial”，将文件夹上传至网站文件主题目录下，网站后台启用这款 typecho 主题即可。

一、文章内设置项

此处为编辑文章时，最下方“自定义字段”位置的选项设置，此处的设置只对当前文章或者页面生效。

文章缩略图

文章缩略图就是在首页或者归档页才会显示的一张展示图片(图片大小无任何限制，请自行控制)。
本主题是一个主打文字的主题，所以默认是不显示文章缩略图的，如果需要显示缩略图，在编辑文章或者页面时，最下方的“自定义字段”位置有一个“自定义缩略图”的选项，可以输入你喜欢的图片的地址来作为该文章的缩略图。如果想要使用文章内的第一张图片作为缩略图，只需输入数字“1”即可（若该文章内无图，则不显示）。

2.3 版本更新：文章缩略图支持调用文章内的任意图片。如果想要使用文章内的第三张图片作为缩略图，只需输入数字“3”即可（若该文章内无第三张图片，则不显示）。

文章目录

默认关闭，启用则会在该文章内显示“文章目录”，如果文章内无任何标题，就算此选项已启用，也是不会显示目录的。

二、轻语

轻语是 2.3 版新出的一项功能，类似于说说，用于发表一些小动态 or 小牢骚 or ...
使用此功能需要先在后台创建独立页面，然后选择“轻语”模板即可（若不想在导航栏显示，可以设置为隐藏）。在这款 typecho 主题的前台进入此页面，如果是在登录状态下，您就可以在此页面发表“轻语”了。若您想在首页展示你的“轻语”，您可进入后台-控制台-外观设置内找到“显示最新的轻语”选项，勾选对应的位置即可。

注意：

• “轻语”支持 Markdown 语法，默认支持<br><strong><a><img><pre><code>这几个标签，如果需要支持更多标签，请在后台-设置-评论内找到“允许使用的 HTML 标签和属性”，添加对应的标签即可。
• “轻语”对图片大小无限制（max-width:100%），请自行控制。
• 管理“轻语”（修改、删除、等操作）请在后台-管理-评论内操作。（“轻语”基于 Typecho 的评论功能）
• 目前发布“轻语”的权限设置为（2.4 版更新为：具有“编译”以上权限的用户）所有登陆用户，即你的网站内所有已注册用户登陆后都可发表，后续看反馈是否需要调整。
• 开启“轻语”将强制“将较新的的评论显示在前面”。
• 有其余问题可随时提问。

三、链接

此项为 2.1 版本新增的功能，但从 2.4 版开始，链接列表已从外观设置迁移至管理-独立页面-链接模板页面-自定义字段-links内。

新用户若需要使用“链接”功能，请前往 后台-管理-独立页面-新增页面-自定义模板-选择“链接” 创建“链接”模板页面，然后新增“自定义字段”，字段名称设置为links，字段值按照下方的格式输入即可插入链接。

添加链接

管理链接列表请编辑“链接”模板（后台-管理-独立页面-链接模板页面），在最下方的自定义字段-links内按照以下格式添加即可。

链接输入格式：
链接名称*,链接地址*,链接描述,链接图标,链接分类

不同信息之间用英文逗号“,”分隔，例如：
OFFODD,http://www.offodd.com/,JIElive 的博客 | 有点不同 ,https://www.offodd.com/logo.png,Myself

若中间有暂时不想填的信息，请留空，例如暂时不想填写链接描述和链接图标：
OFFODD,http://www.offodd.com/,,,Myself

若结尾有暂时不想填的信息，无需逗号，可直接留空，例如暂时不想填写链接图标和链接分类：
OFFODD,http://www.offodd.com/,JIElive 的博客 | 有点不同

多个链接换行即可，一行一个

小技巧：如果某个链接已经失效，但是又不需要立即删除它，常用场景就是链接站点无法访问或者友链站点把你的友链删除了，你就可以给链接名称加上<del>标签，把链接地址留空，把链接描述改为原因，然后链接地址和链接描述可以放到链接分类后面来备份，例如：
<del>OFFODD</del>,,暂时无法访问 ,,Myself ,备份：http://www.offodd.com/JIElive 的博客 | 有点不同 https://www.offodd.com/logo.png

11 月 7 日更新：若 链接地址 留空，则自动添加<del>标签

链接功能使用效果可以预览本站的链接页面。

四、后台设置

绝大部分的内容都在这里。
我发现竟然很多人不知道有主题设置或者不知道在哪里，这里说一下，进入后台-控制台-外观-外观设置。

站点 LOGO 地址

默认是显示后台设置的站点名称（文字版），此处可以填入你的 LOGO 图片的地址，填入后就会在站点名称显示的位置显示你填入的 LOGO（站点名称不再显示），图片高度是限制最高 30 像素，超出则会缩小到 30 像素高，宽度不限。

自定义站点副标题

站点标题就是你使用浏览器浏览网站时，在浏览器上显示的网站名称，默认只显示站点名称，此处可以填入一个你喜欢的副标题，填入后将在原标题后方使用“ - ”分隔符显示你设置的副标题，例如：标题 - 副标题。（副标题仅在首页时显示）

Favicon 地址

Favicon 就是你使用浏览器浏览网站时，在浏览器标题前显示的网站小 LOGO，填写一个你的 LOGO 地址即可。（Favicon 建议使用 ico 格式）

CSS 文件的链接地址替换

此项设置是方便给使用了 CDN 服务的朋友使用，可以把本主题的 CSS 文件替换为你的 CDN 文件，直接输入 CSS 文件在你的 CDN 的父级目录链接即可，例：

1
CSS文件原地址是  http://www.example.com/usr/themes/initial/style.min.css
2
CSS文件在你的CDN内的地址是  http://www.cdn.com/initial/style.min.css
3
那么此项设置你应该输入  http://www.cdn.com/initial/

文章内的链接地址替换

此项设置也是方便给使用了 CDN 服务的朋友使用，可以把文章或页面内的指定链接替换为另一个你需要的链接，原链接和替换链接之间使用等号“=”分割，可以设置多个替换规则，一行一个。替换链接是替换文章或页面内的所有符合条件的链接，所以建议使用在附件链接上面，而且尽量把原链接写全，以免“误伤”。

导航栏显示

此项设置是设置这款 typecho 主题头部导航栏的显示内容。

• 显示分类：启用将显示所有文章分类
• ↪合并分类：将分类合并为下拉菜单显示，需要启用“显示分类”后，此项才可生效
• 显示页面：启用将显示独立页面
• ↪合并页面：将独立页面合并为下拉菜单显示，需要启用“显示页面”后，此项才可生效

导航栏-分类 下拉菜单显示名称

当“导航栏显示”设置为“显示分类”、“合并分类”后，导航栏内的分类会生成一个下拉菜单，此项设置可以自定义这个下拉菜单的显示名称，留空则默认显示为“分类”。

导航栏-页面 下拉菜单显示名称

同上一项

面包屑导航显示

• 文章内显示：启用将会在文章内显示面包屑导航
• ↪文章标题替换为“正文”：启用后会将文章内的面包屑导航的文章标题部分替换为“正文”
• 页面内显示：启用将会在独立页面内显示面包屑导航

微信打赏二维码

填入你的微信打赏二维码图片地址, 就可以在文章底部添加微信打赏，留空则不设置微信打赏，（建议图片尺寸不低于 240*240）

支付宝打赏二维码

同上一项

浮动显示头部

2.0 版全新的头部样式，有跟随和固定两种显示方式，默认是常规的跟随显示，启用此项后，头部将始终显示。

动态显示侧边栏

启用后将动态滚动显示侧边栏，默认关闭。

公共静态资源来源

公共静态资源包括 CSS 框架、JS 库等公共库文件，此设置可将切换主题的公共资源文件，比如前段时间 BootCDN 迁移导致暂停服务，就可以暂时切换至其他来源，或根据网站的受众人群，选择合适的来源

HTML 压缩

启用后将压缩 HTML 代码，酌情开启。

全站 Pjax

Pjax 是一种网站局部刷新技术，做到页面加载时只刷新指定的部分，不刷新整个页面，不用多次的 JS、CSS 解析，只更新必要的内容，避免了页面重新渲染的过程。开启后将同时开启 ajax 评论，并强制关闭“反垃圾保护”，强制“将较新的的评论显示在前面”。

Ajax 翻页

Ajax 翻页默认关闭，开启后，文章翻页将使用 Ajax 方式获取。

返回顶部

启用后将在右下角显示“返回顶部”按钮

背景音乐

默认关闭，请选择“顺序播放”或者“随机播放”以启用，启用将在右下角显示“音乐控制”按钮（需在下一步输入音乐地址），背景音乐功能建议配合“全站 Pjax”使用。

背景音乐地址

上一步启用背景音乐后，需在此处输入完整的音乐地址（建议 mp3 格式，兼容性最好），可以输入多个音乐，一行一个。

背景音乐播放音量

输入一个你觉得合适的背景音乐播放音量，0~100%音量对应 0~1 之间的小数，比如输入 0.25 表示 25%的音量。

显示链接图标（内页）

2.2.1 版新增功能，启用后内页（链接模板）链接将显示链接图标，若某个站点未设置链接图标，将尝试自动获取图标，若获取失败则图标显示为“★”。无 链接地址 的链接不会显示图标

首页显示的链接分类

链接在首页显示的分类，若首页只需显示某分类下的链接，在此输入链接的分类名即可，如果要显示多个分类的链接，可在多个分类名之间用英文逗号“,”分隔，留空则默认显示全部链接。分类名建议使用字母形式

内页（链接模板）显示的链接分类

链接在链接模板页面显示的分类，若链接模板页面只需显示某分类下的链接，在此输入链接的分类名即可，如果要显示多个分类的链接，可在多个分类名之间用英文逗号“,”分隔，留空则默认显示全部链接。分类名建议使用字母形式

首页显示链接

链接在首页显示的位置，可设置在侧边栏显示或者在页面底部显示

显示最新的“轻语”

将在选择的位置显示最新的一条“轻语”

侧边栏显示

侧边栏需要显示的项目

ICP 备案号

输入网站的 ICP 备案号，将在底部显示，留空则关闭此项

底部自定义内容

此处可以输入你的网站统计代码，也可以输入一些其他 JS 内容，若开启了全站 Pjax，建议使用百度统计或者 Google 统计。

这位作者还分享了这款 Typecho 教程，也可以了解一下。

更新历史

2018/09/04：发布第一版
2018/09/08：更新 1.1 版本
2018/09/12：更新 1.2 版本
2018/09/17：更新 1.2.1 版本（增加返回顶部过渡动画，微调部分样式，添加标签云，修复小 BUG）
2018/09/28：更新 1.3 版本
2018/10/12：更新 2.0 版本
2018/11/02：更新 2.1 版本
2018/11/23：更新 2.2 版本
2018/11/28：更新 2.2.1 版本
2018/12/14：更新 2.3 版本
2018/12/24：更新 2.3.1 版本
2018/12/25：更新 2.3.2 版本
2019/01/04：更新 2.4 版本
2019/01/09：更新 2.4.1 版本
2019/01/14：更新 2.4.2 版本
2019/02/20：更新 2.4.3 版本
2019/12/11：更新 2.4.4 版本
2020/09/04：更新 2.4.5 版本
2020/09/11：更新 2.5 版本
2020/09/16：更新 2.5.1 版本
2020/10/21：更新 2.5.2 版本
2022/03/09：更新 2.5.3 版本
2022/10/12：更新 2.5.4 版本
2023/02/20：更新 2.5.5 版本

2.5.5 版更新内容

• 修复部分用户背景音乐播放音量无法设置的问题
• 适配返回顶部新算法,修复返回顶部后无法继续下拉的问题

2.5.4 版更新内容

• 新增单栏模式（关闭侧边栏，简单优化了一下样式）
• 修复当文章被设置为隐藏或私密时，依旧能通过侧边栏小工具访问的问题
• 优化加密文章展示效果

之前一位网友提出的一个建议 “可不可以考虑下取消所有侧边栏后，内容居中，太需要了。” ，真是一个很不错的想法啊，这样 Initial 不就秒变成为一个简单的单栏主题了吗？😄

2.5.3 版更新内容

• 修复 Ajax 翻页双击(多击)问题
• 修改过度样式，解决刷新页面后页面移动问题
• 更新几个 Gravatar 头像源

2.5.2 版更新内容

• 后台新增“自定义样式”（优先级大于默认样式）
• 字体大小和行距稍微增大（阅读更轻松）
• “文章许可信息”可关闭显示
• 备案号链接跟随调整（这玩意为什么又变了？😟）
• 优化轻语评论逻辑
• 其他细节调整与优化

本次更新主要是调整了字体大小，希望能够使阅读更加轻松。

2.5.1 版更新内容

• 新增“代码高亮”（Highlight.js）
• 修复关闭 Pjax 时产生报错的问题
• 大量优化与调整
• 重写了“轻语”和“最近回复”的部分代码
• 优化部分页面结构，更有利于 SEO
• 其他细节调整

本次更新新增了便于阅读的“代码高亮”功能（阻滞页面，影响加载速度，虽然很微弱，但是不爽😑）。

js 文件使用 base62 转码压缩，如果需要查看源码，可在浏览器控制台内点击Initial By JIElive http://www.offodd.com 这个 log 右上角的链接，里面就是 js 源码，可以方便大家 mod.

上个版本提取 js 后有可能会出现一些 BUG，虽然我已经尽量把能想到的问题全部测试通过了，但不排除还有没发现的问题，如果发现问题欢迎留言反馈。

2.5 版更新内容

• js 写入独立文件
• 修复关闭 Ajax 翻页时,加密文章无法打开的问题
• 删除公共静态资源来源“BootCDN”（太不稳定）
• 其他微调优化

本次更新主要是把 js 语句全部写入独立的 js 文件，配合 pjax 和 cdn，访问速度理论上应该有所提升，其余更新内容不多。

2.4.5 版更新内容

• 站点标题支持自定义显示方式（仅文字、仅 LOGO、LOGO+文字）
• 文章目录添加全局开关
• 添加 Staticfile 静态资源 CDN
• 其他微调

更新内容不多，不想覆盖升级的可以参照 GitHub 自行修改。

2.4.4 版更新内容

• 优化分类名过长时的显示问题
• 备案号链接地址更新
• archive 页面添加文章阅读量显示
• 关闭偶尔可能会出现的无关紧要的 php 提示
• 其他优化与小调整

小小更新一下，以上问题基本不影响使用，想省事的可以自行修复一下即可。

2.4.3 版更新内容

• 删除外观设置内从 2.4 版本开始弃用的链接列表（已迁移至 管理-独立页面-链接模板页面-自定义字段-links 内）
• 新增“轻语”的评论回复功能，并优化评论样式
• 新增文章底部“文章许可信息”，可在后台自定义内容
• 修复“轻语”评论无法换行的问题
• 修复某些情况下“文章目录”按钮状态异常
• 修复“注脚”链接新窗口打开的问题
• 优化导航下拉列表，不再限制宽度
• 优化评论框架结构，回复评论目标更清晰
• 其他优化与小调整

注意：从本版开始，后台-外观设置内的 链接列表 已彻底删除，新的链接列表已迁移至 管理-独立页面-链接模板页面-自定义字段-links 内，以后的链接操作都需要在这里进行。

2.4.2 版更新内容

• 新增背景音乐“随机播放”选项，请在 后台-控制台-外观-设置外观-背景音乐 处修改
• 将文章、页面、轻语的外链接、评论者的链接修改为使用使用新窗口打开（仅外链接使用新窗口，本站链接还在当前页打开）
• 调整“文章目录”按钮位置到右下角并美化界面，仅当文章有目录时，才会显示
• 后台设置选项判断优化（老用户请进入 后台-设置外观 将未选择的设置项重选一下即可，不影响使用，请正常升级）
• 其他优化与小调整

本次更新以查找问题为主，需要注意的就是主题设置项进行了优化，新用户忽略即可，老用户升级后，请到 后台-设置外观 ，可以看到有几个单选的设置项被清空了，只需要重新选择一下并保存就行，当然，如果你不重新选择，也不会影响使用🤨。

2.4.1 版更新内容

• 调整“文章目录”选项位置到 编辑文章 内，可单独设置每篇文章是否显示文章目录（默认关闭）
• 调整侧边栏“最近回复”超链接，点击自动跳转至评论位置
• 部分代码优化

本次更新依然是小更新，优化为主，主要是调整了“文章目录”的开启关闭方式，从之前的 主题设置 移动到 编辑文章 内，可单独设置每篇文章是否显示文章目录（默认关闭）。

2.4 版更新内容

• 新增文章阅读量统计与显示
• 新增文章目录（默认关闭）
• 新增“轻语”的评论功能
• 将“链接列表”迁移至“链接”页面内，防止丢失
• 稍微增加移动端字体大小
• 修复关闭 Pjax 时某些情况下无法评论
• 修复几处 PHP Notice
• 优化 Archive 作者页标题
• 优化热门文章排序规则
• 代码优化和其他优化调整

注意：从 2.4 版开始，链接列表 已迁移至 管理-独立页面-链接模板页面-自定义字段-links 内，以后的链接操作都需要在这里进行，主题设置处的列表暂留备份，再更新几次后将会彻底删除。

此次更新最需要注意的就是“链接列表”，从主题设置迁移到了“链接”模板页面的自定义字段内。

老用户更新 2.4 版主题后

若已创建 链接模板页面，前台刷新该页面，将会自动将之前的 链接列表 迁移至 链接模板页面 内。

若未创建 链接模板页面，请前往 管理-独立页面-新增页面-自定义模板-选择“链接” 创建“链接”模板页面，然后前台访问该页面，将会自动将之前的 链接列表 迁移至 链接模板页面 内。

新用户若需要使用“链接”功能，请前往 管理-独立页面-新增页面-自定义模板-选择“链接” 创建“链接”模板页面，然后新增“自定义字段”，字段名称设置为links，字段值按照之前的 链接格式 输入即可。具体使用方法可以点击这里查看。

2.3.2 版更新内容

• 优化子分类显示（同一父分类下的所有级别的子分类都将显示在该父分类下，级别太多也不好吧😥）。
• 其他小调整。

子分类这个东西之前从来没有使用过，所以也一直没有发现这个问题，谢谢网友**@luvnaxx**发现并提出。

2.3.1 版更新内容

• 新增切换 Gravatar 头像源，官方源、国内源、V2EX 源
• 丰富 Ajax 翻页选项，自动、点击、关闭
• 删除 DNS 预获取、删除自定义 Apple 图标
• 其他优化与小调整

最近年底了，事情很多，更新不会很大，以优化和修复为主。

2.3 版更新内容

• 新增 Ajax 翻页，支持自动翻页与点击翻页
• 新增“轻语”功能（类似说说），并新增一套极简“轻语”模板，支持在首页和侧边栏显示
• 文章缩略图支持调用文章内的任意图片（例如：输入数字“2”代表使用文章内第二张图片）
• 再次优化加密文章与 Pjax 冲突问题，已经趋近完美
• 解决进入“归档”页面时侧边栏的文章数量异常
• 其他功能优化与小调整（比较多，记不清了）

本版更新主要在“轻语”这个功能，折腾了很久，本以为挺简单，但实际操作才发现有很多小问题，还好都解决了，目前正常使用没问题，后续更新会丰富此功能。 其次就是添加了 Ajax 翻页，这个也是很多朋友期待的，欢迎更新品尝，若有问题随时站内反馈😋

2.2.1 版更新内容

• 链接功能添加链接图标参数
• 链接模板内的链接增加图标显示（默认关闭）
• 其他小调整

本版更新为小更新，主要由于在后台的“链接列表”增加了一个“链接图标”的参数，考虑到要尽量减少对使用者的影响，故提前更新。

2.2 版更新内容

• 添加侧边栏动态滚动（默认关闭）
• 调整右下角小工具位置，解决超宽屏尴尬
• 添加背景音乐播放进度条
• 修复关于链接的小问题
• 清除翻译语句
• 其他细节调整与小 BUG 修复

2.1 版更新内容

• 新增一套链接模板
• 新增链接功能，可在首页（侧栏或页底）和链接模板内显示，可自定义要显示的分类
• 新增自定义公共静态资源来源，支持 BootCDN、CDNJS、jsDelivr
• 修复加密文章与 Pjax 有冲突的问题（感谢 okgo 发现并提出此 BUG，估计带 Pjax 的 TE 主题都有此问题😖）
• 修复侧边栏热门文章显示数量使其与后台设置一致
• 移除 Normalize，将其优化集成进主题 css
• 背景音乐优化、界面微调优化
• 其他细节调整与小 BUG 修复（优化了很多细节，记不起来了🤣）

2.0 版更新内容

• 公共静态资源由 BootCDN 替换为 CDNJS（BootCDN 已暂停）
• 重新设计的网站头部样式
• 新增可将头部设置为固定显示
• 新增导航栏可自定义显示分类、页面、是否合并显示等（充足的自定义）
• 新增自定义副标题，取消自定义描述（因为头部重做后已不显示此项）
• 新的 a 标签颜色，整体样式微调
• 新增面包屑导航（可自定义）
• 新增侧边栏热门文章
• 其他细节调整与小 BUG 修复

本版更新主要在外观，变化较大，当然，细节和新增功能也是精益求精，望君喜。

1.3 版更新内容

• 使用 excerpt 摘要函数，可自动截取摘要
• 阅读量统计（这个目前还不确定是否要加上）暂时不加
• 自定义文章缩略图或者自动调用文章第一张图片作为缩略图
• URL 替换（主要是方便于使用七牛等 cdn 的静态文件镜像加速）
• HTML 代码压缩
• 背景音乐添加支持多首歌曲循环，添加错误歌曲检测，自动跳过
• 添加评论区文章作者小标签
• 其他细节调整与优化

1.2 版更新内容

• 优化部分细节
• 修复一处关于 Ajax 评论的逻辑性小错误
• 添加右下角小工具
• 返回顶部(1.2.1 版添加过渡动画)
• 背景音乐
• 侧边栏添加标签云（1.2.1）

背景音乐这个真是折腾了好久，因为主要是想使用网易的音乐，再加上要尽量做到最轻量，看了几个 API 框架，直接就放弃了（虽然做完只有不到 100KB，但还是觉得太大了），最后找到一个不错的开放 API，可惜不支持 https😖貌似没办法了。。。
晚上回家思考了一下，制作本主题的初衷就是简约而不简单，既然是要“简约”何不做到极致？好像找到了新的大门🤩

最后确定使用原生 HTML5 播放器（隐藏式），后台自定义一首你最最喜欢的音乐循环播放（后台可给音乐设置一个合适的音量），仅使用一个按钮来集成播放状态提示、播放控制、播放进度，*播放和暂停状态提示由纯 CSS 实现；播放和暂停控制由原生 JS 实现。*虽然没有使用框架那么强大的功能和兼容性，但觉得非常符合本主题初衷。

1.1 版更新内容

• 全站 Pjax + ajax 评论
• 二维码打赏