gitbook 입문 강좌 발표 전자 책

출력 대상 파일
문법 형식: gitbook build [book] [출력]
기본 적 인 상황 에서 gitbook 수출 방식 은 정태 적 인 사이트 이다. 사실은 gitbook 의 수출 방식 은 세 가지 가 있다. website, json, 그리고 ebook.
다만 다른 두 가 지 는 자주 사용 되 지 않 습 니 다. 더 많은 경우 에 저 희 는 정적 웹 페이지 를 이용 하여 개인 홈 페이지 를 구축 하거나 제3자 플랫폼 에 위탁 하거나 개인 클 라 우 드 서버 에 배치 하지만 어쨌든 생 성 이라는 단 계 를 떠 날 수 없습니다.
예시:

#       : `website`
$ gitbook build --format=website

#       : `json`
$ gitbook build --format=json

#       : `ebook`
$ gitbook build --format=ebook

기본 값 으로 디 렉 터 리 출력:_book/ 전체 프로젝트 의 입구 파일 은:index.html
통합 github 사이트
본 튜 토리 얼 의 전자 책 소스 코드 와 출력 파일 은 모두 github 사이트 에 위탁 관리 되 기 때문에 Github Pages 정적 웹 서비스 와 gitbook 를 어떻게 활용 하여 통합 하 는 지 소개 합 니 다.
무엇이 GitHub Pages 입 니까?Github Pages 은 github 사이트 에서 내 놓 은 무료 정적 웹 위탁 관리 서비스 로 정적 프로젝트 홈 페이지 나 개인 홈 페이지 를 구축 하기에 적합 하 다.
그 중에서 사이트 프로젝트 의 소스 코드 는 github 창고 에 직접 위탁 되 고 창고 파일 이 업 데 이 트 된 후에 이 창고 와 관련 된 사이트 가 자동 으로 업데이트 되 어 소스 코드 와 홈 페이지 의 연동 업 데 이 트 를 실현 했다.
더 자세 한 정 보 를 알 고 싶 으 시 면 홈 페이지 를 참고 하 세 요.https://pages.github.com/
어떻게 해요?
계 정 마다 홈 페이지 사이트 가 하나 있 지만 무제 한 프로젝트 사이트 가 허용 된다.
홈 페이지 사이트 가 무엇 입 니까? 프로젝트 사 이 트 는 또 무엇 입 니까?
서 두 르 지 마 세 요. 제 가 먼저 예 를 들 어 최종 효 과 를 보 겠 습 니 다.
만약 에 사용자 이름: GitHub Pages 명의 로 네 개의 공개 창고 가 있다 면 한 창 고 는 'zhangsan' 이 고 다른 세 가 지 는 'zhangsan.github.io, project01' project02 이다.
상기 네 개의 창 고 를 우리 의 정적 사이트 로 대외 적 으로 노출 시 키 려 면 최종 효 과 는 다음 과 같다.

홈 페이지 사이트:https://zhangsan.github.io

프로젝트 01 사이트:https://zhangsan.github.io/project01

프로젝트 02 사이트:https://zhangsan.github.io/project02

프로젝트 03 사이트:https://zhangsan.github.io/project03

주의 장project03 자신의 것 으로 교체zhangsan 사용자 이름, 그렇지 않 으 면 80% 는 사 이 트 를 열 수 없다.github 이 사용자.
사실 상기 규칙 은 잘 이해 할 수 있다. zhangsan 사 이 트 는 위탁 관리 센터 로 서 수천 명의 사용자 가 사용 하고 있다 github. 또한 모든 사용자 의 사용자 이름 이 유일 하고 다 르 기 때문에 github 어댑터 도 메 인 이름 은 네 임 스페이스 를 충당 할 수 있다.
예상 할 수 있 는 것 은 *.github.io 와 같은 2 급 도 메 인 이름 만 있 는 것 이 아니 라 .github.io, api.github.io 등 도 있 습 니 다. docs.github.io 도 메 인 이름 인증 서 를 구 매 하면 임의의 2 급 도 메 인 이름 을 지원 할 수 있 기 때 문 입 니 다. *.github.io 저희 에 게 무료 github 사 이 트 를 증정 해 주 셔 서 감사합니다.
여기까지 말 하면 https 의 네 임 스페이스 전략 을 토로 할 수 밖 에 없다. gitbook 도 자신의 전자 책 위탁 관리 서비스 가 있 지만 방문 주 소 는 gitbook 이다.
분명 한 것 은 .gitbook.io/ 홈 페이지 사이트 와 프로젝트 사 이 트 를 구분 하지 않 았 고 모두 프로젝트 사이트 에 해당 하 며 홈 페이지 의 구분 이 부족 합 니 다.
잡담 은 그만 하고 입력 내용 과 출력 효 과 를 알 게 된 이상 다음 임 무 는 중간 과정 을 이해 하 는 것 입 니 다. 사 이 트 를 어떻게 발표 하 는 지 함께 토론 합 시다!
홈 페이지 사이트
공개 창고 만 들 기 gitbook가다https://github.com/ 사 이 트 는 .github.io 라 는 공개 창 고 를 만 들 었 다.
예 를 들 어 제 사용자 이름 은:.github.io 그럼 제 홈 페이지 창 고 는:snowdreams1006
첫 페이지 만 들 기 snowdreams1006.github.io 파일
온라인 으로 직접 만 들 든 index.html 로 컬 로 복제 하 든 index.html 최종 index.html 창 고 는 반드시 .github.io 첫 페이지 파일 이 있어 야 합 니 다.
예시:

