• 切換目錄到\Python24\share

  cd \Python24\share
  easy_install http://trac-hacks.org/svn/tracwysiwygplugin/0.10

• 如果你已升級到0.11版，只要把最後面的0.10換成0.11即可
• 以admin進入管理網頁，啟動此插件
• 重新啟動Apache Web Server

• 原來的畫面

• 加入WYSIWYG編輯器後的畫面

=== 專案重要任務 ===
  1. [report:1 處理中的任務單]
  1. [report:7 指派給我的任務單]
  1. [TodoList 待辦事項]
=== 專案文件區 ===
  1. [EventMeeting 會議記錄]
  1. [PlanningDocuments 專案規劃階段]
=== 專案成員一覽表 ===
  1. [OurMembers 乙方成員]
  2. [ClientMembers 甲方成員]
=== 開發環境建置 ===
  1. [attachment:trac-ticket.doc 任務單操作簡要]
  1. [CheckoutSource 取出原始碼及程式開發設定]
  1. [TestAccount 測試帳號]

｛｛｛
#!html
<table border="0"><tr valign="top"><td width="40%">
｝｝｝
=== 專案重要任務 ===
  1. [report:1 處理中的任務單]
  1. [report:7 指派給我的任務單]
  1. [TodoList 待辦事項]
=== 專案文件區 ===
  1. [EventMeeting 會議記錄]
  1. [PlanningDocuments 專案規劃階段]
｛｛｛
#!html
</td><td>
｝｝｝
=== 專案成員一覽表 ===
  1. [OurMembers 乙方成員]
  2. [ClientMembers 甲方成員]
=== 開發環境建置 ===
  1. [attachment:trac-ticket.doc 任務單操作簡要]
  1. [CheckoutSource 取出原始碼及程式開發設定]
  1. [TestAccount 測試帳號]
｛｛｛
#!html
</td></tr></table>
｝｝｝


##

• 專案代碼：trac-tw
• 專案首頁：http://code.google.com/p/trac-tw
• 取出主幹原始檔：svn checkout http://trac-tw.googlecode.com/svn/trunk/ trac-tw
• 取出本日原始檔：svn checkout http://trac-tw.googlecode.com/svn/tags/TAG-20070908 trac-tw
• 直接下載修改過的樣板檔：http://trac-tw.googlecode.com/files/trac_templates.zip
• 版權：New BSD License (原本Trac是採用Modified BSD License，因此我比照使用BSD License，不知是否妥當？)

如果您也有興趣要強化此中文版的翻譯，請寄信給我，我將開啟存取Subversion檔案的帳號給您。對翻譯有建議或意見者，請直接留言在專案的Wiki上，我會盡速回應。

## 

[Fri Aug 24 16:16:46 2007] [error] [client 10.xx.yy.zz] Access denied: 'DOMAIN\\UserId' PROPFIND svn:/trunk/project1/source

圖示覆蓋與狀態欄更新設定

狀態快取設定

• Default

預設的快取設定，使用TSVNCache.exe 來定時掃描檔案系統，找到要變動的檔案後發出更新圖示的通知給作業系統

• Shell

在Shell extension裡，只針對目前所在資料夾做圖示異動更新；只佔用1MB記憶體，但因只快取一個資料夾，當Working copy內容較多時會花較多時間才能更新完畢

• None

不做任何圖示覆蓋快取，因此圖示更新速度較慢

磁碟機類型

• 把A:\*、C:\*、D:\*到Z:\*都加到除外路徑裡，表 示每個磁碟都不做異動掃描
• 再把工作中的Working copy加入包含路徑，如c:\NewProject\*、 d:\NewWD

下載

• GanttProject
• OpenProj

1. 由\Python24\share\trac\templates\取 出Wiki的樣板檔：wiki.cs
2. 搜尋accesskey="e"(在Trac 0.10.4裡是第363行)，在這個標籤上加上id="btnEdit"，給它加上識別ID
3. 再到檔案最後面加上以下JavaScript：

<script>
 document.ondblclick = function() {
 document.getElementById("btnEdit").click();
 }
