MWordStar 双栏 Typecho 博客主题
MWordStar 是一套简洁的 Typecho 双栏博客主题,也是 我的博客 之前使用的主题。主题免费开源,可以在 Github 上免费下载。
主题下载地址:https://github.com/changbin1997/MWordStar/releases
如果你无法打开上面的下载地址,也可以访问 https://pan.baidu.com/s/1uFlFkcEeZsSgNy4OKPm6vw 使用百度网盘下载,密码 bcjh ,进入博客主图下载文件夹后选择 MWordStar 的最高版本下载。
主题演示地址:https://changbin1997.github.io/MWordStar/web/
主题演示站只是静态页面,不能发评论和点赞。
主题使用说明:https://mwordstar.misterma.com/
一些截图
下面是主题首页截图:

主题元素包含圆角和直角两种风格,您可以根据喜好在主题外观设置中切换,下面是直角风格的首页截图:

小头图模式:

也可以给文章设置单独的头图样式:

深色模式:

MWordStar 目前包含 18 种配色组合:



特点和功能
- 响应式设计
- 无障碍适配(Accessibility)
- 支持多语言(i18n)
- 18 套不同风格的配色(支持深色模式)
- 两种不同风格的元素
- 多套自定义页面模板,包含时间线的文章归档、分类、标签云、友链、图表统计、Github 项目展示
- 代码高亮
- 支持短代码(Shortcode)
- 支持 MathJax 数学公式渲染
- 丰富的自定义选项
- 详细的图表统计
- 内置文章浏览量统计和点赞功能
- 内置文章置顶功能
- 丰富的侧边栏组件
- 内置 Emoji 表情面板
- 支持显示 QQ 头像和自定义 Gravatar 源
- 评论支持图片验证码和 Cloudflare Turnstile
- 支持自动根据文章中的标题生成章节目录
- 文章支持单独加密某一部分内容,评论后可查看
- 评论支持私密评论,只有评论者和管理员可见
- 支持图片懒加载
- 文章支持分页显示
- 文章列表支持多种排版组合
- 支持添加友情链接
- 支持 PJAX 无刷新跳转
- 支持 Service Worker 缓存
- SEO 友好
- 支持添加自定义 CSS、head 区域 HTML、footer 底部 HTML,可以方便的修改主题样式和添加分析 JS
- 长期维护
- 详细的 使用说明(必看)
外观设计
因为我个人比较喜欢两栏布局,所以这个主题也使用了两栏布局的设计。
主题支持 18 种配色组合,支持深色模式。
区块和元素支持圆角和直角。
主题依赖
主题主要用到了一下几个库和框架:
- Bootstrap 外观和布局
- jQuery Bootstrap 依赖
- jquery-qrcode 一个生成二维码的 jQuery 插件
- highlight.js 代码高亮
- IcoMoon 字体图标
- ECharts 生成和展示统计图表
- jquery-pjax 用于页面无刷新跳转
其中 IcoMoon 的字体图标是可定制的,所以只包含了主题中出现的图标,字体图标的文件体积也很小。ECharts 也只包含饼图和日历图,而且只会在统计页面加载。
主题的静态文件没有使用任何 CDN 地址,所有文件都放在主题的 assets 目录中。主题的生成目录、点赞、快速分享 之类的功能都是自己手动编写的,所以用到的 JS 库也比较少。
使用 Webpack 打包的版本前台只需要加载一个 CSS 和 一个 JS 文件,所有 JS 库都打包到了 JS 中,所有 CSS 和字体图标都打包到了 CSS 中。因为用到的库比较少,而且字体图标和部分组件都是按需引入的,所以打包后的 CSS 和 JS 也比较小。
代码高亮的 JS 模块也是按需加载,只有文章内有代码块才会加载。
MathJax 使用在线 CDN 加载,国内可以正常加载,只有检测到文章内有 MathJax 语言标记才会加载 MathJax 库。
主题支持 Service Worker 缓存,只有第一次会加载完整的 CSS 和 JS,下次访问直接使用缓存的 CSS 和 JS。
如果您没有二次开发需求的话,建议下载 Webpack 打包的版本,也就是后缀包含 bundle 的 zip 文件。前台的 JavaScript 使用了 ES6 语法,IE 系列浏览器和一些较老的浏览器可能无法正常运行,Webpack 打包的版本使用 Babel 转换过代码,可以在 IE 和较老的浏览器上运行。
只有发行版支持 Service Worker 缓存。
主题安装
把主题上传到 Typecho 的 usr/themes/ 目录,然后解压,你也可以先解压在上传。
解压后需要保证 themes 目录下 有一个 MWordStar 目录。
登录 Typecho 的后台管理,进入 控制台 -> 外观,如果看到 MWordStar 就点击 启用。
代码高亮
代码高亮目前包含三套主题配色,分别是 Stack Overflow(浅色)、VS2015(深色)、Sunburst(高对比度)。主题支持 30 多种语言的代码高亮,详细的语言支持列表和说明可以查看 使用说明 。
文章头图和排版
文章头图可以在 首页、文章页、侧边栏 显示,您可以根据需求在主题外观设置中设置。
首页文章列表支持大图和小图模式,你可以全局设置大图或小图模式,也可以为不同的文章设置不同的模式。
首页也支持直接显示全文和手动分隔摘要。
侧边栏
下面是目前可以显示在侧边栏的组件:
- 博客信息
- 搜索
- 最新文章
- 最新评论
- 文章分类
- 标签云
- 日历归档
- 按月份的文章归档
- 登录入口和 RSS
- 友情链接
- 文章章节目录
- 自定义HTML
侧边栏的每个组件您都可以选择开启或关闭,您还可以自定义侧边栏的组件排序顺序。
无障碍(Accessibility)
上网对于大多数人来说是一件再简单不过的事,但是对于一些身体有缺陷的残障人士来说却是一件非常困难的事。
主题针对屏幕阅读器做了大量优化,并 在 NVDA 、VoiceOver 、TalkBack 这些屏幕阅读器上做过测试,无论是 PC 还是移动设备都能完美朗读。主题能准确传达需要朗读的内容和信息,对于视障人群来说,使用标准的屏幕阅读器基本可以无障碍操作。
主题可完美支持键盘访问,很多地方专门做了键盘适配,颜色对比度也符合标准。
主题后台设置也适配了屏幕阅读器。
评论区
评论区支持私密评论,只有评论者和网站管理员可见。
主题内置了用于评论验证的图片验证码和 Cloudflare Turnstile 支持,图片验证码开启就可以使用,Cloudflare Turnstile 注册账号可免费使用。
主题也内置了一个 Emoji 表情面板,包含很多类型的表情。
下面是 Emoji 表情面板的截图:

