github 페이지 에 octopress 를 배치 하여 개인 블 로그 시스템 을 구축 합 니 다.

링크: http://caiqinghua.github.io/blog/2013/08/26/deploy-octopress-to-github-pages/
도입부
지난 블 로 그 는 왜 이 블 로그 시스템 을 구축 해 야 하 는 지 에 대해 말 했다. 본 고 는 더 이상 잔소리 하지 않 고 단도직입적으로 다음 과 같은 주 제 를 말한다.1. Octopress 가 무엇 인지 2. Github Page 가 무엇 인지 3. Octopress 를 Github Pages 에 배치 하 는 과정 4. 배치 과정 에서 발생 하 는 문제
본문의 기본 지식 을 이해 하 다.
windows 명령 행 기본 사용 방법 (실행 중 cmd 입력, enter 입력) git (학습 자료: Pro Git 간 체 중국어 버 전, 자체 구 글 다운로드) github(github.com)
ruby (본 고 는 설치 할 줄 만 알 면 몇 가지 명령 을 사용 하면 됩 니 다) octopress 가 뭐 예요?
정적 블 로그 도 구 를 자동화 하여 만 듭 니 다. 템 플 릿 과 일괄 처리 도 구 를 포함 합 니 다. ruby 와 sass 로 이 루어 졌 습 니 다. 작가 imathis 도 copas 의 작가 입 니 다. copas 가 본 고의 관심 사가 무엇 인지 독자 스스로 구 글 에서 알 아 보 세 요.
github pages 가 무엇 입 니까?
github 정적 페이지, 프로젝트 홍보 홈 페이지 같은 용도.
왜 github pages 에 배치 되 었 습 니까?
github pages 무료 공간, 무료 데이터, 매번 블 로그 변경 과 블 로그 템 플 릿 변경 은 git 에서 추적 합 니 다. 선택 하지 않 을 이유 가 없습니다.
step by step Github 페이지 에 Octopress 배치
준비 하 다.
시스템: Windows 7
Git： 다운로드 주소
Ruby： 다운로드 주소  메모: github 에 octopress 를 배치 하기 전에 ruby on rails 를 설치 한 적 이 있 습 니 다. 그래서 저 는 위의 ruby 1.9.3 을 설치 하지 않 았 습 니 다. 제 가 설치 한 것 은 railsinstaller-2.2.1 입 니 다. 자세 한 내용 은 다음 과 같 습 니 다. http://railsinstaller.org/en 따라서 아래 의 설치 과정 에 많은 문제 가 발생 할 수 있 으 므 로 ruby 1.9.3 을 직접 설치 하고 railsinstaller 를 설치 하지 않 는 것 을 권장 합 니 다.
DevKit： 다운로드 주소
Octopress：git://github.com/imathis/octopress.git
소프트웨어 를 설치 하 다
Git 윈도 우 를 설치 하고 Git 을 설치 하 는 것 은 간단 합 니 다. next 로 가면 됩 니 다.
Ruby Ruby 를 설치 하 는 것 도 next 로 가면 됩 니 다. 다만 "Add Ruby executables to your PATH" 를 선택 하고 Ruby 의 실행 경 로 를 환경 변수 에 추가 하 십시오. 선택 을 잊 어 버 리 면 수 동 으로 설정 할 수도 있 습 니 다. 설치 후 명령 프롬프트 에 ruby – version 을 입력 하여 설치 여 부 를 확인 할 수 있 습 니 다.
DevKit DevKit 를 설치 하여 다운로드 한 것 은 자체 압축 파일 입 니 다. D: / devKit 로 압축 을 풀 었 습 니 다. 두 가지 주의 가 필요 합 니 다.
디 렉 터 리 에 중국어 와 빈 칸 이 없습니다. Ruby 를 먼저 설치 해 야 하고 Ruby 는 Ruby Installer 가 설치 해 야 합 니 다. DevKit 압축 해제 후 명령 행 에 다음 명령 을 입력 하여 설치 합 니 다.

1

2

3

cd /d D:\DevKit ruby dk.rb init ruby dk.rb install

Git 으로 octopress 소스 코드 를 로 컬 에 다운로드 합 니 다.

1

2

cd /d D:\ruby git clone git://github.com/imathis/octopress.git octopress

다운로드 가 완료 되면 D: \ ruby 파일 에 octopress 폴 더 를 생 성 합 니 다. 아래 작업 은 모두 이 폴 더 를 기반 으로 합 니 다.
Octopress 의존 항목 설치

1

2

3

cd octopress gem install bundler bundle install

octopress 기본 테마 설치

1

2

cd octopress $ rake install

첫 블 로그 만 들 기

1

$ rake new_post["My first octopress blog"]

로 컬 미리 보기 생 성 된 블 로그 시스템 과 블 로그

1

$ rake preview

브 라 우 저 접근 열기  http://localhost:4000/%EF%BC%8C%E4%BD%A0%E7%9A%84%E7%AC%AC%E4%B8%80%E7%AF%87%E5%8D%9A%E5%AE%A2%E5%B0%86%E5%91%88%E7%8E%B0%E5%9C%A8%E7%9C%BC%E5%89%8D%E3%80%82
이상 은 이미 octopress 블 로그 시스템 과 첫 번 째 블 로 그 를 생 성 했 으 며, 그 다음 에 생 성 된 블 로그 시스템 과 블 로 그 를 github pages 에 배치 해 야 합 니 다.
git 저장 소 만 들 기
https://github.com/  Create a new repo 이름 username. github. com 을 입력 하 십시오. username 을 username 으로 바 꾸 는 것 을 주의 하 십시오. 뒤의 github. com 을 생략 할 수 없습니다. eg. caiqinghua. github. com
새로 만 든 reposcory 경 로 를 로 컬 로 설정 합 니 다.

