
編程競賽發展多年,難度越來越高,內容越來越複雜,而網上資料大多零散,初學者往往並不知道如何系統地學習相關知識,需要花費大量時間摸索。
為了方便熱愛編程競賽的小伙伴更好地入門,2018 年7 月份, OI Wiki遷移至GitHub。隨著OI Wiki的內容不斷完善,越來越多的小伙伴參與其中。
OI Wiki致力於成為一個免費開放且持續更新的知識整合站點,大家可以在這裡獲取關於編程競賽(competitive programming)有趣又實用的知識,我們為大家準備了競賽中的基礎知識、常見題型、解題思路以及常用工具等內容,幫助大家更快速深入地學習編程競賽。
目前, OI Wiki的內容還有很多不完善的地方,知識點覆蓋不夠全面,存在一些低質量頁面需要修改。 OI Wiki團隊以及參與貢獻的小伙伴們正在積極完善這些內容。
關於上述待完善內容,請參見OI Wiki的Issues 以及迭代計劃。
與此同時, OI Wiki源於社區,提倡知識自由,在未來也絕不會商業化,將始終保持獨立自由的性質。
本項目目前採用MkDocs 部署在oi-wiki.org。
我們在status.oi-wiki.org 維護了一份鏡像站列表,它們的內容和oi-wiki.org 都是相同的。
當然,也可以在本地部署。 (需要安裝Python3 和Pipenv )
如果遇到問題,可以查閱FAQ 來了解更多信息。
git clone https://github.com/OI-wiki/OI-wiki.git --depth=1
cd OI-wiki
# 安装 mkdocs
pipenv install --pypi-mirror https://pypi.tuna.tsinghua.edu.cn/simple/
# 使用我们的自定义主题(Windows 下请使用 Git Bash 执行)
# 安装主题时将连接网络下载资源,可通过以下配置项控制下载链接
# .gitmodules:
# - url
# scripts/pre-build/install-theme-vendor.sh:
# - MATHJAX_URL
# - MATERIAL_ICONS_URL
./scripts/pre-build/install-theme.sh
# 两种方法(选其一即可):
# 1. 运行一个本地服务器,访问 http://127.0.0.1:8000 可以查看效果
pipenv run mkdocs serve -v
# 2. 在 site 文件夹下得到静态页面
pipenv run mkdocs build -v
# 获取 mkdocs 的命令行工具的说明(解释了命令和参数的含义)
pipenv run mkdocs --help我們現在在服務器端渲染MathJax,如果希望實現類似效果,可以參考build.yml。 (需要安裝Node.js)
# Gitee 码云 上的镜像仓库和 GitHub 仓库的内容相同
git clone https://gitee.com/OI-wiki/OI-wiki.git可以使用gh-pages分支的內容
git clone https://gitee.com/OI-wiki/OI-wiki.git -b gh-pages本地啟動一個http 服務器可能會更方便一些。
# 如果是 python3
python3 -m http.server
# 如果是 python2
python2 -m SimpleHTTPServer
# 有些环境下找不到名叫 python3/python2 的可执行文件,不妨运行 python 试试我們非常歡迎你為OI Wiki編寫內容,將自己的所學所得與大家分享。
具體的貢獻方式在如何參與。
除特別註明外,項目中除了代碼部分均採用(Creative Commons BY-SA 4.0) 知識共享署名- 相同方式共享4.0 國際許可協議及附加的The Star And Thank Author License 進行許可。
換言之,使用過程中您可以自由地共享、演繹,但是必須署名、以相同方式共享、分享時沒有附加限制,
而且應該為GitHub 倉庫點贊(Star)。
而如果你想要引用這個GitHub 倉庫,可以使用如下的bibtex:
@misc{oiwiki,
author = {OI Wiki Team},
title = {OI Wiki},
year = {2016},
publisher = {GitHub},
journal = {GitHub Repository},
howpublished = {url{https://github.com/OI-wiki/OI-wiki}},
}
本項目受CTF Wiki 的啟發,在編寫過程中參考了諸多資料,在此一併致謝。
非常感謝一起完善OI Wiki的小伙伴們和為OI Wiki捐贈的朋友們!
特別感謝24OI 的朋友們的大力支持!
感謝北大算協和Hulu 的支持!