#      
$ git clone https://github.com/username/username.github.io

#      
$ cd username.github.io

#    `index.html`   
$ echo "Hello World" > index.html

#        
$ git add --all
$ git commit -m "Initial commit"
$ git push -u origin master

홈 페이지 사이트 방문 index.html브 라 우 저 를 열 고 웹 주 소 를 입력 하 십시오:https://username.github.io 홈 페이지 사이트 에 방문 하면 표시 되 는 내용 은 바로 우리 가 방금 제출 한 https://username.github.io 파일 내용 입 니 다.
제대로 표시 되 지 않 으 면 브 라 우 저 캐 시 를 지우 고 강제로 새로 고침 해 보 세 요!
프로젝트 사이트
홈 페이지 사이트 에 비해 프로젝트 사이트 의 이름 은 비교적 자 유 롭 습 니 다. 정적 사이트 로 서 불가 하거나 부족 한 파일 은 여전히 index.html 입 니 다.
첫 페이지 만 들 기 index.html 파일
첫 페이지 파일 을 만 들 고 테스트 내용 을 추가 합 니 다. 잠시 후에 온라인 으로 프로젝트 사이트 에 방문 하여 배치 여 부 를 테스트 할 수 있 습 니 다.
설정 index.html 옵션
창고 첫 페이지 오른쪽 상단 설정 GitHub Pages 옵션 을 누 르 고 아래로 Settings 옵션 을 누 르 고 소스 디 렉 터 리 를 선택 하 십시오. 실제 상황 에 따라 소스 코드 가 GitHub Pages 분기 에서 유래 되 었 는 지 다른 분기 나 master 디 렉 터 리 에서 유래 되 었 는 지 선택 하 십시오.
편 하 게 첫 번 째 를 선택 하 세 요.docs/ 가 지 를 나 누 면 됩 니 다. 아래 의 주제 와 이 단계 의 출처 는 둘 중 하나 만 선택 할 수 있 습 니 다. 그렇지 않 으 면 주제 우선 순위 가 더욱 높 습 니 다!
홈 페이지 사이트 방문 master브 라 우 저 를 열 고 웹 주 소 를 입력 하 십시오:https://username.github.io/repository 프로젝트 사이트 에 방문 하면 표시 되 는 내용 은 바로 우리 가 방금 제출 한 https://username.github.io/ 파일 내용 입 니 다.
제대로 표시 되 지 않 으 면 브 라 우 저 캐 시 를 지우 고 강제로 새로 고침 해 보 세 요!
어떻게 집적 합 니까 index.html?
우 리 는 gitbook 정적 사 이 트 를 제공 하 는 무료 위탁 관리 라 는 것 을 이미 알 고 있 습 니 다. Github Pages 기본 적 으로 생 성 된 내용 은 정적 사이트 입 니 다. 이들 이 어떻게 결합 하 는 지 자 연 스 럽 게 제 가 더 이상 말 하지 않 아 도 되 죠?gitbook 기본 출력 디 렉 터 리 gitbook 는 정적 사이트 에 필요 한 모든 자원 을 포함 하 는데 그 중에서 _book/ 첫 페이지 파일 을 포함한다.
따라서 우 리 는 매번 생 성 된 후에 index.html 전체 디 렉 터 리 를 프로젝트 루트 디 렉 터 리 로 복사 하면 원 격 창고 로 보 낼 때 자 연 스 럽 게 출력 후 정적 사이트 가 됩 니 다!
예시:

#       
$ gitbook build

#         
$ cp -r _book/* .

#         
$ git add .
$ git commit -m "publish"

#        
$ git push origin master

현재 로그 인_book/ 사 이 트 는 정적 사이트 가 성공 적 으로 업로드 되 었 는 지, 홈 페이지 나 프로젝트 사 이 트 를 방문 하여 최신 내용 이 성공 적 으로 렌 더 링 되 었 는 지 확인 하 세 요!
작은 매듭
이 절 에서 우 리 는 github 세 가지 출력 방식 을 배 웠 는데 그 중에서 기본 적 인 웹 출력 이 가장 자주 사용 된다.
이 밖 에 gitbook 와 어떻게 결합 하여 소스 코드 와 사이트 의 자동 업데이트 유 지 를 실현 하 는 지 설명 했다.
만약 에 소스 코드 가 github pages 와 같은 제3자 서비스 업 체 에 위탁 되 지 않 았 다 면 당신 은 자신의 서버 를 구축 할 수 있 습 니 다. 예 를 들 어 github 디 렉 터 리 를 모두 _book/ 서버 에 버 리 고 정적 자원 서버 를 만 드 는 등 입 니 다.
어쨌든 소스 코드 와 출력 내용 은 모두 네 손 에 있 으 니 어떻게 놀 고 싶 은 지 는 스스로 결정 하 는 것 이 아니 냐?