> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-mintlify-bbaa8558.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 개발

> 업데이트를 W&B Weave 문서 사이트에 게시하기 전에 로컬에서 문서 변경 사항을 미리 보고 테스트합니다.

<Info>
  **사전 요구 사항**: 계속하기 전에 Node.js(버전 19 이상)를 설치하세요. <br />
  계속하기 전에 `docs.json`으로 전환하고 기존 `mint.json` 파일을 삭제하세요.
</Info>

운영 체제에서 Mintlify를 설치하고 실행하려면 다음 단계를 따르세요.

**1단계**: Mintlify 설치:

<CodeGroup>
  ```bash npm theme={null}
  npm i -g mintlify
  ```

  ```bash yarn theme={null}
  yarn global add mintlify
  ```
</CodeGroup>

**2단계**: `docs.json` 파일이 있는 `docs` 디렉터리로 이동한 다음, 다음 명령어를 실행합니다:

```bash theme={null}
mintlify dev
```

문서의 로컬 미리보기는 `http://localhost:3000`에서 확인할 수 있습니다.

<div id="custom-ports">
  ### 사용자 지정 포트
</div>

기본적으로 Mintlify는 포트 3000을 사용합니다. `--port` 플래그를 사용하면 Mintlify가 실행될 포트를 사용자 지정할 수 있습니다. 예를 들어 Mintlify를 포트 3333에서 실행하려면 다음 명령어를 사용합니다:

```bash theme={null}
mintlify dev --port 3333
```

이미 사용 중인 포트로 Mintlify를 실행하려고 하면, 다음으로 사용할 수 있는 포트를 사용합니다:

```md theme={null}
Port 3000 is already in use. Trying 3001 instead.
```

<div id="mintlify-versions">
  ## Mintlify 버전
</div>

각 CLI 릴리스는 특정 Mintlify 버전에 연결됩니다. 로컬 웹사이트가 프로덕션 버전과 일치하지 않으면 CLI를 업데이트하세요.

<CodeGroup>
  ```bash npm theme={null}
  npm i -g mintlify@latest
  ```

  ```bash yarn theme={null}
  yarn global upgrade mintlify
  ```
</CodeGroup>

<div id="validating-links">
  ## 링크 검증
</div>

CLI는 문서에 포함된 레퍼런스 링크를 검증하는 데 도움이 됩니다. 깨진 링크를 파악하려면 다음 명령어를 사용하세요:

```bash theme={null}
mintlify broken-links
```

<div id="deployment">
  ## 배포
</div>

<Tip>
  [Pro
  플랜](https://mintlify.com/pricing) 이상에서는 편집자를 무제한으로 이용할 수 있습니다.
</Tip>

배포가 성공하면 모든 검사를 통과했음을 알리는 확인 메시지가 표시됩니다.

<div id="code-formatting">
  ## 코드 서식 지정
</div>

IDE에서 MDX를 인식하고 서식을 지정할 수 있도록 확장 프로그램 사용을 권장합니다. VSCode를 사용 중이라면 구문 강조 표시용으로 [MDX VSCode extension](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx)을, 코드 서식 지정용으로 [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)를 고려해 보세요.

<div id="troubleshooting">
  ## 문제 해결
</div>

<AccordionGroup>
  <Accordion title="오류: darwin-arm64 런타임에서 &#x22;sharp&#x22; 모듈을 로드할 수 없습니다">
    이는 Node 버전이 오래되어 발생할 수 있습니다. 다음을 사용해 보세요:

    1. 현재 설치된 mintlify 버전을 제거합니다: `npm remove -g mintlify`
    2. Node를 v19 이상으로 업그레이드합니다.
    3. mintlify를 다시 설치합니다: `npm install -g mintlify`
  </Accordion>

  <Accordion title="문제: 알 수 없는 오류가 발생하는 경우">
    해결 방법: 기기의 루트 디렉터리로 이동해 \~/.mintlify 폴더를 삭제합니다. 그런 다음 `mintlify dev`를 다시 실행합니다.
  </Accordion>
</AccordionGroup>

CLI 버전에서 무엇이 변경되었는지 궁금하신가요? [CLI 변경 로그를 확인하세요.](https://www.npmjs.com/package/mintlify?activeTab=versions)