blocklet / blocklet-site

Blocklet platform and developer site and documentation
https://www.blocklet.io
Other
3 stars 0 forks source link

chore: add samples gallery page #57

Closed donotlb closed 2 years ago

donotlb commented 2 years ago

关联 Issue

主要改动

(该 PR 主要处理 sample gallery 和 sample 基础信息的显示, sample 文档的正文后续补充)

界面截图

image

image

检查清单

donotlb commented 2 years ago

目前存在一个问题:

sample gallery 属于 developer/pages, sample 详情页属于 developer/docs, 当从 gallery 点击某个 sample 条目进入到 sample 详情页时, docs sample 这部分的导航栏应该如何显示需要讨论下

image

mave99a commented 2 years ago

sidebar 的显示可以作为一个参数来决定要不要关掉?

mave99a commented 2 years ago

samples 的列表页可以考虑有一些category (比如按框架,按开发语言)来归类,否则多了之后觉得凌乱。

这个应该就是xmark 页面,在页面组织层面编辑好即可。

wangshijun commented 2 years ago

sidebar 的显示可以作为一个参数来决定要不要关掉?

@kirakiray 请你来支持下

donotlb commented 2 years ago

sidebar 的显示可以作为一个参数来决定要不要关掉?

想了下,这个 PR 里的导航问题,可能需要使用自定义的 layout,比如使用一个空白的 layout

还需要考虑另一个问题,自动渲染的面包屑也有点问题 - "Samples" 需要链接到 gallery 页面

linchen1987 commented 2 years ago

samples 列表页和详情页都放在 page site 中,doc site 中点击 sample 跳转到 page site 中?

donotlb commented 2 years ago

samples 列表页和详情页都放在 page site 中,doc site 中点击 sample 跳转到 page site 中?

可以,这样处理起来简单一些,那就 gallery 和 sample 详情页都放在 developer/pages 里

donotlb commented 2 years ago

samples 列表页和详情页都放在 page site 中

发现如果这样做的话,sample 详情页 与 docs 页面相比,会缺少一些 docs theme 自带的元素 (如下图红框),感觉这样页面会看起来比较单调,计划对 sample 列表页和 详情页做如下调整:

image

image

donotlb commented 2 years ago

做了些调整:

gallery 页面 filter 功能计划在后面增加


录屏:

https://user-images.githubusercontent.com/24994263/198873202-7ca50c9c-7aa1-4513-af63-2c38e38eeeb8.mov

wangshijun commented 2 years ago

merge 之前: