yukaii / ics-scheduler

:date: 課表行事曆製作工具

課程行事曆製作工具

一個把學校課表轉成 ics 格式(iCalendar, RFC 5545) 的工具 ❤️。支援各平臺行事曆軟體。

技術方面，本專案前端採用 Bootstrap v4 alpha 以及 jQuery 3。雖然已經 2016，不過做架構簡單的東西，這樣就夠了。

However, it's not the future 😂

支援學校列表

• 臺灣科技大學

更多請自行貢獻或是拍打餵食專案作者 😅

Development

請確定已安裝 Node.js。

本專案採用 brunch 作為建置工具，總之設定檔比 webpack 少寫很多 😆

npm install
npm install brunch -g
brunch watch --server

Build for production

brunch build --production

Troubleshooting

ENFILE: file table overflow

Reference to this issue: karma-runner/karma#1979, run

sudo launchctl limit maxfiles 16384 16384 && ulimit -n 16384

Deployment

本專案使用 Travis CI 做 Continous Deployment，自動部屬到 GitHub Pages 上。更多內容請參考本專案 Wiki

https://github.com/Yukaii/ics-scheduler/wiki/Deployment

Contribution

參照本專案 Wiki 的 Contribution Guide

Credits

本專案改寫自 Neson 四年前的專案 NTUST-ics-Class-Schedule。為了用 GitHub Pages 免費部屬，由 PHP 改為客端 JavaScript 重寫。去掉資料庫，取而代之是純粹的 JSON 檔案儲存。

更多實作細節可參考本專案 wiki Architecture 部分。

License

MIT

ics-scheduler's Issues

找教室功能有問題辣

呃，已知，不過懶的解惹 😆

Incremental crawler build(more scalable architecture)

data 裡面的資料夾不需要在每次 production 都更新，可以看建立時間，兩三天再跑就可以了。

但也要提供一個強制跑的方法，比如設定另一條 crawl 的 branch 也是打上去。

We love GIFs! 一個更好的 Landing Page

2017 年 GIF 動圖重返網頁設計榮耀！

可把 instruction 的圖片換掉。

Error Handling

handle course code not found and show error messages (while still building ics)

Progressive Web App

既然沒有後臺、沒有 Server Side 資料庫了，那做成完全 Client side 的 App 也不為過吧 😆

貼上的課就用 local storage 暫存代碼，反正也就是個界面顯示時間軸罷了（嗆哦）

File Constructor is not a constructor in safari

2ecf057

發現 FileSaver 那邊的 issue 也一直開著 Q__Q 偉哉 Safari。

• eligrey/FileSaver.js#129
• eligrey/FileSaver.js#12
• eligrey/FileSaver.js#215

目前 Safari 需要另外另存成副檔名 ics，再匯入。先這樣好了

Sharable Links

通通放在 url param 就對啦，比如

htts://host/?course_code[ntust][]=CC1234567&course_code[ntust][]=CC1234553

Page on load 在 parse 出來預先填進 textarea，實作起來倒是不難。不過完全 static web hosting 限制就多了，分享頁面在 Open Graph 就別想客製化

Milestone: 更新到 1052

看看是否能在更自動化一些，並且保留舊的選課資料

CS3004301 計算機網路概論的早八時間不見

Custom domain setting

現在的 github page 跑到 https://yukaii.tw/ics-scheduler 底下，有點麻煩啊

看是要調整成 https://ics.yukaii.tw （有點霸氣）或是在另外開一個 Organization 。

related: isaacs/github#547

新增台大的爬蟲及課程資料

然後開學之後找個時間貼文，了無牽掛

Safari invalid date

雖然 Chrome 市佔最高，還是一堆人用 iPhone der

用 moment.js 勢在必行啦 😓

GitHub Rate Limit

自從 GitHub 有了限制之後，就註定本服務不會 scale 😂 ，最多五六間學校了不起了

參見：https://help.github.com/articles/what-is-github-pages/#usage-limits

找空教室

「找空堂」的相反功能，有地方能吃便當還是不錯的 😅

Platform specific guide initialize

用瀏覽器判斷平臺，看哪個 nav tab 要先被 activate

貼上課程資料後直接撈 API

UI 體驗更快，也可以趁機顯示一些額外資訊

1062 開學季

如題，找個時間更新一下

建立 Continuous Deployment 流程

每次 build 要做：

• 爬下最新的 json
• 跑 brunch build task
• 把 public 資料夾推到 gh-pages branch

Auto run Crawler on Travis

• checkout 到一個獨立(orphan)的 branch，抓下來的資料檔放那裡，處裡方式類似 gh-pages
• 另一個 build script，專門讓 travis 跑爬蟲建資料在 orphan branch
• 寫入 raw 的 JSON 要壓成 gzip

Web font!

跟敝站作法一樣即可，可參見：

Yukaii/yukaii.github.io@9c4aa08

Roadmap

Online checklist

• Contribution Guide
  • Crawler specification
  • PR template
  • LICENSE
• Architecture Guide
  • About Travis CI deployment
  • Data Struture
• Multi Platform Guide #9
  • iOS Guide
  • Google Calendar Guide
  • macOS Calendar App Guide

Deprecation of anonymous gist

https://blog.github.com/2018-02-18-deprecation-notice-removing-anonymous-gist-creation/

把 FileSaver 拿回來測試，都過了這麼久了瀏覽器支援應該差不多了

把代碼加到備註

加簽時挺好用的（逃）