《我為WIKI狂》第11期是講述了看美女，萬人共寫一本書。
基本介紹
- 中文名：《我為WIKI狂》第11期
- 口號：萬人共寫一本書
- 本期維客：看美女
- 含義：Wiki是 model 的名字
我也要加入《我為WIKI狂》，萬人共寫一本書！
[本期維客]看美女
django開發wiki文/ 看美女
下面我們將開始創建 Django 中的 app 了。
先說一下。如果你看過官方版的教程，它就是講述了一個 Poll 的 app 的生成過程。那么一個 app 就是一個功能的集合，它有自已的 model ，view 和相應的模板，還可以帶自已的 urls.py 。那么它也是一個獨立的目錄，這樣一個 app 就可以獨立地進行安裝，你可以把它安裝到其它的 Django 伺服器中去。因此採用 app 的組織形式非常有意義。而且 adango-admin.py 也提供了一個針對 app 的命令，一會我們就會看到。而且 Django 提供一些自動功能也完全是針對於 app 這種結構的。Model, Template, View 就合成了 MTV 這幾個字母。 Model 是用來針對資料庫，同時它可以用來自動生成管理界面， View 在前面我們一直都用它，用來處理請求和回響的相當於MVC框架中的 Controller 的作用， Template 用來生成界面。
Note
在 0.92 版之前， app 都是放在 apps 目錄下的。不過到了 0.92 版，apps 目錄不自動創建了。因此你就可以直接放在項目目錄下了。
這樣在 wiki 子目錄下有以下檔案:
每個 model 其實在 Django 中就是一個表，你將用它來保存數據。在實際的套用中，一般都要與資料庫打交道，如果你不想用資料庫，那么原因可能就是運算元據庫麻煩，創建資料庫環境也麻煩。但通過 Django 的 model 處理，它是一種 ORM (Object Relation Mapping, 對象與關係的映射)，可以禁止掉底層資料庫的細節，同時提供以對象的形式來處理數據。非常方便。而且 Django 的 model 層支持多種資料庫，如果你改變資料庫也不是什麼問題，這也為以後的資料庫遷移帶來好處。總之，好處多多，大家多多體會吧。
Wiki 是 model 的名字，它需要從 models.Model 派生而來。它定義了兩個欄位，一個是欄位是 pagename ， 用來保存 wiki 頁面的名字，它有兩個參數，一個是最大長度(不過從這點上不如 SQLAlchemy 方便, SQLAlchemy並不需要長度，它會根據有無長度自動轉為 TEXT 類型)，目前 CharField 需要這個參數；另一個是 unique 表示這個欄位不能有重複值。還有一個欄位是 content ，用來保存 wiki 頁面的內容，它是一個 TextField 類型，它不需要最大長度。
Note
models.Model 在 0.92 版以前是 meta.Model 。而 django.db 在 0.92 版之前是 django.core 。
現在不太了解 model 沒有關係，關鍵是看整個生成過程。
一旦你定義好了 model ，在運行時， Django 會自動地為這個 model 增加許多數據操作的方法。關於 model 和 資料庫操作API的詳細內容參見 Model reference 和 Database API reference 的文檔。
雖然我們的其它工作沒有做完，但我還是想先安裝一下 app 吧。每個一 app 都需要安裝一下。安裝一般有兩步：
這個在檔案的最後，前4個是預設定義的。給出指定 wiki 包的引用名來。這一步是為了以後方便地導入所必須的。因為我們的目錄都是包的形式，因此這裡就是與目錄相對應的。
如果沒有報錯就是成功了。這一步 Django 將根據 model 的信息在資料庫中創建相應的表。表就是這樣創建出來的。
我們假設首頁的名字為 FrontPage ，並且我們將在命令行下增加它，讓我們熟悉一下命令行的使用
進入 newtest 目錄，然後:
Note
在 Linux 環境下要相應的使用 export 和與你相配置的目錄。
注意 PYTHONPATH 需要設為 newtest 的父目錄，我的 newtest 的全路徑為： d:\test\newtest 。你的可能與我不同，請注意修改。不這樣做不行， manage.py 只是在運行它的時候才起作用，但在命令行下使用 Python 則需要手工設定。你可以把這種設定寫成一個批處理，以後就方便了。
Note
如果使用 NewEdit 來創建 Django 工程，則會自動生成 run.bat 和 run 兩個檔案。分別用於 Windows 和 Linux 平台下設定環境變數。
Note
還可以使用:
來進入命令行，並且不需要設定上面的環境變數。感謝xlp223提醒。
進入 python
Note
因為在寫這篇教程時是在magic-removal分枝下進行的操作，因此有些 API 並不穩定。象 objects 的方法以前是沿用model的方法，但後來進行了簡化，比如 get_list() 變為 all() 。還有一系統的變化。具體的可以參見 Removing The Magic 文檔中關於 Descriptor fields 的說明。
在 Django 中，對於資料庫的記錄有兩種操縱方式，一種是集合方式，一種是對象方式。集合方式相當於表級操作，在新版的 0.92 中可以使用 model.objects 來處理。 objects 對象有一些集合方式的操作，如 all() 會返回全部記錄， filter() 會根據條件返回部分記錄。而象插入新記錄則需要使用記錄方式來操作，些時要直接使用 model 類。
Note
在 0.92 版之前要比這麻煩得多，也不容易理解。好在情況已經發生了變化。
Note
將原來老的 model 方法加了注釋，目前改用最新的 API 了。
代碼有些長，有些地方已經有說明和注釋了。簡單說一下：
Note
filter() 中使用的參數與一般的 db-api 是一樣的，但如果是比較相等，可以為: pagename__exact=pagename 也可以簡化為 pagename=pagename 。
Note
在 Django 中，一些欄位的比較操作比較特殊，它是在欄位名後加 __ 然後是比較條件。這樣看上去就是一個字元串。具體的參見 The Database API 。
Note
回車轉換的工作其實可以在模板中使用 filter 來完成。
因為我們在設計 model 時已經設定了 pagename 必須是唯一的，因此一旦 filter() 有返回值，那它只能有一個元素，而 pages 就是我們想要的對象。
page = wikis.get(pagename='FrontPage')
是表示取出 pagename 為 FrontPage 的頁面。你可能要說，為什麼沒有異常保護，是的，這也就是為什麼我們要在前面先要插條記錄在裡面的原因。這樣就不會出錯了。再加上我要做的 wiki 不提供刪除功能，因此不用擔心會出現異常。
edit() 用來顯示一個編輯頁面，它直接取出一個頁面對象，然後調用 wiki/edit 模板進行顯示。也許你還是要問，為什麼不考慮異常，因為這裡不會出現。為什麼？因為 edit() 只用在已經存在的頁面上，它將用於存在頁面的修改。而對於不存在的頁面是在 index() 中直接調用模板來處理，並沒有直接使用這個 edit() 來處理。也許你認為這樣可能不好，但由於在 edit() 要重新檢索資料庫，而在 index() 已經檢索過一次了，沒有必要再次檢索，因此象我這樣處理??人意見。
save() 用來在編輯頁面時用來保存內容的。它先檢查頁面是否在資料庫中存在，如果不存在則創建一個新的對象，並且保存。注意，在 Django 中，對對象處理之後只有調用它的 save() 方法才可以真正保存到資料庫中去。如果頁面已經存在，則更新頁面的內容。處理之後再重定向到 index() 去顯示這個頁面。
它用來顯示頁面，同時提供一個“編輯”按鈕。當點擊這個按鈕時將調用 view 中的 edit() 方法。
它用來顯示一個編輯頁面，同時提供“保存”按鈕。點擊了保存按鈕之後，會調用 view 中的 save() 方法。
增加了 wiki 等4個 url 映射。
這裡要好好講一講 URL 的設計(個人所見)。
一般一個 wiki ，我們訪問它的一個頁面可能為：wiki/pagename。因此我設計對 index() 方法的調用的 url 為:
也就是把 wiki/後面的解析出來作為 pagename 參數。但這樣就帶來一個問題，如果我想實現 wiki/edit 表示修改， pagename 作為一個參數通過 POST 來提交好象就不行了。因為上面的解析規則會“吃”掉這種情況。因此我採用 Zope 的表示方法：把對象的方法放在對象的後面。我可以把 pagename 看成為一個對象， edit , save 是它的方法，放在它的後面，也簡單，也清晰。當然如果我們加強上面的正則表達式，也可以解析出 wiki/edit 的情況，但那就是你設計的問題了。這裡就是我的設計。
因此 wiki/pagename 就是顯示一個頁面，wiki/pagename/edit 就是編輯這個頁面， wiki/pagename/save 就是保存頁面。而 pagename 解析出來後就是分別與 index() , edit() , save() 的 pagename 參數相對應。
下面你可以運行了。
進入 http://localhost:8000/wiki
首先進入這個頁面：
然後你點編輯，則進入FrontPage的編輯界面：
然後我們加上一個 TestPage ，它符合 wiki 的名字要求，兩個首字母大寫的單詞連在一起。然後點擊保存。
看見了吧。頁面上的 TestPage 有了連結。點擊它將進入：
這是 TestPage 的編輯頁面。讓我們輸入中文，然後輸入 FrontPage 。然後保存。好了，剩下的你來玩吧。點擊 FrontPage 將回到首頁。
－－敬請期待下期《我為WIKI狂》！
加入《我為WIKI狂》賺取我的稿費！
查看《我為WIKI狂》所有精彩內容！
加入《我為Wiki狂》的步驟如下：
1、先加入這個小組，成為我們的一員；
2、寫出你與WIKI的故事，範圍可以很廣，只要牽扯到WIKI都行；或者寫出你對WIKI的認識、使用心得，甚至批評。具體先看這兒，例子請參考這兒；
3、創建幾個屬於你的條目，這個很自由，比如條目可以是百科知識，可以是你的某篇blog，可以是你的原創文章，也可以是日記。如不了解創建規則，請看新手幫助；
4、寫出自我介紹，推銷你自己或者你喜歡的東西。我們的目的是讓每個人都成為作者和明星，並與他人形成交友圈子。在此基礎上大家共創最大的百科全書，共享屬於全人類的知識！
