diff --git a/README.md b/README.md index f3e0e9b..6a041d1 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,51 @@ -# 星火应用商店首页列表内容 +# 星火应用商店首页列表 -自荐应用请参考已有的json提交pr,在审核合入后会在第二天同步时推送到首页上 \ No newline at end of file +自荐应用请参考已有的json提交pr,在审核合入后会在第二天同步时推送到首页上 + +## 使用指南 +* 所有的配置均为json格式 +* `homelinks.json`记录了首页链接 +* `homelist.json`记录了应用专题的信息 +* `links`文件夹中有`homelinks.json`指定的链接的图片素材 +* `lists`文件夹中有`homelist.json`中指定的应用列表 +* `lists`文件夹中的list文件格式:每个应用需要四个信息,分别是`名字,包名,分类,简介`,相关信息可以前往[这里](https://d.store.deepinos.org.cn/)获取。分类信息请与链接中的`app.json`相同。 +> 例子:星火应用商店的应用信息位置如下: https://d.store.deepinos.org.cn//store/tools/spark-store/app.json +```json +{ + "Name": "星火应用商店", + "Version": "4.1.1", + "Filename": "spark-store_4.1.1_amd64.deb", + "Torrent_address": "spark-store_4.1.1_amd64.deb.torrent", + "Pkgname": "spark-store", + "Author": "shenmo <shenmo@spark-app.store>", + "Contributor": "shenmo <jifengshenmo@outlook.com>", + "Website": "https://www.spark-app.store/", + "Update": "2022-12-22 00:25:21", + "Size": "573.17 KB", + "More": "全新4.1版本和大家见面了\n彻底修复了UOS签名包的问题\n修复了更新失效", + "Tags": "community;ubuntu;deepin;uos;dtk5", + "img_urls": "[\"https://examine-spark.oss-cn-shanghai.aliyuncs.com/images/2022/12/22/fe391a1b-39b9-4db7-995e-d2ffdd2bd75e.png\",\"https://examine-spark.oss-cn-shanghai.aliyuncs.com/images/2022/12/22/70281416-94ba-4db5-862e-00414941dada.png\",\"https://examine-spark.oss-cn-shanghai.aliyuncs.com/images/2022/12/22/44f0d189-bb7c-4183-90bc-669aa802d55d.png\",\"https://examine-spark.oss-cn-shanghai.aliyuncs.com/images/2022/12/22/6f346232-84af-479c-83a5-ee20f49c5ca7.png\"]", + "icons": "https://examine-spark.oss-cn-shanghai.aliyuncs.com/icons/2022/12/22/3522c4f2-16d8-4580-9f32-623cb694171d.png" +} +``` +从链接`https://d.store.deepinos.org.cn//store/tools/spark-store/app.json `可以看出,这款应用的分类为`tools` + +如果要加入到list中,应当写入以下信息 +```json +{ + "Name": "星火应用商店", + "Pkgname": "spark-store", + "Category": "tools", + "More": "全新4.1版本和大家见面了\n彻底修复了UOS签名包的问题\n修复了更新失效" +} +``` + + +## 投稿要求(暂定) + +* json不可有格式错误 +* 对于首页链接部分,配置文件为` homelinks.json`需要提供对应的图片素材(应当放在links文件夹中,对应的模板psd文件已经给出)。因首页链接的特殊性,如果需要增加此部分,请前往 [这里](https://www.deepinos.org/d/1207)和我们取得联系或者在提交Pr时留下你的目的和联系方式,否则不予通过 +> 对于需要在商店web窗口本窗口打开的,`"type":"_self"`;如果需要在默认浏览器中打开,则`"type":"_blank"`。商店web窗口的处理逻辑是:在本窗口打开的链接,在web窗口打开;在新标签页打开的链接,使用默认浏览器打开链接。特别的,如果一个链接以`app.json`结尾,商店会将此链接转交给appinfo模块处理,也就是解析为应用 +* 对于应用专题推荐部分,目前只要求`社区精品`应用需要是在星火社区或其他同类的社区发布应用并进行社区协作开发的软件。 如:[wine运行器](https://bbs.deepin.org/post/247173) +* 新增专题相关内容请前往 [这里](https://www.deepinos.org/d/1207)和我们取得联系或者在提交Pr时留下你的目的和联系方式,否则不予通过 +欢迎补充~ \ No newline at end of file