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的父级目录链接即可，例：

CSS文件原地址是  http://www.example.com/usr/themes/initial/style.min.css
CSS文件在你的CDN内的地址是  http://www.cdn.com/initial/style.min.css
那么此项设置你应该输入  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评论
• 二维码打赏