GitBook은 Markdown 및 AsciiDoc 문법 형식을 지원하는 Node.js 기반 명령줄 도구로, HTML, PDF, eBook 및 기타 형식으로 전자책을 출력할 수 있습니다.
설치 node.js
gitbook 도구를 사용하기 전에 컴퓨터가 node.js 환경을 설치해야 하며, 설치 후 버전 명령어를 확인해 설치가 성공하는지 확인할 수 있습니다:
Gitbook 설치
Gitbook은 npm, 명령줄로 설치됩니다:
아래 명령을 실행해 GitBook 버전을 확인해 설치가 성공했는지 확인해 보세요.
설치 역사적 버전
gitbook-cli는 다른 버전의 GitBook을 쉽게 다운로드하고 설치할 수 있게 해주어 책을 테스트할 수 있습니다:
gitbook의 ls-remote를 사용하면 다운로드할 수 있는 버전을 열거합니다.
마크다운 편집기
여기서는 문서의 작성 언어로 Markdown 문법을 사용합니다. Markdown 편집기를 준비해야 합니다. Typora, MacDown, Bear, MarkdownPad, MarkdownX, JetBrains의 IDE(플러그인 설치 필요), Atom, Jianshu, CSDN, 그리고 GitBook 자체 편집기 등 다양한 Markdown 편집기를 시장에 많이 찾을 수 있습니다 GitBook Editor 등등.
컴퓨터에 VS Code 개발 도구가 설치되어 있고, VS Code는 기본적으로 마크다운을 지원합니다. 프리뷰 플러그인 아티팩트인 Markdown Preview Enhanced만 설치하면 됩니다. 그걸 사용할 예정입니다!
친구들이 추천한 편집자 타이포라, 주소:하이퍼링크 로그인이 보입니다.
책을 초기화하기
GitBook은 보일러플레이트를 설정할 수 있습니다:
책을 새 디렉터리에 만들고 싶으면 gitbook init ./directory를 실행하면 됩니다.
실행 후에는 다음 기능을 수행하는 README.md 와 SUMMARY.md 두 개의 파일을 더 볼 수 있습니다:
README.md - 책의 서문은 이 문서에 작성되어 있습니다
SUMMARY.md - 책의 카탈로그 구조는 여기에서 구성되어 있습니다
마크다운 문법에 익숙하지 않으니 몇 문장만 써보세요!
정적인 웹페이지 생성
정적인 웹 페이지를 생성하고 서버를 운영합니다
위 모든 내용은 도서 카탈로그 _book에 생성됩니다.
서버 명령어는 포트도 지정할 수 있습니다:
생성할 때 gitbook의 버전을 지정하세요. 그러면 먼저 로컬에서 다운로드되지 않습니다
모든 로컬 gitbook 버전을 나열합니다
원격으로 이용 가능한 gitbook 버전을 나열하세요
해당 gitbook 버전을 설치하세요
gitbook 최신 버전으로의 업데이트
해당 gitbook 버전을 삭제하세요
로그 레벨을 지정합니다
출력 오류 메시지
요약
GitBook은 책의 챕터와 하위 챕터의 구조를 정의하기 위해 SUMMARY.md 파일을 사용합니다. SUMMARY.md 파일은 책의 목차를 생성하는 데 사용됩니다.
SUMMARY.md 의 형식은 링크 목록입니다. 링크 제목은 해당 챕터의 제목으로 사용되며, 링크는 해당 챕터 파일로 가는 경로를 타겟팅합니다.
상위 챕터에 중첩 리스트를 추가하면 자식 챕터가 생성됩니다.
간단한 예시:
그 다음 명령줄로 돌아가서 mybook 폴더에서 gitbook init 명령을 다시 실행합니다. GitBook은 SUMMARY.md 파일에 설명된 디렉터리와 파일을 찾습니다.그렇지 않으면 창조됩니다。
PDF, ePub 또는 mobi 파일 출력
PDF 버전을 생성하고 싶다면, gitbook pdf를 실행할 수 있습니다. epub 형식으로 내보낼 때는 gitbook epub이고, mobi 형식이라면 gitbook mobi로 하면 됩니다.
만약 전자책을 PDF, ePub 또는 mobi 형식으로 내보내고 싶다면,Calibre 전자책 리더/관리자 및 명령줄 도구가 필요합니다, 그렇지 않으면 "EbookError: 전자책 생성 중 오류: 'ebook-convert'"라는 오류가 보고될 수 있습니다.
GitBook Special Files의 특징:
파일 | 묘사 | | book.json | 구성 데이터 (선택사항) | | README.md | 전자책 서문 또는 서문(필수) | | SUMMARY.md | 전자책 카탈로그 (선택 사항) | | GLOSSARY.md | 어휘/주석 용어 목록 (선택 사항) |
Gitbook 일반 설정
GitBook은 유연한 구성으로 전자책을 맞춤화할 수 있게 해줍니다.
이 옵션들은 book.json 파일에 명시되어 있습니다. JSON 문법에 익숙하지 않은 저자를 위해 JSONlint 같은 도구를 사용해 문법을 검증할 수 있습니다.
가변 | 묘사 | | 뿌리 | 책 파일을 모두 포함하는 루트 폴더로 가는 경로, 단book.json | | 구조 | readme, abtracts, glossariry 등 경로 명시하세요 | | 제목 | 책 제목과 기본 값은 README에서 추출한 것입니다. GitBook.com 에서는 이 필드가 미리 채워져 있습니다. | | Descrip{filter}tion | 책의 설명과 기본값은 README에서 추출됩니다. GitBook.com 에서는 이 필드가 미리 채워져 있습니다. | | 저자 | 저자 이름. GitBook.com 에서는 이 필드가 미리 채워져 있습니다. | | ISBN | ISBN | | 언어 | 이 책의 언어 유형은 ISO 코드입니다. 기본 값은 en입니다. | | 연출 | 텍스트 읽기 순서. 기본값은 RTL(오른쪽에서 왼쪽) 또는 LTR(왼쪽에서 오른쪽)일 수 있으며, 기본 값은 언어의 값에 따라 달라집니다. | | gitbook | GitBook 버전을 사용해야 합니다. SemVer 명세를 사용하고 "> = 3.0.0"과 유사한 조건을 수용하세요. |
|
게시됨 2018. 11. 23. 오후 2:03:54
|
|
|
|
