This website is managed by NCKU ACM Training Course Team.
_includes/- 網頁區塊元件comment_count.html- DISQUS 元件comments.html- DISQUS 元件head.html-<head>下的內容navbar.html- 預設的側邊目錄sidebar.html- 定義的側邊目錄signature.html- NCKUACM Training Team 的簽名檔yungshenglu.html- 成員 Yung-Sheng Lu 的簽名檔
_layouts/- 網頁版面,由_include/下的區塊所構成default.html- 預設版面page.html- 其他版面post.html- 文章版面tag_index.html- 標籤集合下的文章列表版面
_plugins/- 網頁插件tag_gen.rb/- 生成文章的標籤
_posts/- 發佈的文章fonts/- 存放使用的字型public/- 存放圖片、CSS 檔案slides/- 存放投影片檔案tags/- 存放生成的文章分類標籤 (不需手動更新)temp_posts/- 存放尚未發佈的文章_config.yml- 定義 Jekyll 的參數與共用變數atom.xml404.htmlabout.mdarchieve.mdindex.htmlrobots.txtsitemap.xml
-
在
temp_posts/或是_posts/下建立新的文章檔案,檔案名稱可以參考過去文章的各式 (_posts/下的檔案),檔名規定如下:YYYY-MM-DD-檔名.md。 -
在文章內,請務必複製以下表頭參數,可以參考
_posts/下的檔案。範例如下:--- layout : post title : "UVA-696 - How Many Knights" subtitle : "UVa Online Judge" date : 2018-04-08 18:00:00 author : "Yung-Sheng Lu" tags : OnlineJudge UVa Math comments : true signature : true slides : present : github : link : ---layout- 文章版面格式- 預設:
post - 格式:使用預設值
post
- 預設:
title- 文章標題- 預設:必填欄位
- 格式:任意值
subtitle- 文章副標題- 預設:必填欄位
- 格式:任意值
date- 文章發佈日期與時間- 預設:必填欄位
- 格式:
YYYY-MM-DD HH:MM:SS
author- 文章作者 (註:如何新增個人簽名檔?)- 預設:
NCKUACM Training Team - 格式:任意值
- 預設:
tags- 文章分類標籤- 預設:空值
- 格式:以「空格」切段作為文章標籤
comments- 是否允許文章開啟評論- 預設:
true - 格式:
true/false
- 預設:
signature- 是否嵌入作者簽名檔 (註:如何新增個人簽名檔?)- 預設:
true - 格式:
true/false
- 預設:
slides- 投影片連結- 預設:空值
- 格式:
https://yungshenglu.github.io/slides/投影片檔名
present- 投影片 LIVE 連結 (雲端投影片使用,如:Google Slides、Slides 等)- 預設:空值
- 格式:連結網址
github- GitHub 連結- 預設:空值
- 格式:連結網址
link- 外部連結- 預設:空值
- 格式:連結網址
-
文章內容以 Markdown 語言,其中數學格式請參照 MathJax,可以參考
_posts/下的文章。
- 文章發佈務必在「文章發佈時間」之後,亦即:「不要發佈未來時間的文章」,可能會發生錯誤。
- 撰寫文章完畢後,若要發佈文章,請將文章置於
_posts/下,檔名規定如下:YYYY-MM-DD-檔名.md;若還不想發佈文章,則可以置於temp_posts/下。 - 文章發佈流程:
- 將文章置於
_posts/下,檔名規定如下:YYYY-MM-DD-檔名.md。 - 開啟終端機 (terminal) 並移至此專案資料夾下。
- 移除現有的
_tags資料夾。$ rm -r tags/
- 編譯此專案
$ Jekyll build
- 將新生成的
_site/下的_tags/搬移到此專案的最上層,亦即:和_site同一層。 - 透過 GitHub 更新本次更動專案的部分
$ git add . $ git commit -m "Update latest post" $ git push origin master
- 發布成功,可以稍等約 1 ~ 2 分鐘,至
https://nckuacm.github.io/nckuacm_notes/查看文章發佈的結果。
- 將文章置於
- 個人簽名檔一律放置於
_includes/下,檔案命名可以取自己的名字縮寫 (建議:與簽名檔照片的檔名相同),並以.html格式命名。 - 個人簽名檔格式可以
_includes/signature.html作為範本撰寫。<div class="message"> <!-- Signature Image --> <img class="profile" src="{{ site.baseurl }}public/nckuacm.png" alt="profile-image"> <!-- Signature Content --> <div class="intro-title"> NCKU ACM Training Team <div class="intro-message"> This course is designed for ACM contest training in National Cheng Kung University. </div> </div> </div>
- 個人簽名檔的照片檔案請放置於
public/下,檔案命名可以取自己的名字縮寫 (建議:與簽名檔的檔名相同),照片大小務必為「正方形」。 - 在個人簽名檔中,個人照片的路徑需要在下方的
src中{{ site.baseurl }}public/之後接上個人照片檔名。<img class="profile" src="{{ site.baseurl }}public/nckuacm.png" alt="profile-image">
- 在個人簽名檔中,「姓名」可以取代下方
NCKU ACM Training Team,「內容」可以取代下方<div class="intro-message">內的內容。<div class="intro-title"> NCKU ACM Training Team <div class="intro-message"> This course is designed for ACM contest training in National Cheng Kung University. </div> </div>
- 個人簽名檔的照片檔案請放置於
- 完成個人簽名檔後,可以在
_layouts/post.html中<!-- Member Signature -->之後新增以下片段:{% if page.author == "Author Name" %} {% include author_name.html %} {% endif %}page.author後要判斷「是否符合用戶的名字」(即:Author Name),其中這個名稱即為「之後用戶發佈文章所用的名字」。author_name.html即是「引入該用戶的簽名檔」。
