Typecho 插件开发模版

Typecho

Typecho 的插件系统非常灵活,现在也有很多开发者开发了很棒的插件。但是在实际开发中有很多代码以及发布流程不够规范,这影响了 Typecho 生态的进一步扩展。因此我这次借着为 Typecho 开发站点地图插件的契机,为其开发了一个 Github 模版,以供开发者使用。

如何使用

项目地址位于:https://github.com/typecho/plugin-template

截屏2023-12-18 18.11.50.png

在项目页面右上方找到 "Use this template" 的绿色按钮,然后点击 "Create a new repository" 即可使用这个模版创建一个 Typecho 插件项目。

这个项目的 README 包含了详细的中英文使用文档,我就不再赘述细节。这里只讨论一下使用这个模版之后的插件开发步骤。

开发步骤

一般来说作为 Typecho 插件的开发者,在本地都会运行一个 Typecho 的服务器,很多人在开发插件的时候都会直接在服务器目录下的 ./usr/plugins 目录里,新建一个插件目录直接来开发。

而如果你使用此模版来进行插件开发,需要首先将创建好的插件项目 clone 到本地。然后使用软链接,将插件项目里的 plugin 目录链接到 Typecho 目录下的 ./usr/plugins/{PluginName} 目录,这里的 PluginName 就是你的插件名。至于插件的命名规范在模版项目里有详细的描述,请认真阅读。

而插件的发布步骤也已经被 Github Actions 完全自动化,如果当前项目主线代码已经具备发布新版本的条件。在项目主页的右侧 Releases 处找到 Create a new release 来创建一个新的 Release 版本:

  1. 标题按自己的喜好随便填,一般是版本号。
  2. Choose a tag 标签那一项,输入一个新的版本号比如 1.0.0 或者 v1.0.0,然后点击 Create new tag 创建新标签。
  3. 填写发布日志,然后点击 Publish release 按钮发布。

发布之后等待片刻,Github Actions 会自动将 plugin 目录下的文件打包成一个名为 {PluginName}-1.0.0.zip 的文件上传到当前 Release 版本下的 assets 中以供用户下载。

Sitemap 插件

我已经用它为 Typecho 开发了一个 Sitemap 插件:https://github.com/joyqi/typecho-plugin-sitemap

这个插件的功能就是为 Typecho 站点的不同板块生成 sitemap.xml 文件,我还打算近期把之前开发的插件迁移到新的开发模版中来。

已有 6 条评论
  1. 要是有插件库就更好了,很多优秀的插件没有被发现

  2. 你好哇,我之前参考 typecho 重构了一个项目,终于工作,现在放弃了。现在一枚 Vue 前端程序员,开源最初的快乐是一种成就感,感谢也很佩服那些坚持的人。对了之前发现 typecho 中有一部分代码注释不规范问题,可以在最新版本修复哈哇,之前已经提 Issue 了。

  3. 关于我和友情链接的导航不放个返回首页的?

  4. 如何才能看懂typecho源码,能否写一些基础教程。

  5. 翻墙男-科学上网之家
    翻墙男-科学上网之家

    用大佬您的地图插件。必应总是会提示这个 。我也仔细看了看。确实在修改完页面后。生成 的地图时间不会变呀。。大佬是否,有兴趣。将插件升级一下。

    网站地图应每天至少更新一次,因为网站地图为搜索引擎提供了网站内容和结构的地图。这有助于搜索引擎更高效地发现网站页面并为其编制索引,从而提高网站在搜索结果中的可见性。
    验证网站地图是否每天至少刷新一次,并包括网站上发布(添加或更新)的所有相关 URL。 。