Skip to content

feat(mdx-storage): Phase3 Task3.1 pages.yaml 기반 내부 링크 해석 구현#779

Merged
jk-kim0 merged 1 commit intomainfrom
jk/task-3-1-link-resolver
Feb 16, 2026
Merged

feat(mdx-storage): Phase3 Task3.1 pages.yaml 기반 내부 링크 해석 구현#779
jk-kim0 merged 1 commit intomainfrom
jk/task-3-1-link-resolver

Conversation

@jk-kim0
Copy link
Copy Markdown
Contributor

@jk-kim0 jk-kim0 commented Feb 16, 2026

Summary

  • LinkResolver 클래스를 구현하여 pages.yaml 기반 내부 링크를 Confluence storage link 매크로로 변환합니다
  • 상대 경로(../, ./)와 앵커(#section) 해석을 지원합니다
  • 미해석 링크는 기존 <a href> 형태를 유지합니다

Changes

  • mdx_to_storage/link_resolver.py 추가: pages.yaml 로딩, 경로 정규화, title fallback 해석
  • inline.pylink_resolver 파라미터를 추가하여 내부 링크를 <ac:link><ri:page> 매크로로 변환합니다
  • emitter.py에서 paragraph, list, table, html_block, blockquote, figure caption 경로에 link_resolver를 전파합니다
  • __init__.py에서 LinkResolver 클래스를 export합니다

Test plan

  • pytest -q confluence-mdx/tests/test_mdx_to_storage/ — 90/90 pass
  • 상대 경로 및 .. 정규화 검증
  • 앵커 분리 및 ac:anchor 속성 생성 검증
  • . 경로의 title 기반 fallback 해석 검증
  • 외부 링크(https://, mailto:) 및 hash-only 링크 비해석 검증
  • emitter 통합 검증 (monkeypatch stub)

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

@vercel
Copy link
Copy Markdown

vercel Bot commented Feb 16, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
querypie-docs Ready Ready Preview, Comment Feb 16, 2026 5:29pm

Request Review

## Summary
- `LinkResolver` 클래스를 구현하여 `pages.yaml` 기반 내부 링크를 Confluence
  storage link 매크로로 변환합니다
- 상대 경로(`../`, `./`)와 앵커(`#section`) 해석을 지원합니다
- 미해석 링크는 기존 `<a href>` 형태를 유지합니다

## Changes
- `mdx_to_storage/link_resolver.py` 추가: pages.yaml 로딩, 경로 정규화,
  title fallback 해석
- `inline.py`에 `link_resolver` 파라미터를 추가하여 내부 링크를
  `<ac:link><ri:page>` 매크로로 변환합니다
- `emitter.py`에서 paragraph, list, table, html_block, blockquote, figure
  caption 경로에 link_resolver를 전파합니다

## Test plan
- [x] `pytest -q confluence-mdx/tests/test_mdx_to_storage/` — 90/90 pass
- [x] 상대 경로 및 `..` 정규화 검증
- [x] 앵커 분리 및 `ac:anchor` 속성 생성 검증
- [x] `.` 경로의 title 기반 fallback 해석 검증
- [x] 외부 링크(`https://`, `mailto:`) 및 hash-only 링크 비해석 검증
- [x] emitter 통합 검증 (monkeypatch stub)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@jk-kim0 jk-kim0 force-pushed the jk/task-3-1-link-resolver branch from 82fd803 to a0116ac Compare February 16, 2026 17:25
@jk-kim0 jk-kim0 changed the title 3단계 Task 3.1: pages.yaml 기반 내부 링크 해석 구현 feat(mdx-storage): Phase3 Task3.1 pages.yaml 기반 내부 링크 해석 구현 Feb 16, 2026
@jk-kim0 jk-kim0 self-assigned this Feb 16, 2026
@jk-kim0 jk-kim0 merged commit dd41d99 into main Feb 16, 2026
7 checks passed
@jk-kim0 jk-kim0 deleted the jk/task-3-1-link-resolver branch February 16, 2026 17:41
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.

1 participant