统计页
主题包含一个统计页模板,您可以在后台创建页面,页面的自定义模板选择 网站数据,标题可以随便写,创建完成后就可以在顶部导航栏访问了。
统计页包含基本的数据统计、分类文章占比图、文章更新日历图、评论动态日历图、阅读量排名前 5 的文章、评论量排名前 5 的文章。
基本数据统计如下:

分类占比统计图如下:

下面是评论动态日历图:

文章动态日历图和评论动态的日历图是差不多的,屏幕尺寸不同显示的月份数量也不同。
下面是文章评论排名表格:

文章阅读量排名表格和评论量排名的表格也是差不多的。
统计页面效果可以参考 https://www.misterma.com/data.html ,也可以直接访问 MWordStar 的静态演示站。
兼容性
主题使用了少量的 CSS3,浏览器需要达到 IE10 才能完美兼容,IE8 和 9 也能使用,但是有些页面的显示 例如代码高亮和时间线显示可能会出现稍微偏移的情况。
MathJax 不一定能在 IE 系列浏览器渲染数学公式。
Github 直接 clone 的开发版 JS 无法在 IE 运行,需要下载发行版。
其它
主题 Github:https://github.com/changbin1997/MWordStar
主题使用 MIT License 开源。
如果您在使用这个主题时遇到 Bug 或有任何问题和建议都可以在 博客评论区 留言,也可以在 Github 的 issues 反馈。
版权声明:本文为原创文章,版权归 Changbin's Blog 所有,允许非商业转载,转载请用链接注明出处。
本文地址:https://www.misterma.com/archives/812/
如果对本文有什么问题或疑问都可以在评论区留言,我看到后会尽量解答。
再请教和反馈一下:1、导航栏自定义导航,只是在原有导航后面加的吗,它不是重写导航对吗,前面自带模板那些独立页可以设置顺序,这个自定义后加的只能放到最后吗?似乎是这样的。 2、导航中选中比如”文章归档“,则在文章归档这个页面它这四个字应该是加黑加粗,表示选中的。可是当导航栏勾选显示文章分类后,那么凡是文章分类后面的,这个加粗显示都会后移一格,错位了,被后插入的文章分类这个挤到后面了。 不知道我有没有讲明白,就是说 比如ABCDE,这样5个导航内容,结果文章分类突然显示出来挤到了第2个位置,那顺序就变成了 A文章分类BCDE,然后你选中文章分类,结果加粗的是B,你选中B结果加粗的是C以此类推。虽然页面可以正常打开,但是加粗的与之不对应了。
导航栏的自定义链接是加到页面链接后面的,自定义链接不会影响页面链接。
我测试了一下,开启显示文章分类后,导航栏的链接选中状态没有出现错位的情况,我点击页面链接,对应的链接也会高亮显示,只有下拉菜单的分类链接不会高亮显示。
嗯嗯 😀 抱歉我刚这个是用typerenew测的。我刚用typecho测了一遍,开启显示文章分类后没有出现错位的问题。
咱这个自定义导航要是能够重写导航就好了,有的主题比如riven它就是重写的,不管原来导航那些顺序如何,有或者没有显示与否,只要自定义了,完全重写,这样自由度很高,想怎么调顺序都行。
再反馈一个:网站数据页面,最多阅读的文章、最多评论的文章,这两处表格里,点击文章也是链接,按说可以跳转,但是出现了%,比如:域名/%7Byear%7D%7Bmonth%7D%7Bday%7D-start, 这里我是用的自定义永久链接的,所以出错了。这个页面没有适配好,别的页面自定义永久链接测试都正常。应该凡是跳转到文章这里的,都该支持自定义永久链接,跳转处太多了,难免有遗漏。
面包屑这里, 首页//标签云、首页//网站数据 、首页//分类目录 这三处都多一个”/“。 正常的比如 首页/文章归档、首页
/项目展示、首页/友情链接 、首页/默认分类/欢迎使用TypeRenew 这些都是只有一个”/“。那三个模板里面有问题,之前版本就有这个问题。
感谢反馈,会尽快修复。
感谢作者再次更新MWordStar主题,之前反映过明暗配色模式下,logo会看不清的问题,您似乎没有修改把,我个人认为这个还是有必须的,毕竟网站logo是一个很重要的标识,应该在两种配色下均能正常显示才好,仅供参考
我现在用的 Facile 主题只有两种配色模式,也支持设置两个 Logo 图片。MWordStar 导航栏支持 7 种配色模式,我还需要考虑一下配色搭配问题。
好的谢谢 Facile 也更新了啊 我有空试试。 MWordStar 配色太多就算了,确实会麻烦些。不过我个人认为配色虽然多,默认的配色2是最好看的。 明暗两种模式下,就在配色2处调试好就行,您可以不必修改,可以告诉我改哪里的文件吗,我单独改一下这里也可以。
主题导航栏在
components/header.php,这只是导航栏的文件。需要改的地方还挺多的,你还需要考虑用户切换深色和浅色时的 Logo 更改,你可以使用 AI 和 Agent 工具来更改。反馈一个bug:评论表单位置: 评论表单在评论列表上方 评论表单在评论列表下方,这个选了不生效,始终在上方,我是直接改了代码强制他到下方去的
是我自己弄错了,这个选项是有效的
右侧博客信息这里,显示:评论数 %d 这里是不是代码有错误啊
语言文件里有一个错误,之前已经修复了,但是还没有打包新版本。你可以直接在 Github 仓库下载最新的源码使用,也可以用最新的语言文件替换之前的语言文件,语言文件在主题目录里的
languages目录。我这里打不开github,能不能把更新的文件发我一份邮箱,谢谢! [email protected]
已发送附件
感谢,已经升级,一切正常
关于导航问题,我设置的独立页面,会自动的添加到导航吗,这个从哪里设置?
在 Typecho 程序后台创建的独立页面会自动显示在导航栏的
博客统计内容,有支持自定义的计划吗
可能会考虑简单的自定义,比如开启或关闭某一部分的图表展示,因为我需要确保图表在 PC 和手机能正常显示,还要支持多语言。
博主您好,升级Typecho1.3后,编辑文章右上角的上传附件功能不能用了,请问下这个有什么解决的办法么?
这种情况我还没有遇到过,你说的不能用是上传文件会报错还是无法上传?
你可以排查一下下面两项:
usr/uploads目录。是无法上传,点击【选择文件上传】按钮没反应。我禁用了三方编辑器插件,用自带编辑器就能上传。也不确定是不是三方编辑器的问题。
看你的描述,那就是插件的问题了。
可能是最新的 typecho 更改了上传文件相关的 API,你使用的插件还没有适配最新版本,你只能等待插件作者适配了。
1.3 的 typecho 确实改变会大一些,我的 typecho 主题的统计页面都需要重新适配。
主题支持Typecho1.3吗?
支持的,前段时间刚适配了 1.3.0
你好,网站配置好ssl后,页面排版错位,但使用https查看js和css文件都能正常打开,不知道是什么问题?
你在 Typecho 后台的基本设置里看一下
站点地址里的地址是否包含 https,这里的地址也需要包含 https,比如https://你的域名。