Skip to content

Latest commit

 

History

History
112 lines (95 loc) · 3.63 KB

README_zh_CN.md

File metadata and controls

112 lines (95 loc) · 3.63 KB
Raw

English

思源笔记主题示例

开始

  • 通过 Use this template 按钮将该库文件复制到你自己的库中，请注意库名必须和主题名称一致，默认分支必须为 main
  • 将你的库克隆到本地开发文件夹中，为了方便可以直接将开发文件夹放置在 {workspace}/conf/appearance/themes/ 下

开发

  • theme.json
  • icon.png (160*160)
  • preview.png (1024*768)
  • README*.md
  • theme.css
  • theme.js

theme.json

{
  "name": "theme-sample",
  "author": "Vanessa",
  "url": "https://github.com/siyuan-note/theme-sample",
  "version": "0.0.3",
  "minAppVersion": "2.8.8",
  "displayName": {
    "default": "Theme Sample",
    "zh_CN": "主题示例"
  },
  "description": {
    "default": "This is a theme sample",
    "zh_CN": "这是一个主题示例"
  },
  "readme": {
    "default": "README.md",
    "zh_CN": "README_zh_CN.md"
  },
  "funding": {
    "openCollective": "",
    "patreon": "",
    "github": "",
    "custom": [
      "https://ld246.com/sponsor"
    ]
  },
  "modes": [
    "light"
  ],
  "keywords": [
    "sample", "示例"
  ]
}
  • name：主题名称，必须和库名一致，且全局唯一（集市中不能有重名主题）
  • author：主题作者名
  • url：主题仓库地址
  • version：主题版本号，建议遵循 semver 规范
  • minAppVersion：主题支持的最低版本号，建议遵循 semver 规范
  • minAppVersion：主题支持的最低思源笔记版本号
  • displayName：模板显示名称，主要用于模板集市列表中显示，支持多语言
    • default：默认语言，必须存在
    • zh_CN、en_US 等其他语言：可选，建议至少提供中文和英文
  • description：主题描述，主要用于主题集市列表中显示，支持多语言
    • default：默认语言，必须存在
    • zh_CN、en_US 等其他语言：可选，建议至少提供中文和英文
  • readme：自述文件名，主要用于主题集市详情页中显示，支持多语言
    • default：默认语言，必须存在
    • zh_CN、en_US 等其他语言：可选，建议至少提供中文和英文
  • funding：主题赞助信息
    • openCollective：Open Collective 名称
    • patreon：Patreon 名称
    • github：GitHub 登录名
    • custom：自定义赞助链接列表
  • modes：主题支持的模式列表，可选值为 light 和 dark
  • keywords：搜索关键字列表，用于集市搜索功能

打包

无论使用何种方式编译打包，我们最终需要生成一个 package.zip，它至少包含如下文件：

  • icon.png
  • preview.png
  • README*.md
  • theme.css
  • theme.json

上架集市

如果是第一次发布版本，还需要创建一个 PR 到 Community Bazaar 社区集市仓库，修改该库的 themes.json。该文件是所有社区主题库的索引，格式为：

{
  "repos": [
    "username/reponame"
  ]
}

PR 被合并以后集市会通过 GitHub Actions 自动更新索引并部署。后续发布新版本主题时只需要按照上述步骤创建新的发布即可，不需要再 PR 社区集市仓库。

正常情况下，社区集市仓库每隔 1 小时会自动更新索引并部署，可在 https://github.com/siyuan-note/bazaar/actions 查看部署状态。