next-theme / next-theme/hexo-theme-next

Add support for displaying articles based on directory structure for documentation

Open
#762 9 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Feature Request To Do
Dominant language
JavaScript
Stars
2.8k
Forks
493
Avg merge
12h 45m
Merged PRs (30d)
1

Description

Issue Checklist
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 很好集成了 大量的插件, 尤其是搜索插件和评论插件, 这个对我们来说很方便.

image

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

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the linked OceanBase and Zalando documentation examples and the theme's existing navigation and article-generation entry points. The issue names no files or tests; done would require a decided, documented approach for generating a directory-tree sidebar while keeping blog and documentation content in one Hexo site.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
documentation
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.