原始碼

= 透過 SVN 來取得開發中的程式 =

通常我們開發團隊會把最新的程式、臭蟲修復以及加強的功能放到我們的原始碼管理的系統中，等到累積一定的數量或是依段時間後再打包成新版本釋出。所以如果你想要嚐鮮，或是想瞭解 LifeType 最新的進度，那最簡單的方式就是自行取得我們的原始碼。下面會告訴你如何取得我們原始碼的所有細節。

== LifeType 的原始碼管理系統 SVN ==

LifeType 是透過 [http://subversion.tigris.org/ SVN] 來管理我們的程式碼，他是 [https://www.cvshome.org/ CVS] 的後繼者，透過 SVN 的協助，讓我們全球約 10 個開發者可以協同開發，並且知道大家改了些什麼。目前 LifeType 的 SVN 主機是架設在我們自己的開發主機上 http://devel.lifetype.net 。

== 如何取得 SVN 的客戶端程式 ==

要取得 LifeType 的開發中程式，你必須先要安裝 SVN 的客戶端程式，讓你可以跟我們的 SVN 主機溝通。大部分的 Linux OS 應該都已經包含了 SVN 的客戶端的程式，你應該不需要費心安裝。Windows 的用戶請下載  [http://tortoisesvn.tigris.org/ TortoiseSvn]，這是一個跟檔案總管完全整合的客戶端程式。你可以透過滑鼠的右鍵就完成所有開發程式碼下載的任務。

== LifeType SVN 的目錄結構 ==

LifeType SVN 主要分為三個模組： '''plog''', '''plugins''' 與 '''templates'''，每一個模組底下又分為不同的目錄來儲存程式碼，他們都有相同的結構：

  plog/
    plog/
      trunk/
      branches/
      tags/
    plugins/
      trunk/
      branches/
      tags/
    templates/
      trunk/
      branches/
      tags/

最高一層目錄 '''plog''' 是所有模組的存放的地方。下一層 '''plog''' 模組存放的是我們的核心程式碼， '''plugins''' 存放的是所有的外掛程式，而 '''templates''' 則是存放所有的模版。

每一個模組下面都有這三個目錄：

      trunk/
      branches/
      tags/

*'''trunk''' 是主要的目錄，用來儲存最新的程式版本。所以以此類推 ''plog/trunk'' 存放的就是 LifeType 主程式的最新發展版本。

*'''branches''' 是程式分支的存放目錄，用來存放程式的分支版本。例如 ''plog/branches/plog-1.0.1'' 存放的就是 1.0.1 的這個版本的分支。放在這裡的程式，並不會影響到存放在 trunk 中的程式。通常等到穩定後，都會再合併回 trunk 這個程式目錄。

*'''tags''' 當新版 release 時候，我們會在 tags 建立一個標籤，用來存放這一個釋出的版本。為什麼樣這樣呢？因為有了標籤的協助，我們可以容易取回任何一個 LifeType 開發團隊所釋出的版本。

== 取出 LifeType 的程式碼 Check Out ==

=== Linux OS 下的操作方式===

我們可以使用 SVN 的命列列客戶端程式來取出 LifeType 最新的開發程式 ''/plog/trunk''：

  svn checkout http://devel.lifetype.net/svn/plog/plog/trunk

如果你想要取出特定的版本或標籤，如 0.32 版，你可以把 ''/trunk'' 換成 ''/branch/branch-name'' or ''/tags/tag-name'':

  svn checkout http://devel.lifetype.net/svn/plog/plog/tags /plog-0.3.2

目前的 ''/tags'' 中包含了所有正式釋出的版本，所以你可以自行下載。

請特別注意，當執行 ''svn checkout'' 時，SVN 命列列程式會在你的目前目錄建立相關的原始碼程式目錄，然後把程式下載到相關的目錄中。

=== Windows 下 Tortoise SVN 客戶端的操作方式 ===

#請自 http://tortoisesvn.tigris.org/ 下載 Tortoise SVN 客戶端程式，並且到這裡下載 [http://sourceforge.net/project/showfiles.php?group_id=138498&package_id=158749 中文語系]。
#參考 [http://www.lifetype.org.tw/tutor/svn/TortoiseSVN-Installation.html TortoiseSVN 安裝教學影片] 來安裝 TortoiseSVN 到你的電腦上。
#安裝好後請到你的檔案總管下面開一個新的目錄假設是 D:/LifeType 。
#到此目錄中，按下滑鼠右鍵選擇『SVN 取出』。 
#此時會跳出一個對話框，在『檔案庫的 URL』 中打入 http://devel.lifetype.net/svn/plog/plog/trunk ，SVN 此時 Tortoise SVN 客戶端程式就會自動幫你把最新的程式 Check Out 下來。 
#同理， 開一個新的目錄 D:/Plugins。然後檔案庫 URL 為 http://devel.lifetype.net/svn/plog/plugins/trunk
#我們可以取出任何一個正式發佈（釋出）的版本：如果你想要取出特定的版本或標籤，如 0.32 版，你可以開一個新的目錄 D:/plog0.3.2。然後把 URL中的 ''/trunk'' 換成 ''/branch/branch-name'' or ''/tags/tag-name''，例如: ''http://devel.lifetype.net/svn/plog/plog/tags/plog-0.3.2'' 。目前的 /tags 中包含了所有正式發佈的版本，所以你可以自己下載。

== 更新 LifeType 的程式碼 Update ==

=== Linux OS 下的操作方式===

到你原來下載 LifeType 的程式目錄中，我們使用 SVN 的命列列客戶端程式來更新程式：

  svn update

=== Windows 下 Tortoise SVN 客戶端的操作方式 ===

#打開檔案總管，到你原來下載 LifeType 的程式目錄中
#到此目錄中，按下滑鼠右鍵選擇『SVN 更新』就可以了。 

注意！SVN 客戶端程式會開始把最新的程式碼合併到原來的目錄中。假設你的目錄內的程式已經經過了某些修改，SVN 客戶端程式將會保留你原來的修改而不作任何更新。