每個(gè)真正的程序員，可能都會(huì)夢(mèng)想著能夠發(fā)布開源項(xiàng)目，讓自己的代碼被別人所用。開源項(xiàng)目會(huì)發(fā)布到開發(fā)的版本管理系統(tǒng)（比如GitHub）上面，為了讓大家能夠方便使用你的代碼，項(xiàng)目的目錄結(jié)構(gòu)應(yīng)該遵循一定的規(guī)范。即使不是開源項(xiàng)目，項(xiàng)目目錄結(jié)構(gòu)符合一定的規(guī)范對(duì)你的項(xiàng)目管理也是有好處的。
下面列出python開源項(xiàng)目的通常目錄結(jié)構(gòu)及說明：
.tx/ 如果你使用Transifex進(jìn)行國(guó)際化的翻譯工作，創(chuàng)建此目錄
config Transifex的配置文件
$PROJ_NAME/ 按照你實(shí)際的項(xiàng)目名稱創(chuàng)建目錄。如果有多個(gè)子項(xiàng)目，就創(chuàng)建多個(gè)目錄
docs/ 項(xiàng)目文檔
wiki/ 如果有wiki，可以創(chuàng)建此目錄
scripts/ 項(xiàng)目用到的各種腳本
tests/ 測(cè)試代碼
extras/ 擴(kuò)展，不屬于項(xiàng)目必需的部分，但是與項(xiàng)目相關(guān)的sample、poc等，下面給出4個(gè)例子：
dev_example/
production_example/
test1_poc/
test2_poc/
.gitignore 版本控制文件，現(xiàn)在git比較流行
AUTHORS 作者清單
INSTALL 安裝說明
LICENSE 版權(quán)聲明
MANIFEST.in 裝箱清單文件
MAKEFILE 編譯腳本
README 項(xiàng)目說明文件，其他需要的目錄下也可以放一個(gè)README文件，說明該目錄的內(nèi)容
setup.py python模塊的安裝腳本
這個(gè)目錄結(jié)構(gòu)是針對(duì)python項(xiàng)目的，各種語言習(xí)慣的目錄結(jié)構(gòu)可能不同，但一些基本的要素還是共同的，可以舉一反三。
本人已在github上用Jekyll建立了新的博客：http:///，本站文章會(huì)陸續(xù)遷移過去
|