</script>

• IncludeMacro說明網頁：http://trac-hacks.org/wiki/IncludeMacro
• 安裝步驟：
  cd  \Python24\Scripts
  easy_install   http://trac-hacks.org/svn/includemacro
• 使用admin登入Trac，進入Admin選項並啟動IncludeMacro
• 上一步驟也可在trac.ini的[components] 設定 includemacro.macros.includemacro = enabled

• 格式：[[Include(插入網頁)]]
• "插入網頁"可以是http:、ftp:、wiki:等不同來源
• 可再指定第2個參數指定插入網頁的形態，如x-trac-wiki表示為Wiki形態
• 範例：[[Include(wiki:WikiStart)]]、[[Include(http://YourTrac/SharedWiki.txt, x-trac-wiki)]]

歡迎使用 Trac 0.10.4

通常在某個軟體專案的開發過程中，可能不會耗時費力地為專案建立專屬的網站或網頁，一般只會把原始碼集中在CVS或Subversion上， 問題或待辦事項以Issue/Bug Tracking System來追蹤， 而重要的關於專案的細節與訊息溝通，大都透過當面對話、即時訊息系統(ICQ、MSN Messenger)與電子郵件來達成。在這樣的開發過程中，除了資訊四處散落之外，專案發展過程的重要管理項目與經驗等都無法被有效彙總與整理，導致專 案的細節只有深入專案的參與人員才能有所體會，但隨著時間流逝，這些重要的體驗也將逐漸被遺忘。

1. Trac裡的每一個網頁都能在瀏覽器裡直接編輯，編輯完的每個版本都會被儲存起來，並且能還原到先前版本。
2. 字體變化
   1. 粗體：用三個單引號夾住的文字會變粗體字 '''粗體文字''' ==> 粗體文字
   2. 斜體：用兩個單引號夾住的文字會變斜體字 ''斜體文字'' ==> 斜體文字
   3. 粗斜體：用五個單引號 '''''粗斜體文字''''' ==> 粗斜體文字
   4. 底線：用兩個底線夾住 __底線文字__ ==> 底線文字
   5. 刪除線：用兩個~夾住 ~~刪除文字~~ ==> 刪除文字
   6. 上標字：用^夾住 ^上標文字^ ==> ^上標文字
   7. 下標字：用兩個逗點夾住 ,,下標文字,, ==> _下標文字
3. 常用的超連結(參考TracLinks)
   1. 用駱峰式英文(CamelCase) 表示的文字自動形成超連結，即數個英文字連在一起(中間不能有空白)且每個字的第一個字母大寫，其餘小寫
   2. 以中文表示超連結之格式：用中括號把兩組文字夾起來 [CamelCase 顯示在網頁上的中文超連結] 例：[TracLinks Trac超連結] ==> Trac超連結
   3. 上述第一組文字也可以用網址：[http://blog.xuite.net/emisjerry/tech 簡睿隨筆] ==> 簡睿隨筆
   4. 中文連結可以用 [wiki:中文] 的格式，形成的Wiki網頁就是中文名 稱；用這種形式的網址會較常，但能在Index By Title裡出現易讀的中文連結
   5. 附件的表示方法：[attachment: 附件檔名]，建議用中括號夾起來，attachment: 字樣才不會出現
   6. Subversion檔案的表示方法：[source: Subversion路徑]，建議用中括號夾起來，source: 字樣才不會出現
4. 顯示程式碼原貌：用三個大括號夾住的區塊
5. 圖檔的顯示方法：
   1. 先將圖檔當做附件上傳
   2. 用 [[Image(圖檔檔名)]] 就能顯示圖形
6. 更多的Trac巨集參考：http://trac.edgewall.org/wiki/MacroBazaar
7. Trac的繁體中文術語對照表, 簡體中文術語對照表

學習的最有效方法就是開始使用。請盡情的編輯吧！

Starting Points

• TracGuide -- 內建的使用說明
• Trac 專案 -- Trac開源專案
• Trac FAQ -- 常見問答
• TracSupport -- Trac支援

svn importer能由Polarion Software網站下載，是使用Java撰寫的開源程式。除了能轉CVS 外，常見的Version control system，如PVCS、Visual SourceSafe、ClearCase、StarTeam等，也都能處理。

等做過實際轉換後，再把處理過程登載上來。另外，Polarion另有一個稱做SubTrain的專案，提供了多個Subversion訓練的教材，可由此處下載。

1. 首先由http://www.zentus.com/sqlitejdbc/下載SQLite JDBC Driver，我下載的是Pure Java的版本
2. 下載後把sqlitejdbc-v036-nested.jar複製到ADS安裝目錄的 lib 資料夾裡
3. 【ADS功能表→Server→Register Server】，在RDBMS選項裡選擇Generic - JDBC，在右方Location欄位輸入如下資料：
   • URL: jdbc:sqlite:/c:/trac/專案代碼/trac.db   在最後一個冒號後面指定trac.db的完整路徑，磁碟機代號前後都有正斜線( / )
   • Driver: org.sqlite.JDBC
   • Driver Location: C:\Program Files\ADS\lib\sqlitejdbc-v036-nested.jar
4. 右方最上面的Name給定一個名稱後按OK

1. 安裝Python 2.4.4：http://www.python.org/ftp/python/2.4.4/python-2.4.4.msi
2. 下載簡易安裝程式easy_install.py： http://peak.telecommunity.com/dist/ez_setup.py
3. 執行剛下載回來的ez_setup.py(雙擊即可執行)，會自動下載setuptools.exe, 透過此工具以簡化後續的安裝步驟
4. 安裝ClearSilver：
   

   cd \Python24\scripts easy_install -f http://clearsilver.net/downloads clearsilver==0.9.14

   
   
5. 安裝PySQLite：easy_install pysqlite
6. 安裝Subversion server 
7. 安裝Subversion Python library：easy_install -Z http://subversion.tigris.org/downloads/svn-python-1.4.2.win32-py2.4.exe
   安裝成功會出現"Processing dependencies for svn-python==1.4.2"; 這個步驟會等較久些
8. 安裝Trac 0.10.4：http://ftp.edgewall.com/pub/trac/trac-0.10.4.win32.exe
9. 把trac-admin和tracd少掉的副檔名給加上去：
   

   cd \Python24\scripts ren trac-admin trac-admin.py ren tracd tracd.py

1. 建立Trac環境；在這裡我把Trac裝到C:\trac資料夾
   

   md \trac cd \trac \Python24\Scripts\trac-admin.py \trac\專案代碼 initenv重新啟動Apache

   以上指令中的「專案代碼」會變成網址中的webapp的文件根目錄.。執行後會以問答的方式輸入需要的資料：
   

   Project Name: 專案名稱，可以用中文 Database connection string: db/trac.db  用預設值 Repository type: svnhttp://trac-hacks.org/wiki/ Path to repository: d:\svn 或用UNC寫法Install Templates directory: d:\Python24\share\trac\templates 用預設值重新啟動Apache重新啟動Apache

   開始建檔環境時會出現 "Creating and Initializing Project"，建立檔案後會"Indexing repository", 索引時間視檔案庫大小而定。
   
2. 啟動與測試：以Stand-alone的方式啟動Trac Server
   

   cd \Python24\scripts tracd.py --port 8000 C:\trac\專案代碼

   啟動後在瀏覽器網址輸入 http://localhost:8000/ 或 http://localhost:8000/專案代碼 測試之。
   
3. 建立Trac的管理使用者
   

   cd \Python24\scripts trac-admin.py c:\trac\專案代碼 permission add admin TRAC_ADMIN

   不許匿名用戶使用
   

   cd \Python24\scripts trac-admin.py c:\trac\專案代碼 permission remove anonymous *



4. 安裝Plugins WebAdmin，建立管理網頁：
   

   cd \Python24\scripts easy_install http://svn.edgewall.com/repos/trac/sandbox/webadmin/

   
   
5. 安裝Plugins AccountManager，以方便管理使用者：  

   cd \Python24\scripts easy_install http://trac-hacks.org/svn/accountmanagerplugin/0.10

   
   
6. 安裝Plugins IniAdmin，用網頁設定系統設定檔trac.ini：
   

   cd \Python24\scripts easy_install http://trac-hacks.org/svn/iniadminplugin

   
   

1. 安裝mod_python：由http://apache.stu.edu.tw/httpd/modpython/win/3.2.10/下載，選擇安裝目錄時選C:\Program Files\Apache Group\Apache2，則mod_python.so會被安裝到c:\Program Files\Apache Group\Apache2\modules資料夾
2. 修改 c:\Program Files\Apache Group\Apache2\conf\httpd.conf，找到 LoadModule dav_svn_module "C:/Subversion/bin/mod_dav_svn.so"後，加入 LoadModule python_module modules/mod_python.so
3. 設定網址對應，在httpd.conf最後面加上如下設定：
   

   <Location /trac>       SetHandler mod_python       PythonHandler trac.web.modpython_frontend       PythonOption TracEnvParentDir c:\trac       PythonOption TracUriRoot /trac       AuthType Basic       AuthName "CompanyName"重新啟動Apache       AuthUserFile "D:/Repository/project-users.db"       Require valid-user重新啟動Apache重新啟動Apache </Location>

4. 重新啟動Apache   
5. [/] 根目錄必須開放讀的權限給Trac的使用者，否則在瀏覽原始檔時會出現權限不足的錯誤訊息。

• http://svnbook.red-bean.com/nightly/en/svn.serverconfig.svnserve.html
• TortoiseSVN安裝目錄 bin/TortoiseSVN_en.chm 3.2節

1. 比 對時必須指定檔案濾鏡(File Filter)

2. 【工 具→濾鏡】，在檔案濾鏡頁籤上按新增，給一個新的檔名，例如wwwroot.flt

3. wwwroot.flt內容如下：

   c:\Program files\WinMerge\Filters\wwwroot.flt

   ## This is a directory/file filter template for WinMerge name: wwwroot desc: JSP/JSPF/XML,...   ## Select if filter is inclusive or exclusive ## Inclusive (loose) filter lets through all items not matching rules ## Exclusive filter lets through only items that match to rule ## include or exclude def: include   ## Filters for filenames begin with f: ## Filters for directories begin with d: ## (Inline comments begin with " ##" and extend to the end of the line) ## 以下副檔名的檔案不比對   f: \.bak$ f: \.class$ f: \.~*$   d: \\images$ d: \\WEB-INF\\work$ d: \\web-inf\\work$ d: \\WEB-INF\\classes$ d: \\web-inf\\classes$ d: \\web-inf\\lib$ d: \\WEB-INF\\tmp$ d: \\\.svn$ d: \\CVS$

   include的意思是下列的檔案(f:)與目錄(d:)設定要加入過濾條件裡，符合的檔案不會被比對 f:指定副檔名，因為點(.)是Regular expression的 特殊符號，副檔名的點要用\.來表示；結尾注 意要有Dollar-sign($) d:指定不要比對的目錄，必須以\\開頭，$結尾 \\\.svn前兩個反斜線表示目錄， 第三個反斜線和.構成 .符 號

1. 點選「檔案庫瀏覽器」
2. 選到要操作的目錄處
3. 點選「顯示記錄」，找到刪除的記錄後，將游標停在該記錄
   
4. 將游標移到刪除檔案的前一個版本，即版本61上按右鍵選「瀏覽檔案庫」
   
5. 檔案庫瀏覽器會開啟成一個新的視窗，右上角的版本會顯示在步驟4選取的版本，表示目前瀏覽器使用的是該版本的內容，亦即是版本62，而非最新版本(HEAD)；再用匯出或取出，並將版本改成61(刪除操作的版本減1)，即可把要找到檔案給複製出來了。
   

1. svn2log：使用Python撰寫，雖然其首頁上聲稱Windows也可以執行，但安裝了最新版的Python 2.4.3，仍然出現找不到xml.utils的錯誤，弄了許久仍無法解決，寫信給作者也未接獲回覆，最後只好放棄了
2. svn2cl：原先以為只適用於Linux環境，後來發現已經有人將之移植到Windows環境了：svn2cl-win，Shell script被改寫成了VBScript(svn2cl.vbs)。最終便是採用了這個小工具來產生Change log。

1. 要執行的電腦裡必須安裝SVN Client，並且修改PATH使之能讀到svn.exe
2. 執行svn2cl.vbs的指令是cscript.exe或wscript.exe，預設的PATH裡都能直接執行得到
3. 顯示選項：cscript svn2cl.vbs --help
4. 執行語法：cscript svn2cl.vbs SVN檔案庫的URL 選項
5. 範例：cscript svn2cl.vbs http://mySVNserver.com/svn/trunk/myProject --group-by-day -i --html
6. 加入--html選項便能產生成HTML格式，預設使用的編碼是UTF-8，因此必須先修改做為網頁樣本的svn2html.xsl，將utf-8換成Big5
7. -i指定把Subversion的版本號碼也產生出來
8. 產生出的ChangeLog.html若要拷貝到別的網站供連結，svn2html.css樣式檔必須一起拷貝，網頁樣式才會正確

• bugtraq:append=true表示Bug號碼插入於紀錄訊息的最末端
• bugtraq:number=true表示Bug號碼是數值型態
• bugtraq:message 是Bug號碼的表示字串
• bugtraq:warnifnoissue=true表示Commit時若未輸入Bug號碼則顯示警告視窗，但確定後仍可Commit

1. 檔案庫名稱 (Repository)
2. 要修改的版次 (Revision)
3. 作者名稱 (User)
4. 性質名稱 (Property Name)
5. 操作的動作 (Action)
   

1. 把下載的壓縮檔裡的svnwebclient.war拷貝到AP Server的webapps目錄內（如C:＼Resin＼webapps）
2. 啟動AP Server，待WAR檔都解開後停止AP Server
3. 修改Webapps＼svnwebclient＼WEB-INF＼web.xml，設定各項參數
4. 修改並儲存web.xml後，再新啟動AP Server

• Subversion 1.3:
  • Path-based authorization for svnserve
  • Improved logging and repository listing in mod_dav_svn
  • Hugely improved python and ruby bindings
  • A handful of new commandline switches
  • Some client and server performance improvements
  • Many improved APIs
  • More than 30 new bugfixes
• TortoiseSVN 1.3.0-RC1:

  • TortoiseSVN 1.3 is a superset of all previous TortoiseSVN releases. Anything in 1.0.x, 1.1.x, or 1.2.x is also in 1.3, but 1.3 contains features and bugfixes not present in any earlier release. It is linked with Subversion 1.3.

  • The "_svn" hack is now officially supported: since some versions of ASP.NET don't allow directories beginning with dot (e.g., ".svn", the standard Subversion working copy administrative directory), TortoiseSVN now treats the environment variable SVN_ASP_DOT_NET_HACK specially. If this variable is set (to any value), it will use "_svn" instead of ".svn". Note that once the environment variable is set, working copies with standard ".svn" directories will stop working, and will need to be re-checked-out to get "_svn" instead.

    After you've set the environment variable, you must restart the shell for the changes to take effect.

  • During http:// and https:// transfers, TortoiseSVN now shows information about the transferred data (transfer speed, bytes transferred).

  • TortoiseSVN can now authenticate against apache based repositories with SSPI automatically. That means you don't have to enter username/passwords anymore but TortoiseSVN automatically authenticates with your windows login data.

  • The shell context menu now has key accelerators for better use with the keyboard.
  • The revision graph has been redesigned to make it easier to read, and to show complex branching more reliably.
  • Colours used in TortoiseSVN are configurable in the settings dialog.
  • TortoiseMerge supports sideways scrolling using the keyboard.
  • Many many more small improvements and bug fixes. See the Change Log for full details.

• Commit之前(Pre-commit)自行檢查權限，只有符合者能繼續Commit
• Commit之後(Post-commit)自動寄Mail給特定人員
• Commit之後將異動資訊寫入資料庫，以方便日後查詢

Subversion提供了下列幾種可供自行處理的事件，供自行擴充的檔案稱為Hook scripts(必須是可執行檔，在Windows裡就是副檔名為.bat、.exe、.cmd等的檔案），其範例樣板皆存放於Subversion檔案庫的hooks資料夾裡：

序	事件	功能說明	範例樣板
1	Pre-commit	Commit之前被執行	pre-commit.tmpl
2	Pre-lock	檔案鎖定之前被執行	pre-lock.tmpl
3	Pre-revprop-change	檔案庫被新增、修改或刪除前被執行	pre-revprop-change.tmpl
4	Pre-unlock	檔案解除鎖定之前被執行	pre-unlock.tmpl
5	Post-commit	Commit之後被執行	post-commit.tmpl
6	Post-lock	檔案鎖定之後被執行	post-lock.tmpl
7	Post-revprop-change	檔案庫被新增、修改或刪除後被執行	post-revprop-change.tmpl
8	Post-unlock	檔案解除鎖定之後被執行	post-unlock.tmpl
9	start-commit	異動開始前被執行	start-commit.tmpl

這裡的處理觀念都和CVS類似（可參加我先前寫的這篇：loginfo.rb：自動寄送修改記錄信件），但麻煩的是Subversion只傳出檔案庫路徑和發生異動的Revision序號，其他資料資訊如作者、異動時間、異動檔案、異動內容等，都不會直接傳出來給Hook scripts；看了一些文件和範例程式後，發現這些資訊必須透過\svn-win32-1.2.3\bin\svnlook.exe才能取得，我做了個簡單的測試，檔名是 檔案庫目錄/hooks/post-commit.bat：

指令	說明
set APR_ICONV_PATH=d:\svn-win32-1.2.3\iconv	設定語系Locale
echo %1 %2 >> d:\repo\hooks\post.txt	看Post-commit後傳了那些東西給hook script
echo ---changed: >> d:\repo\hooks\post.txt d:\svn-win32-1.2.3\bin\SVNLOOK changed "%1" "%2" >> d:\repo\hooks\post.txt	把異動檔名寫入post.txt
echo ---date: >> d:\repo\hooks\post.txt d:\svn-win32-1.2.3\bin\SVNLOOK date "%1" "%2" >> d:\repo\hooks\post.txt	把異動時間寫入post.txt
echo ---log: >> d:\repo\hooks\post.txt d:\svn-win32-1.2.3\bin\SVNLOOK log "%1" "%2" >> d:\repo\hooks\post.txt	把commit時輸入的Log訊息寫入post.txt
echo ---author: >> d:\repo\hooks\post.txt d:\svn-win32-1.2.3\bin\SVNLOOK author "%1" "%2" >> d:\repo\hooks\post.txt	把作者寫入post.txt
echo ---youngest: >> d:\repo\hooks\post.txt d:\svn-win32-1.2.3\bin\SVNLOOK youngest "%1" "%2" >> d:\repo\hooks\post.txt	把最後的異動序號寫入post.txt
echo ---diff: >> d:\repo\hooks\post.txt d:\svn-win32-1.2.3\bin\SVNLOOK diff "%1" "%2" >> d:\repo\hooks\post.txt	把差異內容寫入post.txt

最後再寫一支程式去解析post.txt就可以了。嗯，post.txt的檔名還要再加上可分辨的序號才可以，以防止同時有許多人在Commit。

##

##

• JSVN：Java 寫的0.8版，感覺還在初期開發階段，不甚好用
• RapidSVN：C ++寫的，有很多指令功能好會像都還沒做出來
• SmartSVN：SmartCVS 的孿生兄弟，和SmartCVS一樣有中文的問題
• eSVN：用Qt寫的Client，感覺操面與WinCVS較類似，功能也較齊全

• Show History似乎有點問題，好像會Traverse整個Repository tree，造成Loading繁重
• 能顯示Modules，但讀Repository後只出現部份 Modules