---
title: AI로 MkDocs 사이트 번역하기 | Smartcat
description: AI로 MkDocs 사이트를 번역하고 문맥 속에서 검토해 보세요. head 블록에 대한 테마 재정의(override)를 통해 설치하세요.
canonical: https://ko.smartcat.com/integrations/mkdocs/
language: ko
updated: 2026-11-16
---

# AI로 MkDocs 사이트 번역하기 | Smartcat

## AI로 MkDocs 사이트를 번역하세요

Smartcat 웹사이트 스니펫을 MkDocs 프로젝트에 한 번 추가하고, 일반 파이프라인을 통해 배포한 다음, 언어를 게시하기 전에 Smartcat에서 번역을 검토하세요.

- [무료 평가판 시작](https://smartcat.com/sign-up)

- [데모 예약하기](https://www.smartcat.com/book-a-demo/?mkdocs)

## MkDocs에 Smartcat을 추가하는 방법

게시된 MkDocs URL에서 Smartcat 웹사이트 프로젝트를 생성하고 대상 언어를 선택하세요.

head 블록에 대한 테마 재정의(theme override)를 통해 생성된 Smartcat 스니펫을 설치합니다(extra_javascript는 에셋만 로드합니다).

변경 사항을 배포하고 게시된 사이트를 열어 스니펫이 있는지 확인하세요.

Smartcat의 비주얼 편집기에서 번역을 검토하고 준비된 언어를 게시하세요.

## 생성된 HTML을 편집하지 않고 MkDocs 사이트 번역하기

MkDocs 소스 설정에 통합 상태를 유지하세요. extra_javascript는 자바스크립트 애셋을 로드하는 반면, 제공된 설치 방식에 head 마크업이 필요한 경우에는 테마 오버라이드가 필요할 수 있습니다. Material for MkDocs를 사용할 때는 설치된 테마 패키지를 수정하기보다는 지원되는 템플릿 확장 기능을 사용하세요.

다시 빌드하고 배포한 다음, 내비게이션, 주의 및 알림 문구, 코드 예제가 포함된 가이드를 검토하십시오. 번역된 경고는 그 심각성을 유지해야 하며, 명령어 예시는 계속해서 실행 가능한 상태로 유지되어야 합니다. 웹사이트 번역은 두 번째 마크다운 소스 세트를 생성하지 않습니다.

## 방문자에게 변경되는 사항과 MkDocs에 그대로 유지되는 사항

웹사이트 번역은 이미 게시된 글의 읽기 경험을 변화시킵니다. 이는 MkDocs 저장소에 번역된 소스 파일, 메시지 카탈로그 또는 로케일 빌드를 생성하지 않습니다.

## 언어 서비스 개시 전 검토

기계 번역은 빠른 초안을 제공합니다. Smartcat의 비주얼 에디터에서는 페이지에서 번역된 각 문자열을 확인하고, 모바일에서 길어지는 제목을 줄이며, 용어집을 통해 제품 및 브랜드 이름을 일관되게 유지할 수 있습니다. 페이지 승인이 필요할 때 검토자를 지정하고, 준비된 언어만 게시하세요.

## 자주 묻는 질문들

### extra_javascript에 HTML script 태그를 붙여넣을 수 있나요?

extra_javascript는 자유 형식의 HTML head 필드가 아니라 에셋 구성 설정입니다. 지원되는 구조를 따르고 실제 마크업이 필요한 경우에는 테마 오버라이드를 사용하세요.

### 게시하기 전에 번역을 수정할 수 있나요?

네. Smartcat의 비주얼 에디터에서 문구를 다듬고 확정한 다음, 준비된 언어를 게시하세요.

### MkDocs에 새 페이지를 추가하면 어떻게 되나요?

새 텍스트는 Smartcat 프로젝트에서 선택한 번역 모드를 따릅니다. 모든 새 페이지에 승인이 필요한 경우에는 검토된 번역을 선택하십시오. 자동 모드는 새로 발견된 텍스트를 번역할 수 있습니다. 어느 모드든 MkDocs의 원본 콘텐츠를 변경하지 않습니다.

더 많은 언어로 MkDocs 사이트를 게시하세요

스니펫을 한 번만 설치하고, 컨텍스트 내에서 번역을 검토한 후, 대상 고객에게 필요한 언어를 게시하세요. 모든 [웹사이트 연동](https://www.smartcat.com/integrations/category/website-translation/)을 확인하거나 [웹사이트 번역기](https://www.smartcat.com/website-translator/)의 작동 방식을 읽어보세요.

- [무료 평가판 시작](https://smartcat.com/sign-up)
