fix: .md 파일이 .html로 변환되는 과정에서 발생하는 상대경로 라우팅 오류 해결

[junh0328]

📝 Key Changes

shared.mts에서 <base href="/code-quality/"> 태그를 제거하여 상대 경로 링크가 올바르게 동작하도록 수정했습니다.

문제 상황:

• /code-quality/code/ 페이지에서 ./examples/submit-button 링크 클릭 시
• 예상 경로: /code-quality/code/examples/submit-button.html
• 실제 이동: /code-quality/examples/submit-button.html (404 에러)

원인 분석:
HTML <base> 태그는 페이지 내 모든 상대 경로의 기준점(base URL)을 변경합니다.

• <base href="/code-quality/">가 설정되어 있으면
• 모든 상대 경로(./, ../)가 현재 페이지가 아닌 /code-quality/를 기준으로 해석됩니다
• 따라서 /code-quality/code/ 에서 ./examples/submit-button는
  • 현재 위치 기준: /code-quality/code/ + examples/submit-button ✅
  • base 태그 기준: /code-quality/ + examples/submit-button ❌

해결 방법:
<base> 태그를 제거하여 상대 경로가 현재 페이지 위치를 기준으로 정상 해석되도록 했습니다.

🔄️ Before and After Comparison

Before	After
/code-quality/code/ 페이지에서 ./examples/submit-button 클릭 시 → /code-quality/examples/submit-button.html (404)	/code-quality/code/
페이지에서 ./examples/submit-button 클릭 시 → /code-quality/code/examples/submit-button.html (✅)

AS-IS

2025-11-06.9.51.46.mov

TO-BE

2025-11-06.9.50.45.mov

[vercel]

@junh0328 is attempting to deploy a commit to the Toss Team on Vercel.

A member of the Team first needs to authorize it.

[Copilot]

Pull Request Overview

This PR removes a redundant HTML <base> tag from the VitePress configuration. The base path /code-quality/ is already properly configured via VitePress's base configuration option, making the manual HTML tag unnecessary and potentially problematic.

• Removed duplicate <base> tag injection in the transformHead function

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[milooy]

LGTM

[vercel]

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

Project	Deployment	Preview	Comments	Updated (UTC)
frontend-fundamentals	Error			Nov 10, 2025 11:18am