https://github.com/sunset1995/coscup2016-website
Source code and built script of COSCUP 2016's website
https://github.com/sunset1995/coscup2016-website
Last synced: about 1 year ago
JSON representation
Source code and built script of COSCUP 2016's website
- Host: GitHub
- URL: https://github.com/sunset1995/coscup2016-website
- Owner: sunset1995
- Created: 2016-05-05T07:06:42.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2016-08-14T04:22:45.000Z (almost 10 years ago)
- Last Synced: 2025-03-18T21:54:24.908Z (over 1 year ago)
- Language: JavaScript
- Size: 7.05 MB
- Stars: 0
- Watchers: 3
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# coscup 2016 website
## TODO
- 建議網頁可以產生 jsonld，[參考](https://github.com/g0v/summit.g0v.tw/blob/2016/jld.js)
- 議程表 filter 作 sticky 版
- 部份文字需要 `text-align: justify;`
- 交通頁面地圖資訊與 RWD 可優化
- 議程表加入 hashtag 開啟某議程的功能
## 環境準備
npm 版本過舊可能會導致之後 build 失敗
[更新 node, npm 參考資料](https://nodejs.org/en/download/package-manager/)
安裝套件管理器至全域
```
npm install -g gulp
```
安裝 build 網頁時會用到的前處理器
```
npm install
```
## Debug
`gulp debug` 會重 build 整個網頁並建制臨時的小型網頁伺服 livereload 修改
``gulp debug`` **不會執行壓縮**
## Build
``gulp`` 會從 build 整個網頁，並關閉 debug mode，壓縮可壓縮的檔案
## Source Code
所有 source code 都位於 ``app/`` 下
#### 文案
* API 撈
* ``app/html/copy/``
* ``app/js/json/``
#### Pages
``app/*.html`` 會被視為各頁面，i.e.
``app/index.html`` -> ``build/index.html``
``app/schedule.html`` -> ``build/schedule.html``
...
#### html
html 拆成多個部份放在資料夾 ``app/html/`` 下，由 ``app/*.html`` include ，可遞迴地 include
include 方式如
```
__@w@include('./html/path_to_source.html')
```
#### scss
所有 ``app/scss/*.scss`` 都會被 build 成 ``build/css/*.css``
要被 import 的 parital 放在 ``app/scss/**/*.scss``
#### javascript & react
所有 ``app/js/*.js`` 都會被 build 成 ``build/js/*.js``
* react component: ``app/js/components/``
* react state: ``app/js/stores/``
* provide function to let UI to change the state/data
* component can regist callback triggering while state change
* no need relarive/absolute path to require module in this folder
* API dataloader: ``app/js/dataloaders/``
* load data from server and format loaded data for front-end used
* no need relarive/absolute path to require module in this folder
* library: ``app/js/lib/``
* third-part library
* self code library
* no need relarive/absolute path to require module in this folder
* static json: ``app/js/json/``
#### favicon
``app/favicon*``
#### image
``app/images/**/*``