Merge branch 'main' into translate/react-performance-tracks

Author: lumirlumir

eslint.config.mjs

@@ -1,21 +1,24 @@
 /* eslint-disable import/no-anonymous-default-export */
-import mark from 'eslint-plugin-mark';
+import md from 'eslint-markdown';
 
 export default [
   {
     ignores: ['**/*.js', '**/*.mjs', '**/*.cjs'],
   },
   {
-    ...mark.configs.baseGfm,
+    ...md.configs.base,
     files: ['src/content/**/*.md'],
     rules: {
-      'mark/no-curly-quote': [
+      'md/no-curly-quote': [
         'error',
-        {leftSingleQuotationMark: false, rightSingleQuotationMark: false},
+        {
+          checkLeftSingleQuotationMark: false,
+          checkRightSingleQuotationMark: false,
+        },
       ],
-      'mark/no-double-space': 'error',
-      'mark/no-git-conflict-marker': ['error', {skipCode: false}],
-      'mark/no-irregular-whitespace': [
+      'md/no-double-space': 'error',
+      'md/no-git-conflict-marker': ['error', {skipCode: false}],
+      'md/no-irregular-whitespace': [
         'error',
         {skipCode: false, skipInlineCode: false},
       ],

package.json

@@ -76,7 +76,7 @@
     "eslint-plugin-import": "2.x",
     "eslint-plugin-jsx-a11y": "6.x",
     "eslint-plugin-local-rules": "link:eslint-local-rules",
-    "eslint-plugin-mark": "^0.1.0-canary.2",
+    "eslint-markdown": "^0.1.0-canary.12",
     "eslint-plugin-react": "7.x",
     "eslint-plugin-react-compiler": "^19.0.0-beta-e552027-20250112",
     "eslint-plugin-react-hooks": "^0.0.0-experimental-fabef7a6b-20221215",

src/content/blog/2024/12/05/react-19.md

@@ -4,7 +4,7 @@ author: React 팀
 date: 2024/12/05
 description: React 19를 이제 npm에서 사용할 수 있습니다! 이 포스트에서 React 19의 새로운 기능들에 대한 개요와 도입하는 방법에 대해 설명합니다.
 ---
-{/*<!-- eslint-disable mark/no-double-space -->*/}
+{/*<!-- eslint-disable md/no-double-space -->*/}
 2024년 12월 5일, [React 팀](/community/team)
 
 ---

src/content/blog/2025/10/16/react-conf-2025-recap.md

@@ -10,9 +10,9 @@ title: React 블로그
 
 <div className="sm:-mx-5 flex flex-col gap-5 mt-12">
 
-<BlogCard title="React Conf 2025 Recap" date="October 16, 2025" url="/blog/2025/10/16/react-conf-2025-recap">
+<BlogCard title="React Conf 2025 요약" date="2025년 10월 16일" url="/blog/2025/10/16/react-conf-2025-recap">
 
-Last week we hosted React Conf 2025. In this post, we summarize the talks and announcements from the event...
+지난주에 React Conf 2025를 개최했습니다. 이 글에서는 행사에서 있었던 강연과 발표 내용을 정리합니다...
 
 </BlogCard>
 

src/content/blog/index.md

@@ -24,7 +24,7 @@ title: 기존 프로젝트에 React 추가하기
 2. 사용하는 프레임워크 설정에서 **`/some-app` 을 *기본 경로*<sup>*Base Path*</sup>로 명시하세요**. (이때, [Next.js](https://nextjs.org/docs/app/api-reference/config/next-config-js/basePath), [Gatsby](https://www.gatsbyjs.com/docs/how-to/previews-deploys-hosting/path-prefix/)를 사용하세요!)
 3. **서버 또는 프록시를 구성**하여 `/some-app/` 하위의 모든 요청이 React 앱에서 처리되도록 하세요.
 
-This ensures the React part of your app can [benefit from the best practices](/learn/build-a-react-app-from-scratch#consider-using-a-framework) baked into those frameworks.
+이렇게 하면 앱의 React 부분이 해당 프레임워크에 [내장된 모범 사례](/learn/build-a-react-app-from-scratch#consider-using-a-framework)의 이점을 누릴 수 있습니다.
 
 많은 React 기반의 프레임워크는 풀스택이며 React 앱이 서버를 활용할 수 있도록 합니다. 그러나 서버에서 자바스크립트를 실행할 수 없거나 실행하고 싶지 않은 경우에도 동일한 접근방식을 사용할 수 있습니다. 이러한 경우에는 HTML/CSS/JS 내보내기(Next.js의 경우 [`next export` output](https://nextjs.org/docs/advanced-features/static-html-export), Gatsby의 경우 기본값)를 `/some-app/`에서 대신 제공하세요.
 

src/content/learn/add-react-to-an-existing-project.md

@@ -122,7 +122,7 @@ GraphQL API에서 데이터를 가져온다면 다음을 사용할 것을 제안
 
 ### 애플리케이션 성능 향상 {/*improving-application-performance*/}
 
-Since the build tool you select only supports single page apps (SPAs), you'll need to implement other [rendering patterns](https://www.patterns.dev/vanilla/rendering-patterns) like server-side rendering (SSR), static site generation (SSG), and/or React Server Components (RSC). Even if you don't need these features at first, in the future there may be some routes that would benefit SSR, SSG or RSC.
+선택한 빌드 도구는 단일 페이지 앱(SPA)만 지원하므로, 서버 사이드 렌더링(SSR), 정적 사이트 생성(SSG), 또는 React 서버 컴포넌트(RSC)와 같은 다른 [렌더링 패턴](https://www.patterns.dev/vanilla/rendering-patterns)을 직접 구현해야 합니다. 처음에는 이러한 기능이 필요하지 않더라도, 나중에는 SSR, SSG 또는 RSC가 유리한 라우트가 생길 수 있습니다.
 
 * **단일 페이지 앱 (SPA)** 은 단일 HTML 페이지를 로드하고 사용자가 앱과 상호작용을 할 때 페이지를 동적으로 업데이트합니다. SPA는 시작하기는 더 쉽지만, 초기 로드 시간이 느릴 수 있습니다. SPA는 대부분의 빌드 도구에서 기본 아키텍처입니다.
 

src/content/learn/build-a-react-app-from-scratch.md

@@ -211,7 +211,7 @@ li {
 
 이 문제를 해결하는 한 방법은 부모 요소에서 단일 ref를 얻고, [`querySelectorAll`](https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelectorAll)과 같은 DOM 조작 메서드를 사용하여 그 안에서 개별 자식 노드를 "찾는" 것입니다. 하지만 이는 다루기가 힘들며 DOM 구조가 바뀌는 경우 작동하지 않을 수 있습니다.
 
-Another solution is to **pass a function to the `ref` attribute.** This is called a [`ref` callback.](/reference/react-dom/components/common#ref-callback) React will call your ref callback with the DOM node when it's time to set the ref, and call the cleanup function returned from the callback when it's time to clear it. This lets you maintain your own array or a [Map](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map), and access any ref by its index or some kind of ID.
+또 다른 해결책은 **`ref` 어트리뷰트에 함수를 전달하는 것입니다.** 이것을 [`ref` 콜백](/reference/react-dom/components/common#ref-callback)이라 부릅니다. React는 ref를 설정할 때 DOM 노드와 함께 ref 콜백을 호출하고, ref를 지울 때는 콜백에서 반환된 정리 함수를 호출합니다. 이를 통해 배열이나 [Map](https://developer.mozilla.org/ko/docs/Web/JavaScript/Reference/Global_Objects/Map)을 직접 관리하고 인덱스나 특정 ID로 ref에 접근할 수 있습니다.
 
 아래 예시는 긴 목록에서 특정 노드에 스크롤 하기 위해 앞에서 말한 접근법을 사용합니다.