1

2

3

4

$ rake setup_github_pages Enter the read/write url for your repository (For example, '[email protected]:your_username/your_username.github.com) Repository url: 

입력 하 세 요: [email protected]:yourname/yourname.github.com.git (yorname 을 github 로그 인 이름 으로 바 꿉 니 다)
메모: 이 단 계 는 힌트 에 있 는 io 로 끝 나 는 주 소 를 입력 하지 마 십시오.
SSH 설정
설정 절차 자체 구 글 해결 SSH 를 설정 하지 않 아 도 됩 니 다. githib 비밀 번 호 를 입력 하여 업로드 할 때마다 구 글 에서 해결 하 십시오.
블 로그 배치

1

2

rake generate rake deploy

deploy 는 repo 의 master 분기 에 deploy 디 렉 터 리 를 올 렸 을 뿐 입 니 다. 생 성 된 정적 블 로그 사이트 만 github pages 에 올 렸 을 뿐 입 니 다. 이 정적 사이트 생 성 도 구 를 repo 의 source 분기 에 올 려 야 합 니 다.
제출 한 source 디 렉 터 리

1

2

3

4

cd /d D:\ruby\octopress git add . git commit -m "My octopress blog source code" git push origin source

github. com 에 가서 위 에 새로 만 든 reposcory 를 보면 소스 분기 가 하나 더 많아 서 모든 원본 파일 을 기록 합 니 다.
설치 과정 에서 발생 한 문제
1. bundle install 과정 중 rdiscount (2.0.7.3) 설치 실패
원인 추측: DevKit 문 제 는 Ruby 200 의 DevKit 를 삭제 하고 path 의 c: \ Ruby 200 \ \ devkit 를 삭제 하고 bundle install 을 다시 실행 하 는 데 성 공 했 습 니 다.
2. rake install 오류

1

2

3

4

d:\ruby\octopress>rake install rake aborted! You have already activated rake 10.1.0, but your Gemfile requires rake 0.9.2.2. Using bundle exec may solve this.

해결 방법: octopress / Gemfiles gem 'rake' 수정, '~ > 0.9' gem 'rake' 다시 rake install 성공
3. rake setup github pages' hellip '은 내부 또는 외부 명령 이 아 닙 니 다.

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

d:\ruby\octopress>rake setup_github_pages Enter the read/write url for your repository (For example, '[email protected]:your_username/your_username.github.io)  or 'https://github.com/your_username/your_username.github.io') Repository url: [email protected]:caiqinghua/caiqinghua.github.io Added remote [email protected]:caiqinghua/caiqinghua.github.io as origin Set origin as default remote Master branch renamed to 'source' for committing your blog source files rm -rf _deploy mkdir _deploy cd _deploy Initialized empty Git repository in d:/ruby/octopress/_deploy/.git/ 'My Octopress Page is coming soon 'hellip'          ，                。 [master (root-commit) 7e72dcf] Octopress init 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 index.html cd - --- ## Now you can deploy to [email protected]:caiqinghua/caiqinghua.github.io with `ra ke deploy` ##

google: 'hellip' 은 내부 나 외부 명령 이 아니 라 실행 가능 한 프로그램 도 아 닙 니 다.  http://pythonee.github.io/blog/2012/08/10/how-to-octpress/  이 잘못 은 대 수 롭 지 않 으 니 해결 할 필요 가 없다.
4. rake deploy

1

2

3

4

5

6

## Pushing generated _deploy website Permission denied (publickey). fatal: Could not read from remote repository. Please make sure you have the correct access rights and the repository exists.

해결 방법: ssh 설정, 앞에서 언급 했 습 니 다.
5. 다시 rake deploy, 다음 오류 발생

1

2

3

4

## Pushing generated _deploy website Enter passphrase for key '/c/Users/Lin/.ssh/id_rsa': ERROR: Repository not found. fatal: Could not read from remote repository.

질문 원인: rake setup github pages 중[email protected]: caiqinghua / caiqinghua. github. io 설정 오류, 설정 해 야 합 니 다[email protected]: caiqinghua / caiqinghua. github. com. git 해결 방법: octopress deploy. git \ \ config 보기
url 오류 발견, 수정 후 재 시도, 배치 완료

1

2

[remote "origin"]  url = [email protected]:caiqinghua/caiqinghua.github.io

으로 변경

1

2

[remote "origin"]  url = [email protected]:caiqinghua/caiqinghua.github.com.git

메모: octopress. git \ config 의 url 도 잘못 생 성 되 었 습 니 다.

1

2

[remote "origin"]  url = [email protected]:caiqinghua/caiqinghua.github.io

으로

1

2

3

[remote "origin"]  url = [email protected]:caiqinghua/caiqinghua.github.com.git  fetch = +refs/heads/*:refs/remotes/origin/*

rake gen deploy 를 다시 실행 하 는 데 성 공 했 습 니 다.
즉시 caiqinghua. github. com 을 방문 하여 404 페이지 에 오 류 를 찾 지 못 했 음 을 알려 줍 니 다. 10 분 후에 방문 하면 로 컬 미리 보 기 를 볼 수 있 는 블 로 그 를 볼 수 있 습 니 다. 이 배치 octopress 를 github pages 에 드디어 완 료 했 습 니 다.
후기
octopress 에 서 는 markdown 형식 으로 블 로 그 를 작성 하고 markdown 문법, 블 로 그 를 어떻게 작성 하 는 지, 블 로 그 를 어떻게 개성 화 시 키 는 지, 그리고 다음 글 의 분 해 를 들 어 봅 니 다.
Posted by 채 청 화[email protected] Aug 26th, 2013   opensource ,  tools