문서 가져오기

GitBook 에 기존 문서를 쉽게 가져올 수 있습니다. 책을 만들때 Import 탭에서 업로드하세요.

허용 형식

형식 확장자
Microsoft 워드 문서 .docx
DocBook v5.x .xml
HTML 파일 .html

이 기능을 최대한 사용하려면, 다음을 권장합니다:

  • Microsoft 워드 2007 이상 문서
  • DocBook v5.x 문서

4 버전의 DocBook 를 가지고 있다면, 최적의 호환성을 위해 5 버전으로 자동 변환을 고려하세요.

변환

가져오기 기능은 gitbook-convert CLI 유틸리티를 사용합니다. 이 모듈은 SUMMARY.md 의 생성과 함께 원본 문서를 마크다운 파일로 변환하는 것의 모든 측면을 담당합니다.

gitbook-convert 는 문서의 구조를 기반으로 큰 문서를 장과 절로 나눕니다. 그러므로, 각 원본 문서의 첫번째 단계의 헤더는 장으로 변환됩니다. 장이 두번째 단계의 헤더를 가지고 있으면, 이 장을 위해 파일 대신 폴더가 생성됩니다. 이 폴더는 각 절을 포함합니다.

장의 폴더에서, 장 서문을 가지는 README.md 파일이 생성됩니다. 처음으로 오는 두번째 단계의 헤더 이전의 내용은 장 서문으로 간주됩니다. 동일한 규칙으로 처음으로 오는 첫번째 단계의 헤더 이전의 내용은 책의 서문으로 사용됩니다.

.docx 문서를 위해, gitbook-convert 는 모든 포함된 이미지를 assets/ 폴더로 내보냅니다.

더 많은 유연성을 필요로하면, gitbook-convert 을 로컬에서 사용하는 을 고려해보세요. 저장소를 생성하고 Git 또는 GitHub 를 통해 가져오세요.

문제 해결

우리는 당신의 책이나 다른 질문들에 대해 기꺼이 돕겠습니다. github.com/GitbookIO/gitbook-convert 으로 질문이나 이슈를 보낼 수 있습니다.