jielive / initial

A Typecho Theme

Typecho主题 - Initial 简约而不简单（v2.5.5）

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

主题预览：https://www.offodd.com/

功能与特点

• 重新优化的响应式布局，移动端舒适体验
• 轻量级设计，极速浏览体验
• 傻瓜式后台设置，告别使用疑惑
• 公共资源支持切换源：Staticfile、jsDelivr、CDNJS
• Gravatar头像支持切换源：官方源、国内源、七牛源等。
• 支持主题静态文件、文章附件自定义链接，实现镜像加速
• 全站Pjax、Ajax评论、Ajax翻页、HTML压缩、CSS与JS文件压缩
• 支持自定义Favicon图标，自定义头部跟随或固定，自定义标题或LOGO，自定义导航栏显示等
• 支持自定义文章缩略图或者获取文章内任意图片作为缩略图
• 支持面包屑导航、文章目录、文章二维码打赏、代码高亮
• 支持“轻语”功能（类似说说）
• 内置链接功能，可在首页（侧栏或页底）和链接模板内显示，可自定义要显示的链接分类
• 添加侧边栏轻语、热门文章、标签云
• 添加三套极简模板：轻语模板、归档模板和链接模板
• 支持自定义备案号、网站统计代码
• 网页右下角小工具，包括返回顶部、背景音乐、文章目录
• 说明一下：背景音乐默认不加载，也就是说，如果不点播放按钮，是不会消耗任何流量的
• 更多细节，等你发现🤩

使用与更新

下载与使用

进入下载页面，下载主题包并解压（若是从GitHub下载，建议把解压出来的文件夹改名为“initial”），将文件夹上传至网站文件主题目录下，网站后台启用主题即可。

主题设置方面的问题可以看这里

更新

更新版本时，下载新版主题包并解压，直接把解压后的文件覆盖上传即可（对主题有修改请自行备份），无需切换至其他主题（这样就不会丢失设置）。

如发现BUG等问题，也请随时站内反馈😋

更新历史

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评论
• 二维码打赏

initial's Issues

Postviews 方法postgresql中报错

相关页面

./usr/themes/initial/archive.php:19:<li><?php Postviews($this); ?></li>
./usr/themes/initial/functions.php:240:function Postviews($archive) {
./usr/themes/initial/index.php:28:<li><?php Postviews($this); ?></li>
./usr/themes/initial/post.php:15:<li><?php Postviews($this); ?></li>

ie浏览器，返回顶部不会cancelAnimationFrame

使用ie浏览器，返回顶部会卡在顶部，无法下滑。

解决方法 取整

b.onclick = function totop() {
    var a = document.documentElement.scrollTop || document.body.scrollTop;
    if (a > 0) {
        requestAnimationFrame(totop);
        // window.scrollTo(0, a - (a / 5)) 
        window.scrollTo(0, a - (a / 5)>> 0)  // 取整
    } else {
        cancelAnimationFrame(totop)
    }
};

网站打不开了？

网页打不开了吗？

请支持Postgresql

ERROR: syntax error at or near "" LINE 1: ALTER TABLE typecho_contentsADDviews INT(10) DEFAULT 0... ^ Typecho_Db_Query_Exception: ERROR: syntax error at or near ""
LINE 1: ALTER TABLE typecho_contents ADD views INT(10) DEFAULT 0...
^ in /usr/local/www/nginx-dist/var/Typecho/Db/Adapter/Pgsql.php:109
Stack trace:
#0 /usr/local/www/nginx-dist/var/Typecho/Db.php(367): Typecho_Db_Adapter_Pgsql->query('ALTER TABLE ty...', Resource id #1, 1, 'SELECT', NULL) #1 /usr/local/www/nginx-dist/usr/themes/initial/functions.php(221): Typecho_Db->query('ALTER TABLE ty...')
#2 /usr/local/www/nginx-dist/usr/themes/initial/index.php(32): Postviews(Object(Widget_Archive))
#3 /usr/local/www/nginx-dist/var/Widget/Archive.php(2031): require_once('/usr/local/www/...')
#4 /usr/local/www/nginx-dist/var/Typecho/Router.php(138): Widget_Archive->render()
#5 /usr/local/www/nginx-dist/index.php(23): Typecho_Router::dispatch()
#6 {main}

能否实现“轻语”随机显示评论

评论有很多条，希望可以随机显示而不是显示最新一条。

评论异常

每次评论都会有提示：您输入的内容不符合规则或者回复太频繁，请修改内容或者稍等片刻。

轻语勾选无效，另外 音乐 音量设置 输入0.5 提示0-1之间，设置无效

docerk版，1.2.0， PHP 8.0

暂时发下的问题如题

显示文章附件

给大佬贡献代码，个人感觉这个功能还是挺需要的。我修改的位置在post.php，而且是显示附件的页面，不是附件本身，这样可以利用/attachment/{cid}/这个页面，网上关于显示这个列表的教程好像还挺少，我是没有找到，所以就自己写了。

<div class="post-content">
<?php $this->content(); ?>  //我是加在显示文章之后了
<?php $attachments = $this->attachments()->stack; ?>
<?php if (!empty($attachments)): ?>
<h4>附件列表：</h4>
<?php foreach($attachments as $attachment): ?>
<span style="padding-right:2em;">
<a href="<?php echo $attachment['pathinfo']; ?>" title="<?php _e('浏览 %s', $attachment['title']); ?>" target="_blank"><?php echo $attachment['title']; ?></a>
</span>
<?php endforeach; ?>
<?php endif; ?>
</div>

希望可以加入夜间模式

晚上看全白的背景有些刺眼，希望可以加入暗色背景或者夜间模式

字体可能有点小

是否可以把字体调大一点😂

设置了站点logo就看不到网站标题

站点 LOGO 地址设置了就看不到站点标题。

【bug】密码文章在文章列表页输入密码无效

最新2.5.5版本，密码文章在文章列表页输入密码无效
出现红字提示：提交失败，请检查网络并重试或者联系管理员。

需要手动输该文章对应的URL进入该文章内页才能正常打开（直接点击该标题也无法进入对应URL）

设置里开了全站pjax，ajax

一点小问题

在我这里开起了全站Pjax之后，用Typecho自带的文章加密加密文章之后，输入密码时会提示，提交失败如下图：
不知道是不是BUG还是我的问题👻

2.5.4版本背景音乐播放音量设置0-1之间的浮点数失败，且可以设置大于1的整数

# 需求类

hello

我很喜欢这个模板，但是这几个功能让我很犹豫，我对改代码并不擅长，我只能在这提出需求！

事实上在点击文章后，进行阅读文章的时候，右侧的"最新文章"和"回复"等看起来并不友好，尽管这些功能能够掌握最新的博客信息
我在想是否可以添加一个功能：
当我打开一个文章阅读，默认几乎全部平摊(不显示右侧的“最新文章”等)，在文章最上面，有一个按钮"显示边栏"，点击就显示这些！

另外，我个人觉得可不可以加一个公告模块，推荐阅读模块，因为我觉得这些很实用

thanks

侧边栏的一点小修改

登录后

未登录

另外，在手机版页面上可以把侧边栏放到文章下面显示，直接隐藏会有功能缺失。

Provisional headers are shown

如图，开启了Ajax翻页和代码高亮，请求资源就出错了，这是怎么回事？

演示网站怎么打不开了

想问一下links的内容怎么写 想看一下主题的相关使用说明

不支持Typecho最新版 1.2.0

主页缩略文章显示不正常

此主题：

默认模板：