changed a year ago
Linked with GitHub
tags: 建北電資網管傳承

網管傳承總論

新版網管傳承文檔已經完成,請前往 serverbook.ckefgisc.org

總論

本筆記由建電一三學術長吳亞倫製作
若有相關疑慮,可以寄信到 aaronwu0218@gmail.com 或是 Discord AaW#2549 詢問

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

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

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

本文件目錄如下:


Github Organization

為了維護社團的所有程式碼,我建立了一個CKEFGISC的 Github 組織帳號。

網址:https://github.com/CKEFGISC
管理員:會交給學術長以及網管

這個地方主要提供給學術放置上課內容,以及網管如果開發新的專案可以放在這邊,也可以用來架設社網或相關網站。
目前有的內容:

  • CKEFGISC.github.io :就是社網的專案庫
  • cms : CMS上機考評測系統的原始碼,是從 https://github.com/erichung09060/cms fork到吳亞倫的github帳號再fork過來的。目前為於伺服器上面的cms系統是接著這個repo。詳情請見CMS 比賽平台管理與使用
  • 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是什麼。

可使用的資源:

另外,在利用github進行共用協作時,可以遵守以下的規則:

  1. 盡量保持main branch的穩定性:
    • 這代表你應該只有確認沒有問題的程式碼才能merge到main裡面
  2. 以個人帳號fork出來之後,再merge回組織帳號
  3. commit message寫清楚,並且詳細寫下這筆commit包含哪一些更新
Select a repo