---
title: 總論 | 建北電資網管傳承
image: https://hackmd.io/_uploads/rJpAHerNn.png
---
###### tags: `建北電資網管傳承`
# 網管傳承總論
:::success
新版網管傳承文檔已經完成，請前往 serverbook.ckefgisc.org
:::
## 總論
:::info
本筆記由建電一三學術長吳亞倫製作
若有相關疑慮，可以寄信到 [[e-mail]](mailto:[e-mail]) 或是 Discord `AaW#2549` 詢問
:::

這一篇筆記，是 AaW 為了傳承所有一三曾經管理的網路相關服務所寫的（類）技術文件。

在本文當中，我們主要針對社網、ISCOJ伺服器、以及其他相關我們所做的事情做傳承。不過，由於也是我們第一次撰寫如此巨大的傳承文件，因此難免有一些缺漏或不清楚之處。學弟妹如有需要可以向我詢問或是協助我們補齊不清楚之處。

本文章中，所有頁面（除了 AaW 留給學弟妹的話）都開放你們編輯，希望此文件可以一路傳承下去。

本文件目錄如下：
- 總論
- [總論](/M-RzBUTfTE-B7NKVwS4U-g)
- Github Organization
- [常用linux指令](/ZIm4rl7HQcO9Q7un-9y2qA)：linux指令列表 aka 你們應該要背熟的那些指令
- [AaW 留給學弟妹的話](/fIQYymYNQeCh_JFnqAJDGg)：我的真心話與經驗談
- 伺服器導論
- [伺服器總論](/GlR4UyRPSZ6mVK_pPTXwjg)：關於伺服器的概論內容以及 ISCOJ 伺服器現況
- [Docker](/RKR-dyxyTuq5wFDuUwFQWg)：Docker 使用簡介以及一點點的教學
- [ISCOJ](/-lloL9MSTautzUUFW-5M2w)：ISCOJ（青島OJ）現況
- [CMS](/SngEqSHATySgeTG8j312Gg)：CMS比賽系統
- [其他東西](/YOyqT-g1TeuosQFvleMx8g)：TIOJ 以及 OJDL
- 社網
- [社網](/nKmJOjYOS7m7U3ti4X1_bw)：就社網
- [網域](/teXL3b9tSuKdxjgOa5sJrA)：ckefgisc.org 以及 ckeisc.org 的管理
- [關於SEO的那檔事](/Hyr0z1DBTfSJMaodFyFMIw)(未完工)
- [回家練習](/tbi1vEQPT4CyrQ5jQN77cQ)
- 參考資料

---

## Github Organization

為了維護社團的所有程式碼，我建立了一個CKEFGISC的 Github 組織帳號。
:::info
網址：https://github.com/CKEFGISC
管理員：會交給學術長以及網管
:::
這個地方主要提供給學術放置上課內容，以及網管如果開發新的專案可以放在這邊，也可以用來架設社網或相關網站。
目前有的內容：
- `CKEFGISC.github.io` ：就是社網的專案庫
- `cms` : CMS上機考評測系統的原始碼，是從 https://github.com/erichung09060/cms fork到吳亞倫的github帳號再fork過來的。目前為於伺服器上面的cms系統是接著這個repo。詳情請見[CMS 比賽平台管理與使用](/SngEqSHATySgeTG8j312Gg)
- `cms-ranking-archiver`：用來把cms上面的計分板內容抓下來變成靜態網頁。使用方式請見[CMS 比賽平台管理與使用]()
- `CKEFGISC-Linked-List`：之前專案小社的內容
- `.github`：好像可以拿來寫組織的介紹之類的
- `translation`：從IOI抓來的東東，還不知道有什麼用

基本上，所有github的設定你們都可以亂動，if你知道自己在做什麼。只要注意不要不小心把東西刪掉就好。

### Git
這邊我想要再花一小段篇幅講一下git的使用。

首先，如果你還不會用git，我建議你一定要花時間把他學會，尤其網管對於git必須要十分熟悉。如果你覺得你對於指令式介面不熟，可以使用github desktop等等圖形化介面沒關係。

而最基本的，你要能夠理解add、commit、push、fetch、pull這些操作，並且能夠理解 branch、fork、merge和pull request是什麼。

可使用的資源：
* https://ithelp.ithome.com.tw/articles/10193391
* https://github.com/twtrubiks/Git-Tutorials
* https://b0444135.medium.com/github-%E6%95%99%E5%AD%B8%E9%81%A9%E7%94%A8%E6%96%BC%E5%B0%8F%E5%9E%8B%E5%8D%94%E4%BD%9C%E5%B0%88%E6%A1%88-cd471733104a
* https://slides.com/aaw/github_pages/

另外，在利用github進行共用協作時，可以遵守以下的規則：
1. 盡量保持main branch的穩定性：
- 這代表你應該只有確認沒有問題的程式碼才能merge到main裡面
2. 以個人帳號fork出來之後，再merge回組織帳號
3. commit message寫清楚，並且詳細寫下這筆commit包含哪一些更新