轉載:在github.io上發佈博客

文章:在github.io上寫博客;因爲版本問題,文章有修改...

可以在github pages上建立你自己的博客。那就從github pages的官網開始吧。

從github pages開始就行了:https://pages.github.com/

按照官網的步驟來吧

1. 首先‘Create a repository’,這裏直接把官網的圖截過來了,注意的是:這個repository的名字叫 “xxx.github.io”,這個xxx就是你賬號的名字。當然下面也可以勾上”Initialize this … README”。

這裏寫圖片描述

2. 到這裏,官網後面就是講讓你‘clone the repository’了,其實這裏你已經有了自己博客網站了,但是沒東西,頂多有個README.md(如果你創建倉庫的時候勾選了”Initialize this … README”)。 可以通過在瀏覽器上輸入’xxx.github.io’訪問你的頁面了。也可以通過Settings看到點端倪。
1

  • 1
  • 2

1

看到上面的對勾了沒,就是這個,而且後面我發現,如果你的這個博客有什麼地方有問題的時候,除了給你發email,還會在這裏顯示出錯誤,不錯的。

3. ok,繼續回到官網上,這裏官網會問你“What git client are you using?”,這是因爲後面你需要把你創建的這個repository clone下來,添加點內容,再commit到github上,那你的github.io上就有東西顯示了。因爲github page寫文章可不太方便,不能直接在網頁上寫文章,要通過上傳md文件的方式寫文章才行。

怎麼clone就不說了,繼續. 現在你clone下來了,添加個文件 index.html,在裏面寫點代碼,就是寫個demo網頁,顯示一行字,證明你的博客網站能行。

<!DOCTYPE html>
<html>
<body>
<h1>Hello World</h1>
<p>I'm hosted with GitHub Pages.</p>
</body>
</html>

PS: 現在把這個文件commit上去吧, 這裏我用的是windows的git,一用還不會用,尷尬。後來琢磨了一下,也記錄一下。

你打開你的客戶端,就像下面這樣

1

看下面是有個“Commit to master”按鈕吧,但是不能點,git是你必須得寫點描述信息才能commit的,也就是在Summary裏面寫點東西,比如說”add the index.html”就可以commit了。但是光commit是不行滴,commit只是提交到你本地了,還得push到你的github上,你的github才能更新(內心崩潰)。你commit完了之後,右上角的“Fetch origin”就會變成”Push origin”了。點一下就行了。再去看你的“xxx.github.io”,就能看到東西了。

1

官網到這裏就完了,但下面還有提示,“Now that you’re up and running, here are a few things you should know”,這裏我就主要注意了下“Blogging with Jekyll”。這是個什麼玩意呢?經過我的研究(Using Jekyll, you can blog using beautiful Markdown syntax),就是讓你寫博客很快樂的一個東西。直接使用MarkDown語法寫就可以了,而不用像上面似的研究html。

而且需要說明的是,這個Jekyll是在你本地運行的。怎麼說呢,也是我安裝完了才知道的。這個東西可以使你在本地修改了文檔,就可以在瀏覽器中看到效果,而不是必須上傳到github上才能看到效果,那樣的話很難過。當然它需要你下載下來用,下面先安上它看看再說吧。

Jekyll

總共分三步
安裝Ruby, 安裝DevKit, 安裝Jekyll

1. 安裝Ruby (之前你可以向下拉看一個DevKit(也在這個頁面),是可以對應Ruby的哪個版本的,你再選擇安裝哪個Ruby)
http://rubyinstaller.org/downloads/
1

注意:新版本直接附帶了DevKit,可以一次性安裝,不過要在安裝過程中記得選取相應選項。

安裝的時候注意下,選上“Add Ruby executables ot your PATH”
1

裝完了,測試一下

1

2. 安裝DevKit
1
下面就跟着做吧,不要問爲什麼,因爲我也不知道,參考文獻1.

》這看着是個.exe文件,其實運行一下竟然是解壓,好吧。我解壓到“C:\DevKit”裏面。
》打開你的cmd


c:
cd DevKit
ruby dk.rb init
notepad config.yml #打開這個文件,這個文件還是很重要的後面也要說它

D:
cd
D:\QT\Ruby24-x64\lib\ruby\site_ruby\2.4.0
ruby devkit.rb init

切換到 安裝目錄 lib\ruby\gems\2.4.0\gems\jekyll-3.8.3\lib\site_template 目錄
notepad _config.yml #打開這個文件,這個文件還是很重要的後面也要說它


在打開的記事本窗口中,於末尾添加新的一行(不包括引號,但是有那個短橫線)
“- C:\Ruby200-x64”

- D:\QT\Ruby24-x64\lib\ruby\site_ruby\2.4.0
(這個就是安裝的Ruby的那個文件夾),保存文件並退出。

注意:不添加路勁,會導致..jekyll 3.8.3 | Error:  Permission denied @ rb_sysopen - C:/Users/wishchin/NTUSER.DAT

3. 安裝Jekyll
先看一下,你gem安裝上了沒

  •  

OK,裝上了,下面裝Jekyll

gem install jekyll
  •  

很簡單,再測一下看裝上了沒

jekyll -v
  •  

1

4. 現在用jekyll創建一個demo項目,感受一波

4.1 在cmd中先cd 到一個目錄,我是E:test文件夾

jekyll new myblog
  •  

1

就在這個文件夾下自動生成了這麼多東西,就感受一波,不忙知道這些東西各個是幹什麼的。
1

4.2 運行這個myblog

jekyll s  或 jekyll serve #這兩個命令都中
  •  

1
這就啓動起來了,看紅框框出來的部分,我們可以在本地瀏覽器中輸入”http://127.0.0.1:4000” 訪問我們的這個myblog了,見下圖。

1

4.2.1 這裏如果4000端口被佔用,就有可能報錯“error:permission denied -bind(2) for 127.0.0.1:4000”,你得把你的端口關了
a. 先找到4000端口被哪個進程佔用了,找到PID值

netstat -aon | findstr "4000"
  •  

b. ctrl+shift+del 打開任務管理器,切到“服務”選項卡,找到PID那個進程,右鍵“停止服務”就OK了。

4.2.2 還有一個注意的地方,也就是在啓動之後,文件夾下面會自動生成一個”_site”文件夾,這個是自動生成的,這裏注意一下,後面還會提。

OK,這就是個demo,大致知道這個jekyll是怎麼用,幹什麼就可以了。那它幹了啥呢,先創建了一個符合jekyll格式的文件夾,裏面自動創建了一些文件,然後啓動起來,就可以在本地瀏覽了。那我們怎麼跟我們的github.io博客聯繫起來呢,這就簡單了,我們先把自己的“xxx.github.io” clone下來,然後把裏面的東西都刪掉,再在這個文件夾裏按照jekyll提供的格式來寫自己的博客,然後將它上傳到github上就可以在xxx.github.io上訪問了。

下面就說一下這個過程。

...............................

接下來請看原文..........

 

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章