主题命名为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.png11月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评论
- 二维码打赏
这个主题作者的网站已经打不开了,轻语功能我用不了,可以请教一下用法吗?非常喜欢这个主题。独立页面里设置了轻语模板,在主题里设置轻语在首页显示无效
抱歉,主题的时间太久了,具体使用方法我也忘记了,可以在其他站点找找看。我在主题文档中更新了论坛介绍的网址,可以去找找看