NTU EDAP 快速導覽
投影片
簡介
因台大電機提供的靜態伺服器實在太過陽春，但網站不大，所以選擇 AJAX + CSV + Markdown 來建置本網站。
優缺點
優點
- 資料庫簡單
- 本網站以
*.csv(Comma-Separated Values，逗號分隔) 文件做為資料庫儲存方式，推薦使用 Excel 編輯。 - 寫網頁超簡單
- 純文字檔案皆使用 Markdown
*.md取代 HTML，易讀性更佳。本網站可能會用到的 Markdown 格式請參考 [Markdown Syntax]({filename}/articles/markdownSyntax.md) - 更新超簡單
- 只要更新各資料庫檔案、透過 FTP 上傳到指定資料夾即可。
缺點
- 速度稍慢
- 因伺服器太笨，所以資料的過濾、輸出、呈獻皆於客戶端 ( 即各電腦、手機上的瀏覽器 ) 完成。每開啟網頁都需經過三步驟 : 下載資料庫、下載程式碼、執行程式碼。會比一般純 HTML 網頁稍慢 ( 但這種網頁應該在西元 2000 年以前就滅絕了... 老師的舊版網站例外 )。
本網站的網頁皆不超過 1MB (包含 html, js, css)，所以速度不會差太多。
檔案類型
注意事項
檔名不支援中文，特殊編碼
因為 Server 設定編碼為當今網路不常使用 Big5 而不是支援較廣的 utf-8。所以上傳時請注意只使用英文檔名。更精確一點，請只使用ASCII來命名檔案。
course 資料夾內的檔案例外，因為很多中文命名的檔案年代久遠，不好更動，所以硬把這些檔名手動轉成big5碼。 好孩子不要學!!
注意檔名大小寫
檔名大小寫視為不相同。例如 si.jpg 和 si.JPG 視為不同，如果打錯會讓 server 抓不到。
CSV 檔 *.csv
為本網站資料庫格式。和其他資料庫常用格式如 SQL, Excel,... 等相比之下，較為輕量化，相同內容下，CSV 體積能少將近一百倍，較利於網站傳輸。
推薦使用 Excel 編輯 CSV
當使用 Excel 編輯 *.csv 並儲存時，須注意可能會跳出以下視窗，請按「是」，才能使用 csv 儲存，否則會使用 Excel 預設格式 *.xlsx 儲存 - 這格式網站可不吃 *.xls 或 *.xlsx 喔。
註意逗點與空格
當使用純文字軟體如記事本編輯 *.csv 時，請注意逗點的左右兩邊並無空格。
Right : abc,aaa
Wrong : abc ,aaa
Wrong : abc, aaa
Wrong : abc , aaa
csv 註解
*.csv中，當一行的開頭為//時，此行為註解，將會被自動跳過。可參考 course_dir.csv
MD 檔 *.md
本網站使用 Markdown 取代 累、煩、討厭的 HTML 。使用最簡單的純文字編輯器如「記事本」即可開啟。Markdown 語法請參考Markdown Syntax(此超連結亦可從網站最下方 Help-Doc : Markdown Syntax進入)。
檔案結構
亂動會爆炸 !!
所有需人為修改的資料都放在 /rapid_content/ 資料夾下。其餘為網站的支架 (frame)，亂動會爆炸!
檔案樹
Course
course_dir.csv - /rapid_content/course/course_dir.csv
設定課程名稱與資料夾
overall_announce.md - /rapid_content/course/overall_announce.md
announce.md - /rapid_content/course/課程資料夾/announce.md
course_image.jpg - /rapid_content/course/課程資料夾/course_image.jpg
做為本門課代表性的圖片，盡量選好看一點的。因為需要適應不同大小的客戶端，所以會視視窗大小裁剪圖片。以圖片的正中央(長1/2，寬1/2)為基準點，刪掉四周多餘部分。
Research Topic
research_topic.csv - /rapid_content/research/research_topic.csv
這大概是整個網站除了 Course 以外最重要的檔案了。為主要研究項目的總設定。
slider_picture
Publication
ieee-list.md - /rapid_content/research/publication/ieee-list.csv
此檔案包含所有 R.-B. Wu 在 IEEE 發表過的 paper。 這檔案須手動從ieee 網站匯出
Member
因為 Server 不支援 Submit 功能，所以實驗室成員資料的製作將透過 Google Form，存檔於 Google Spreadsheet。且設定此 Spreadsheet 為可公開讀取 (public rea) 權限。當然，Write 權限只有我有囉。
Member 須提供的資料包含: 中英文姓名、畢業年份、Email、目前服務機構。方便未來實驗室新舊成員間的聯絡，及彰顯實驗室的威能。
Member 排序方法
特殊身分會置頂: RBWu, Postdoc, 網管。之後依照下列優先順序: 畢業年分(越晚畢業越前) > PhD> Ms> Und(ergraduate)。
Resume
about_edap_at_sidebar.md - /rapid_content/about_edap_at_sidebar.md
側邊欄中關於EDAP LAB的說明。目前是根據電波組
resume.md - /rapid_content/resume.md
Resume Page 中老師的簡介
resume_short_at_homepage.md - /rapid_content/resume_short_at_homepage.md
首頁中老師的簡介，比resume更簡短，
Patent
patent.md - /rapid_content/research/patent/patent.md
額...這應該沒甚麼好說明的，請參考Md 檔案寫法。