Welcome to Toolbuddy Tech Notes!
This blog is made by Jekyll and using Lanyon theme as basic theme. If you have any suggestions or questions about this blog, feel free to contact me.
Please visit: https://toolbuddy.github.io/ to view the site.
_includes/- 網頁區塊元件comment_count.html- DISQUS 元件comments.html- DISQUS 元件head.html-<head>下的內容navbar.html- 預設的側邊目錄sidebar.html- 定義的側邊目錄signature.html- Toolbuddy 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://toolbuddy.github.io查看文章發佈的結果。
- 將文章置於
- 個人簽名檔一律放置於
_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"> Toolbuddy <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">
- 在個人簽名檔中，「姓名」可以取代下方
Toolbuddy，「內容」可以取代下方<div class="intro-message">內的內容。<div class="intro-title"> Toolbuddy <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即是「引入該用戶的簽名檔」。