如何生成文档方式网页(带文档左侧导航栏)

[longdafeng]

Issue Checklist

• I am using NexT version 8.0 or later.
• I have already read the Troubleshooting page of Hexo and Troubleshooting page of NexT.
• I have already searched for current issues, which does not help me.

Expected behavior

我想把文档全部迁移过来, 把gitbook 迁移到hexo + next 的系统.

现在面临一个问题, 对于文档, 我想在左边的导航栏里, 生成文档的目录树, 类似 https://oceanbase.github.io/, 或者
https://zalando-incubator.github.io/hexo-theme-doc/usage-and-configuration/swagger/introduction.html

我不想用2个系统分别来生成blog 和document, 有没有办法一个系统来生成.

因为next 很好集成了 大量的插件, 尤其是搜索插件和评论插件, 这个对我们来说很方便.

Actual behavior

• Links to demo site with this issue:
• Links to repository or source code of the blog:
• Screenshots:

Steps to reproduce the behavior

请问如何可以实现 https://zalando-incubator.github.io/hexo-theme-doc/usage-and-configuration/swagger/introduction.html

Other Information

No response

[welcome]

Thanks for opening this issue, maintainers will get back to you as soon as possible!

[longdafeng]

@stevenjoezhang could you please take a look at this issue?

In my oponion, we can provide one layout -- document, if user use this layout in front matter, maybe this is a solution.

[longdafeng]

@renovate-bot I look forward to your feedback.

[pplmx]

@longdafeng Like this?

[stevenjoezhang]

谢谢反馈，不好意思之前在休假没有回复，目前我们为文档站设计的导航栏是在页面顶部（参考 https://theme-next.js.org/docs/tag-plugins/label 右侧顶部栏），这个设计在易用性上相比其它成熟的方案可能有所欠缺。我会研究一下能不能在导航栏里添加目录树（代码逻辑上应该不难，不过调整样式和美观性上还需要一些时间）

[baoang]

关于位置问题,我倒想到有个插件,叫popular-related-post的,在新版中更换为related-post了,结果在next theme中,比如用mist风格,发现相关文章本来是在文章下方的,现在变成到左侧栏中显示了,而且似乎显示的数量少了,有的文章甚至一篇相关文章也没有.
如果有人能够接手原先的popular related post就好了,感觉上去呐,相关文章的位置在当前文章的下方更舒适.

[stevenjoezhang]

https://www.npmjs.com/package/hexo-related-popular-posts 这个插件更新比较少，上次更新是4年前了，所以换成了 https://www.npmjs.com/package/hexo-related-posts
一篇相关文章也没有的话可能就要调参数了，hexo-related-posts用的算法有一些权重可以设置
位置放到底部感觉怎么调样式都有点怪，所以挪到侧栏了，在Pisces/Gemini下是单独的一个块，比较清爽

[baoang]

https://www.npmjs.com/package/hexo-related-popular-posts 这个插件更新比较少，上次更新是4年前了，所以换成了 https://www.npmjs.com/package/hexo-related-posts 一篇相关文章也没有的话可能就要调参数了，hexo-related-posts用的算法有一些权重可以设置 位置放到底部感觉怎么调样式都有点怪，所以挪到侧栏了，在Pisces/Gemini下是单独的一个块，比较清爽

多谢答复。我尝试一下Pisces样式看看。