Skip to content

Conversation

@jk-kim0
Copy link
Contributor

@jk-kim0 jk-kim0 commented Sep 5, 2025

Description

  • Nextra framework 의 기본 동작에 따르면, Sidebar 에 노출되는 문서의 순서는 _meta.ts에 입력된 entry 의 순서를 따른다고 알려져 있습니다.
    • Cursor, ChatGPT 등의 답변은 입력된 entry 의 순서에 따른다고 합니다. 이에 대한 Nextra 의 레퍼런스를 출처가 불분명하고, 확인하기 어렵습니다.
    • 그러나, 실제로 그렇게 작동하지 않습니다.
  • Sidebar 의 문서 순서를 명시적으로 제어하기 위해, layout.tsx를 개선합니다.
    • sidebar 에 대한 sort 기능을 override 하여, order라는 속성을 참조하여 정렬합니다.
  • confluence_xhtml_to_markdown.py를 개선하여, _meta.ts를 생성할 때, order속성을 추가합니다.
  • 한국어 문서에 대한 _meta.ts를 모두 업데이트합니다.
    • 영어, 일본어 문서의 _meta.ts는 후속 PR 에서 처리합니다.

Additional notes

@jk-kim0 jk-kim0 self-assigned this Sep 5, 2025
Copy link

@keIIy-kim keIIy-kim left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

흠.. 문서대로 동작을 안 하는군요.

- Nextra framework 의 기본 동작에 따르면, Sidebar 에 노출되는 문서의 순서는 `_meta.ts`에 입력된 entry 의 순서를 따른다고 알려져 있습니다.
  - Cursor, ChatGPT 등의 답변은 입력된 entry 의 순서에 따른다고 합니다. 그러나, 실제로 그렇게 작동하지 않습니다.
- Sidebar 의 문서 순서를 명시적으로 제어하기 위해, `layout.tsx`를 개선합니다.
  - sidebar 에 대한 `sort` 기능을 override 하여, `order`라는 속성을 참조하여 정렬합니다.
- `confluence_xhtml_to_markdown.py`를 개선하여, `_meta.ts`를 생성할 때, `order`속성을 추가합니다.
- 한국어 문서에 대한 `_meta.ts`를 모두 업데이트합니다.
  - 영어, 일본어 문서의 `_meta.ts`는 후속 PR 에서 처리합니다.
@jk-kim0 jk-kim0 marked this pull request as draft September 29, 2025 10:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants