fix(docs): prevent stage-1 appendix link 404s

2026-05-20 11:23:42 +08:00
parent fea9ccd383
commit d962359412
24 changed files with 64 additions and 64 deletions
@@ -304,7 +304,7 @@ z.ai 외에도 아래의 훌륭한 AI 프로그래밍 플랫폼을 시도해 볼

 또한 LLM에게 프로젝트 수준의 프롬프트를 직접 생성해 달라고 요청할 수도 있습니다. 지난 절에서는 스네이크 게임의 프롬프트만 우리가 직접 작성했습니다. 이제 대형 모델에게 전체 프레임워크와 구현 경로가 포함된 프롬프트를 생성하게 해 봅시다. z.ai로 바로 생성할 수 있습니다.

-더 좋은 프롬프트를 작성하는 법을 배우고 싶다면 [프롬프트 엔지니어링 부록](/ko-kr/appendix/8-artificial-intelligence/prompt-engineering)을 확인하세요.
+더 좋은 프롬프트를 작성하는 법을 배우고 싶다면 [프롬프트 엔지니어링 부록](/zh-cn/appendix/8-artificial-intelligence/prompt-engineering)을 확인하세요.

 > AI가 웹 스네이크 게임을 생성하게 하고 싶습니다. 더 완성도 높은 프롬프트가 필요합니다. 생성 결과가 더 인상적이고 재미있어야 합니다. 이에 맞는 프롬프트를 생성해 주세요. 현재 목표는 다음과 같습니다. 서로 다른 단어를 먹으면 시를 생성하는 기능이 있는 스네이크 게임을 만들고, 이미지 생성 모듈도 포함해야 합니다.

@@ -643,7 +643,7 @@ AI 보조 프로그래밍 시대에는 프레임워크의 모든 세부 사항

 > "React로 순위표 페이지를 만들어줘. 오른쪽에는 점수 목록을 표시하고, 어떤 행을 클릭하면 아래에 플레이어 상세 정보를 보여 줘. 스타일은 간결하고 모던하게 해줘."

-HTML, CSS, JavaScript 같은 프론트엔드 기초 지식을 더 깊이 이해하고 싶다면 [Web 기초 부록](/ko-kr/appendix/3-browser-and-frontend/javascript-deep-dive)을 확인하세요. 프론트엔드 기술의 발전 역사를 알고 싶다면 [프론트엔드 진화사 부록](/ko-kr/appendix/3-browser-and-frontend/frontend-frameworks)을 확인하세요.
+HTML, CSS, JavaScript 같은 프론트엔드 기초 지식을 더 깊이 이해하고 싶다면 [Web 기초 부록](/zh-cn/appendix/3-browser-and-frontend/javascript-deep-dive)을 확인하세요. 프론트엔드 기술의 발전 역사를 알고 싶다면 [프론트엔드 진화사 부록](/zh-cn/appendix/3-browser-and-frontend/frontend-frameworks)을 확인하세요.

 ## <span id="appendix-2">[부록 2: Vibe Coding은 대체 무엇인가](#appendix-nav)</span>

@@ -346,7 +346,7 @@ AI는 구조화된 요구사항과 대응되는 프롬프트를 반환할 것입

 #### 2.2.1 준비 작업: AI IDE의 기본 조작 이해하기

-AI IDE(Cursor, Trae, Windsurf 등)의 기본 사용 방식이 아직 익숙하지 않다면, 부록의 [IDE 기초 튜토리얼](/ko-kr/appendix/2-development-tools/ide-basics/)을 먼저 보고 다음을 이해하는 것이 좋습니다.
+AI IDE(Cursor, Trae, Windsurf 등)의 기본 사용 방식이 아직 익숙하지 않다면, 부록의 [IDE 기초 튜토리얼](/zh-cn/appendix/2-development-tools/ide-basics/)을 먼저 보고 다음을 이해하는 것이 좋습니다.
 - 새 프로젝트 만들기
 - AI Agent와 대화하기
 - AI의 코드 생성 과정 이해하기
@@ -58,7 +58,7 @@ API는 컴퓨터 분야의 중요한 추상 개념입니다. 간단히 이해하
 6. **오류 처리**: 문제가 생겼을 때(API Key 오류, 요청 빈도 초과 등) 원인을 찾아 해결하는 방법을 아는 것입니다.

 ::: info ℹ️ API란 무엇인가
-API에 대한 더 깊은 설명은 부록 [API 입문](/ko-kr/appendix/4-server-and-backend/api-intro)을 참고하세요.
+API에 대한 더 깊은 설명은 부록 [API 입문](/zh-cn/appendix/4-server-and-backend/api-intro)을 참고하세요.

 ::: warning 🔐 **API 보안 주의사항**
 API Key는 AI 서비스 요청을 위한 “통행증”입니다. 신원 확인과 과금에 쓰이는 비밀번호 문자열입니다.
@@ -93,7 +93,7 @@ API에는 이런 기술 개념이 얽혀 있지만, 프로토타입 개발 단
 `1.2 직접 프로토타입 만들기`에서 이미 상호작용 가능한 프로토타입을 만들었습니다. 이제 해야 할 일은 프로토타입 안의 “AI처럼 보이는 기능”을 진짜 사용할 수 있는 능력으로 바꾸는 것입니다. **사용자가 버튼을 클릭하면 프로토타입이 외부 AI 서비스에 요청을 보내고, 반환된 텍스트를 화면에 표시**하게 만듭니다.

 ::: info ℹ️ 원리 확장
-원리 관련 내용을 더 알고 싶다면 부록 [대형 언어 모델(LLM) 입문](/ko-kr/appendix/8-artificial-intelligence/llm-principles)을 확인하세요.
+원리 관련 내용을 더 알고 싶다면 부록 [대형 언어 모델(LLM) 입문](/zh-cn/appendix/8-artificial-intelligence/llm-principles)을 확인하세요.
 ::: details 더 알아보기: DeepSeek이란 무엇인가?

 **항저우 DeepSeek 인공지능 기초기술 연구유한회사**(Hangzhou DeepSeek Artificial Intelligence Basic Technology Research Co., Ltd.)는 DeepSeek이라는 상호로 운영되는 **대형 언어 모델(LLMs)을 개발하는 중국 인공지능(AI) 회사**입니다. DeepSeek은 저장성 항저우에 본사를 두고 있으며, 중국 헤지펀드 환팡퀀트(High-Flyer)가 소유하고 자금을 지원합니다. DeepSeek은 환팡퀀트 공동 창업자인 Liang Wenfeng이 2023년 7월 설립했으며, 그는 두 회사의 CEO도 겸하고 있습니다. 이 회사는 2025년 1월 동명의 챗봇과 DeepSeek-R1 모델을 출시했습니다.
@@ -219,7 +219,7 @@ MiniMax의 API 형식은 DeepSeek과 거의 완전히 같습니다. 둘 다 Open
 # 3. 이미지-텍스트 API 연결하기: Qwen3 VL

 ::: info ℹ️ 원리 확장
-원리 관련 내용을 더 알고 싶다면 부록 [비전 언어 모델(VLM) 입문](/ko-kr/appendix/8-artificial-intelligence/multimodal-models)을 확인하세요.
+원리 관련 내용을 더 알고 싶다면 부록 [비전 언어 모델(VLM) 입문](/zh-cn/appendix/8-artificial-intelligence/multimodal-models)을 확인하세요.

 ::: details 더 알아보기: Qwen3 VL이란 무엇인가?

@@ -369,7 +369,7 @@ caption = caption_image(image_path)
 앞부분에서는 주로 텍스트 관련 작업을 다뤘습니다. 이제 이미지 생성 기능을 연결해 보겠습니다. 텍스트 설명에서 이미지를 생성하거나 이미지를 수정하는 기능을 지원합니다.

 ::: info ℹ️ 원리 확장
-원리 관련 내용을 더 알고 싶다면 부록 [이미지 생성 입문](/ko-kr/appendix/8-artificial-intelligence/image-generation)을 확인하세요.
+원리 관련 내용을 더 알고 싶다면 부록 [이미지 생성 입문](/zh-cn/appendix/8-artificial-intelligence/image-generation)을 확인하세요.

 ::: details 더 알아보기: [Seedream](https://seed.bytedance.com/en/seedream4_5)이란 무엇인가?

@@ -68,7 +68,7 @@ AI 시대, 특히 AI IDE를 사용할 때는 핵심 원칙 하나를 기억하
 ## 2. IDE란 무엇이고 왜 필요할까

 ::: info 예습 팁
-IDE가 무엇인지, 각 인터페이스 요소가 어떤 역할을 하는지 아직 익숙하지 않다면 [IDE 소개](/ko-kr/appendix/2-development-tools/ide-basics)를 먼저 읽고 IDE의 기본 개념과 흔한 기능을 예습하는 것이 좋습니다.
+IDE가 무엇인지, 각 인터페이스 요소가 어떤 역할을 하는지 아직 익숙하지 않다면 [IDE 소개](/zh-cn/appendix/2-development-tools/ide-basics)를 먼저 읽고 IDE의 기본 개념과 흔한 기능을 예습하는 것이 좋습니다.
 :::

 초기 프로그래밍 시대에는 간단한 텍스트 편집기와 언어 처리기만 있으면 충분했습니다. 하지만 프로젝트 복잡도가 증가하면서 개발자들은 파일을 효율적으로 관리하고, 문법 강조와 디버깅을 지원하는 도구를 절실히 필요로 하게 되었고, 그래서 통합 개발 환경(IDE)이 등장했습니다.
@@ -103,7 +103,7 @@ VS Code의 핵심 철학은 “모든 것은 플러그인”입니다. 플러그

 정리하면 IDE는 개발자가 코드를 효율적으로 쓰고 프로그램을 실행하도록 돕는 도구 묶음입니다.

-더 구체적인 설명은 [부록의 가상 IDE 시각화 IDE 원리 부분](/ko-kr/appendix/2-development-tools/ide-basics)을 확인하세요.
+더 구체적인 설명은 [부록의 가상 IDE 시각화 IDE 원리 부분](/zh-cn/appendix/2-development-tools/ide-basics)을 확인하세요.

 ## 3. AI IDE와 일반 IDE는 무엇이 다를까

@@ -507,7 +507,7 @@ vibe coding 초보자에게 가장 어려운 것은 오히려 무엇이 “베
 - **Panel(하단 패널)**: 터미널과 출력 창을 포함합니다.
 - **Status Bar(상태 표시줄)**: 현재 환경 상태를 표시합니다.

-더 구체적인 설명은 [부록의 가상 IDE 시각화 IDE 원리 부분](/ko-kr/appendix/2-development-tools/ide-basics)을 확인하세요.
+더 구체적인 설명은 [부록의 가상 IDE 시각화 IDE 원리 부분](/zh-cn/appendix/2-development-tools/ide-basics)을 확인하세요.

 <div style="margin: 50px 0;">
  <ClientOnly>
@@ -771,7 +771,7 @@ AI가 아주 성실하게 코드를 줬고, 당신도 정직하게 복사했지
      <span style="font-size: 12px; color: #909399">이해되지 않는 컴퓨터 용어를 만났을 때 여기서 빠르게 의미를 확인하세요. 한 번 통독하는 것을 추천합니다.</span>
    </el-col>
    <el-col :span="12">
-      <a href="/ko-kr/appendix/2-development-tools/ide-basics" style="text-decoration: none; color: inherit;"><b>부록 2: Visual Studio Code 메뉴 막대 해석</b></a><br/>
+      <a href="/zh-cn/appendix/2-development-tools/ide-basics" style="text-decoration: none; color: inherit;"><b>부록 2: Visual Studio Code 메뉴 막대 해석</b></a><br/>
      <span style="font-size: 12px; color: #909399">AI IDE 인터페이스가 어떤 역할을 하는지 모를 때 아래 내용을 AI와 대화하며 확인하거나 직접 읽어 보세요.</span>
    </el-col>
  </el-row>