{"id":13456385,"url":"https://github.com/changbin1997/Facile","last_synced_at":"2025-03-24T10:32:29.085Z","repository":{"id":39985257,"uuid":"348343030","full_name":"changbin1997/Facile","owner":"changbin1997","description":"一个简洁的 Typecho 博客主题","archived":false,"fork":false,"pushed_at":"2025-02-04T15:06:30.000Z","size":1928,"stargazers_count":177,"open_issues_count":14,"forks_count":24,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-04T16:21:19.351Z","etag":null,"topics":["accessibility","blog-theme","typecho","typecho-theme"],"latest_commit_sha":null,"homepage":"https://www.misterma.com","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/changbin1997.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-03-16T12:41:41.000Z","updated_at":"2025-02-04T15:06:33.000Z","dependencies_parsed_at":"2023-02-08T09:15:33.210Z","dependency_job_id":"87d16b02-3451-4c3d-a03d-1c94a0520d13","html_url":"https://github.com/changbin1997/Facile","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/changbin1997%2FFacile","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/changbin1997%2FFacile/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/changbin1997%2FFacile/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/changbin1997%2FFacile/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/changbin1997","download_url":"https://codeload.github.com/changbin1997/Facile/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245252464,"owners_count":20585070,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["accessibility","blog-theme","typecho","typecho-theme"],"created_at":"2024-07-31T08:01:21.021Z","updated_at":"2025-03-24T10:32:29.078Z","avatar_url":"https://github.com/changbin1997.png","language":"PHP","funding_links":[],"categories":["PHP"],"sub_categories":[],"readme":"![Facile主题各种设备的截图](screenshot/16197858108859.jpeg)\n\nFacile 是一套简洁的 Typecho 博客主题，也是我的博客正在使用的主题。\n\n之前我用的主题是 [MWordStar](https://www.misterma.com/archives/812/) ，时间长了就想换一下外观，本来想再给 MWordStar 增加一套样式，但是外观变动比较大，而且 MWordStar 已经有几套样式了，所以重新开发一套主题。\n\n主题演示地址：[https://www.misterma.com/](https://www.misterma.com/) \n\n主题下载地址：[https://github.com/changbin1997/Facile/releases](https://github.com/changbin1997/Facile/releases) \n\n下载时请选择 `Facile-bundle.zip` ，否则前端 JS 代码无法在 IE 系列浏览器运行。\n\n主题使用帮助：[https://facile.misterma.com/](https://facile.misterma.com/) \n\n目前主题没有相关的交流群，在使用过程中遇到问题可以直接到 [我的博客](https://www.misterma.com/archives/899/) 留言，也可以到主题 Github 的 [issues](https://github.com/changbin1997/Facile/issues) 反馈，我的博客和 Github issues 都有回复邮件通知。\n\n下面是主题首页截图：\n\n![Facile首页截图](screenshot/16200336116020.png)\n\n![Facile深色主题截图](screenshot/16401686275075.png)\n\n不包含文章头图的截图：\n\n![Facile不包含文章头图的截图](screenshot/16200336317620.png)\n\n小头图模式：\n\n![Facile小头图模式截图](screenshot/mini-header-image.png)\n\n也可以给文章设置单独的头图样式：\n\n![Facile大头图和小头图搭配使用的截图](screenshot/header-image.png)\n\nFacile 相比 [MWordStar](https://github.com/changbin1997/MWordStar) 来说，外观要更简洁一些，功能也会少一些，MWordStar 有的功能以后也会陆续增加到 Facile 中，但是 Facile 的功能以后也不会有 MWordStar 多。\n\n## 特点和功能\n\n* 响应式设计\n* 无障碍适配（Accessibility）\n* 包含浅色和深色两套配色（可根据系统主题配色自动调节）\n* 代码高亮\n* 自带点赞功能\n* 支持根据文章内插入的标题生成章节目录\n* 支持图片懒加载\n* 支持文章分页\n* 文章列表支持多种排版方式\n* 丰富的侧边栏组件\n* 丰富的设置选项\n* 详细的图表统计\n* 评论区自带 Emoji 表情面板\n* 支持 PJAX 无刷新跳转\n* 详细的 [帮助文档](https://facile.misterma.com/) （必看）\n* 长期维护\n\n## 安装\n\n在 Releases 下载的主题是一个 zip 格式的压缩包，把压缩包上传到 Typecho 目录下的 `usr/themes/` 目录，然后解压，解压后应该可以看到一个 `Facile` 目录。\n\n登录 Typecho 后台，在顶部导航栏的 `控制台` 菜单选择 `外观` ，如果存放位置没有错误的话就可以看到 Facile 主题了，点击 `启用` 。\n\n## 主题依赖\n\n主题主要用到了以下几个库：\n\n* [bootswatch](https://github.com/thomaspark/bootswatch) 不同风格的 Bootstrap 主题\n* [jQuery](https://jquery.com/) DOM 操作和 Bootstrap 依赖\n* [qrious](https://github.com/neocotic/qrious) 生成二维码的 JS 库\n* [highlight.js](https://highlightjs.org/) 代码高亮\n* [ECharts](https://github.com/apache/echarts) 百度开源的图表库，用于 [统计页](https://www.misterma.com/data.html) 生成统计图\n* [jquery-pjax](https://github.com/defunkt/jquery-pjax) 用于页面无刷新跳转\n\n后端没有用到任何库。\n\nECharts 的库比较大，所以只引入了饼图和日历图，而且只会在统计页加载。Bootstrap 的 JS 使用 Webpack 打包过的发行版也只引入了用到的模块。\n\n主题的图标使用的是 [IcoMoon](https://icomoon.io/) 的字体图标，IcoMoon 的图标可以自定义，所以主题中只包含几个用到的图标。\n\n前端 JS 使用的是 ES6 语法，在 IE 系列的浏览器（包括 IE11）是无法运行的，如果没有二次开发需求的话，可以在 [Releases](https://github.com/changbin1997/Facile/releases) 下载 `Facile-bundle.zip` 发行版，发行版使用了 Webpack + Babel 来打包和转换，可以在 IE 运行。\n\n## 代码高亮\n\n代码高亮目前包含三套主题配色，分别是 Stack Overflow（浅色）、VS2015（深色）、Sunburst（高对比度）。目前支持 30 多种语言的代码高亮。\n\n要查看支持的语言列表和代码高亮样式可以访问 [帮助文档 - 代码高亮](https://facile.misterma.com/%E4%BB%A3%E7%A0%81%E9%AB%98%E4%BA%AE.html)\n\n## 侧边栏\n\n下面是目前可以显示在侧边栏的组件：\n\n* 博客信息\n* 主题配色\n* 最新文章\n* 最新回复\n* 文章分类\n* 标签云\n* 文章归档\n* 其它功能\n* 友情链接\n* 文章的章节目录\n* 自定义\n\n侧边栏的每个组件你都可以选择开启或关闭，你还可以自定义侧边栏的组件排序顺序。\n\n## 统计页\n\n主题包含一个统计页模板，你可以在后台创建页面，页面的自定义模板选择 `网站数据`，标题可以随便写，创建完成后就可以在顶部导航栏访问了。\n\n统计页包含基本的数据统计、分类文章占比图、文章更新日历图、评论动态日历图、阅读量排名前 5 的文章、评论量排名前 5 的文章。\n\n基本数据统计如下：\n\n![Facile基本统计截图](screenshot/16198784315155.jpeg)\n\n分类占比统计图如下：\n\n![Facile分类占比截图](screenshot/16198785132678.jpeg)\n\n下面是评论动态日历图：\n\n![Facile评论动态图](screenshot/16198788751795.jpeg)\n\n文章动态日历图和评论动态的日历图是差不多的，屏幕尺寸不同显示的月份数量也不同。\n\n下面是文章评论排名表格：\n\n![Facile评论排名表格截图](screenshot/16198790286475.jpeg)\n\n文章阅读量排名表格和评论量排名的表格也是差不多的。\n\n统计页面演示可以访问 [https://www.misterma.com/data.html](https://www.misterma.com/data.html) 。\n\n## Emoji 表情\n\n主题评论区包含一个 Emoji 表情面板，你可以在后台启用或禁用。Emoji 表情面板包含 1466 个表情，这些表情都是按照分类动态加载的，不用担心性能问题。\n\nEmoji 表情面板也进行了无障碍适配，可支持键盘访问和屏幕阅读器朗读。\n\n下面是 Emoji 表情面板的截图：\n\n![Facile Emoji表情面板](screenshot/emoji-panel.jpg)\n\n## 无障碍（Accessibility）\n\n上网对于大多数人来说是一件再简单不过的事，但是对于一些身体有缺陷的残障人士来说却是一件非常困难的事。目前国内的很多网站和 App 都只注重外观，忽略了残障人士的 [可访问性](https://www.misterma.com/archives/264/)，甚至有的 App 在开启屏幕阅读器的情况下都无法正常使用。\n\nFacile 主题针对屏幕阅读器做了大量优化，并在 [MVDA](http://www.nvda-project.org/) 和 [VoiceOver](https://www.apple.com/cn/accessibility/iphone/vision/) 这两款屏幕阅读器上做过测试，无论是 PC 还是移动设备都能完美朗读（除了日历图），主题能准确传达需要朗读的内容和信息，对于盲人来说，使用标准的屏幕阅读器基本可以无障碍操作。\n\n主题可完美支持键盘访问，颜色对比度也符合标准。\n\n小提示：如果您是屏幕阅读器用户，为了您的浏览体验，不建议使用 IE 浏览器。\n\n## 友情链接\n\n友情链接分为 `全站友情链接`、`首页友情链接`、`内页友情链接`。`全站友情链接` 会在每个页面的侧边栏显示，`首页友情链接` 会在首页的侧边栏显示，`内页友情链接` 只会在 友情链接 的页面显示。\n\n要查看友情链接的设置说明可以访问 [帮助文档 - 主题设置](https://facile.misterma.com/%E4%B8%BB%E9%A2%98%E8%AE%BE%E7%BD%AE.html#%E8%BF%9B%E5%85%A5%E4%B8%BB%E9%A2%98%E8%AE%BE%E7%BD%AE)\n\n## 插件适配\n\n因为我需要用到 [Sticky](https://plugins.typecho.me/plugins/sticky.html) 文章置顶插件，所以这个主题也直接适配了 Sticky 插件，Sticky 插件安装完成后无需修改主题。\n\n## 兼容性\n\n主题用到了少量的 CSS3，常见的浏览器都能完美兼容，IE 系列浏览器需要达到 IE10 才能完美兼容。\n\nJavaScript 用到了 ES6，打包的发行版可以完美兼容 IE，开发版不支持 IE 系列浏览器和一些较老的浏览器。\n\n## 打赏支持\n\n如果主题用着感觉还可以的话，也可以扫描下方的二维码打赏，金额随意：\n\n![支付宝和微信的收款二维码](screenshot/qr-code.jpeg)\n\n非常感谢 ❤️\n\n下面是 [MWordStar](https://github.com/changbin1997/MWordStar) 和 [Facile](https://github.com/changbin1997/Facile) 两个主题的打赏记录：\n\n| 打赏者 | 金额（人民币） | 时间                |\n| ------ | -------------- | ------------------- |\n| *伟    | 1.00           | 2022 年 8 月 12 日  |\n| S*r    | 1.00           | 2022 年 11 月 17 日 |\n| *玥    | 10.00          | 2022 年 11 月 27 日 |\n| 0*7    | 1.00           | 2022 年 12 月 17 日 |\n| *U     | 20.00          | 2023 年 1 月 18 日  |\n| *义    | 16.80          | 2023 年 3 月 29 日  |\n| Y*a    | 10.00          | 2023 年 4 月 4 日   |\n| *行    | 8.88           | 2023 年 5 月 8 日   |\n| *华    | 8.88           | 2024 年 10 月 11 日 |\n| *王    | 6.66           | 2024 年 12 月 26 日 |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchangbin1997%2FFacile","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchangbin1997%2FFacile","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchangbin1997%2FFacile/lists"}