怎么通過碼云創建自己的博客建立主頁

很多開源項目托管平臺都支持為托管的項目建立主頁,但主頁的維護方式都沒有碼云這么酷。大多數托管平臺無非是開放一個FTP或類似服務,用戶把制作好的網頁或腳本上傳了事,而在碼云用戶通過創建特殊名稱的 Git 版本庫或在 Git 庫中建立特別的分支實現對主頁的維護。

碼云 Pages 是一個免費的靜態網頁托管服務,您可以使用 碼云 Pages 托管博客、項目官網等靜態網頁。如果您使用過 Github Pages 那么您會很快上手使用碼云的 Pages服務。

Jekyll 是一個簡單的博客形態的靜態站點生產機器。它有一個模版目錄,其中包含原始文本格式的文檔,通過 Markdown (或者 Textile) 以及 Liquid 轉化成一個完整的可發布的靜態網站,你可以發布在任何你喜愛的服務器上。Jekyll 也可以運行在 碼云 Pages 上,也就是說,你可以使用碼云的服務來搭建你的項目頁面、博客或者網站,而且是完全免費的。

Jekyll 使用文檔:http://jekyll.bootcss.com/docs/home/

1. 使用前須知

1、項目必須有 index.html 才可以正常訪問

2、靜態網頁的樣式可以自己寫,也可以拿一些靜態模版來修改,Pages服務本身不提供任何形式的模版,但我們后續會陸續增加例子,供大家參考使用。

3、如果你想以根目錄的形式訪問自己的靜態網站,只需要建立一個與自己個性地址同名的項目即可,如 https://gitee.com/ipvb 這個用戶,想要創建一個自己的站點,但不想以子目錄的方式訪問,想以ipvb.oschina.io直接訪問,那么他就可以創建一個名字為ipvb的項目 https://gitee.com/ipvb/ipvb 部署完成后,就可以以 http://ipvb.oschina.io 進行訪問了。

2. 一個小白的 Pages 搭建之旅

A.新建項目 test_pages

點擊創建完成項目的創建

B.添加文件 index.html (注意名稱是index.html哦!)

點擊新建文件

文件名輸入 index.html,內容就是簡單的 html

點擊提交,將文件提交到倉庫

C.選擇 pages 服務

D.選擇需要部署的分支,這里選擇 Master 啟動服務。

E.訪問生成的網站地址,即可以查看你部署的靜態頁面啦!

3. 已經有Pages項目如何部署到碼云的Pages

以jQuery-File-Upload項目為例,項目地址:https://github.com/blueimp/jQuery-File-Upload

它在Github上的Pages地址是:https://blueimp.github.io/jQuery-File-Upload/

如果想把它轉移到碼云Pages,只需要登錄你的碼云賬戶,點擊右上角的 + 號,選擇新建項目

然后點擊創建,項目會在后臺自動導入,導入成功后,點擊菜單欄的 Pages

這里我們默認的Pages服務分支是osc-pages,但是你也已選擇自己靜態頁面所在的分支,這里jQuery-File-Upload項目的靜態頁面分支是gh-pages,選擇gh-pages并點擊啟動服務。

至此,靜態網頁已經部署成功,訪問提供的地址:http://silentboy.oschina.io/jQuery-File-Upload/ 即可查看到jQuery-File-Upload項目的靜態官網。

4. Pages 進階,使用 Jekyll 生成自己的靜態網頁

Jekyll 究竟是什么?

Jekyll 是一個簡單的博客形態的靜態站點生產機器。它有一個模版目錄,其中包含原始文本格式的文檔,通過 Markdown (或者 Textile) 以及 Liquid 轉化成一個完整的可發布的靜態網站,你可以發布在任何你喜愛的服務器上。Jekyll 也可以運行在 碼云Pages上,也就是說,你可以使用碼云的服務來搭建你的項目頁面、博客或者網站,而且是完全免費的。

Jekyll 使用文檔:http://jekyll.bootcss.com/docs/home/

其他幫助:

如何自定義404?

答:在項目根目錄新建 404.html 文件即可。