如何github寫文章|github怎麼寫wiki

本文在Windows7下測試成功。

安裝和設定Git 下載Git for Windows，採用默認安裝，安裝完成後就可以在本地使用Git了。但要將內容放到Github上，必須先在Github網站上註冊個帳戶，然後在本機使用Git創建SSH Key。

操作如下：在Git Bash上輸入命令：ssh-keygen -C "[email protected]" -t rsa Note: “[email protected]”需要更換成你在Github上註冊的Email地址或者是Username 這樣會在用戶目錄（C:Users用戶名）下產生一個.ssh檔案夾，裏面爲對應的SSH Keys，其中id_rsa.pub是Github需要的SSH公鑰檔案。到c:Users用戶名.ssh目錄找到id_rsa.pub（可能位置不一定對，但是確認是以.pub結尾的檔案），並用記事本開啟複製全部內容。

Note：建議私鑰公鑰的名稱最好寫成"id_rsa"，這樣連接Github的時候會找這個檔案，如果檔案名已定，之後改名也行。在github網站選擇“Account Settings”>>“SSH Public Keys”>>“Add another public key”，將剛纔複製的內容粘貼到key文字方塊內。

這樣就可以直接使用Git和GitHub了。Note：建議在Git Bash中輸入“ssh -v [email protected]”測試能夠正常連接github 安裝Ruby環境 下載RubyInstaller和DevKit。

因爲Octopress需要的Ruby版本爲1.9.2，所以選rubyinstaller-1.9.2-p290.exe,DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe。先安裝RubyInstaller，然後解壓縮DevKit（路徑中不能有中文）。

在“Start Command Prompt with Ruby”命令行中進入DevKit解壓縮的目錄，然後執行以下命令：ruby dk.rb init ruby dk.rb install gem install rdiscount --platform=ruby 如果安裝成功，就可以使用一些Ruby的工具了，也爲後面搭建博客提供了基礎環境。安裝Octopress 先透過Git從Github上克隆一份Octopress（在Git Bash上輸入命令） git clone git://github.com/imathis/octopress.git octopress 然後安裝一些依賴的工具（後面都是在Start Command Prompt with Ruby中輸入） cd octopress ruby --version # Should report Ruby 1.9.2 gem install bundler bundle install 安裝Octopress默認的Theme rake install 配置Octopress 將octopress的檔案夾下的_config.yml的編碼改成UTF-8：儲存（或另存爲）時選擇編碼格式爲UTF-8 修改_config.yml，批改url、title、subtitle、author等等。

到Ruby的安裝目次librubygems1.9.1gemsjekyll-0.11.2libjekyll找到convertible.rb這個檔案，批改self.content = File.read(File.join(base, name)）爲self.content = File.read(File.join(base, name), :encoding => "utf-8"）。寫博文 最簡單的方式：複製octopresssource_posts下某個檔案，例如2012-07-30-the-first-post.markdown，修改檔案名和檔案中的內容 或者，命令行中輸入rake new_post["title"]，會創建一個新的Post，新檔案在source/_post下，檔案名如下面的格式：2012-07-31-title.markdown。

該檔案可以直接開啟修改。寫文章時，可以使用Markdown和Octopress Plugins等工具對內容進行格式排版。

預覽效果 在修改設定或者寫完文章後，想看看具體效果，可以透過如下命令來完成：rake generate rake preview 將博客部署到Github上 在預覽的效果符合自己的預期後，就可以透過如下命令將內容部署到Github上了。如果是第一次部署，需要在Github上創建一個username.github.com的repository 在github網站選擇“Create a New Repo”，如圖 填寫對應的內容即可 note:Repository name填寫username.github.com,username一定要和github的username一致，建好的博客代表的是你這個github帳戶的主頁即page 配置octopress與github的連接：進入Octopress目錄：rake setup_github_pages 按照提示填入你的github項目網址，比如：[email protected]:Username/yourname.github.com.git note：可以按照上面的修改，也可以在github的項目頁中找地址 分發到github上：rake deploy 第一次執行時，會詢問是否建立對github的授權，輸入：yes。

然後將站點更新的內容推送到github上。補充一點：最後的但並不是最重要的，我們需要將修改的日誌同步到github上，因此下面的3個命令也是必須的。

git status git add .git commit -m 'your message' git push origin source 大功告成。