Usage Guide for Fist Iteration

Setting Up Subversion

1. download Subversion server for Windows at http://subversion.tigris.org/
2. installing Subversion
   • for Subversion 1.4.0, unzip the zip package and put in somewhere you like
   • for example, C:\svn-win32-1.4.0
3. download and install Sunbversion-Python, at http://subversion.tigris.org/ download page, the subversion-python install .exe file can be download at bottom lines.
4. add C:\svn-win32-1.4.0\bin to your Windows PATH environment variable
5. create a repository directory to place all repositories, such as C:\svn-win32-1.4.0\svn-repos

Setting Up Trac

1. download Trac at http://trac.edgewall.org/
2. install Trac as the installing guide says
   • make sure you have installed Python, SQLite, PySQLite, ClearSilver
   • SQLite may not be used, we will use MySQL instead, but need modify dev.cfg setting in WebHat source code.
3. create a directory to put all your trac environments, such as C:\TracEnv
4. add C:\Python24\Scripts\ to your Windows PATH environment variable
   • If your python root directory is not in C:\Python24, you have to replace it
5. change C:\Python24\Scripts\tracd as C:\Python24\Scripts\tracd.py
   • It is recommended that you make a copy of tracd and rename it as tracd.py instead of directly rename tracd as tracd.py
6. change C:\Python24\Scripts\trac-admin as C:\Python24\Scripts\trac-admin.py
   • It is recommended that you make a copy of trac-admin and rename it as trac-admin.py instead of directly rename trac-admin as trac-admin.py

Setting Up WebHat

1. download TurboGears? at http://www.turbogears.org/
   • install TurboGears? as installing guide says
   • download setup file "tgsetup.py" and execute "tgsetup.py" on windows
2. download "Easy Install" at http://peak.telecommunity.com/DevCenter/EasyInstall
   • download setup file "ez_setup.py" and run it to setup environment
3. install PyTextile?, http://wiki.python.org/moin/PyTextile
   • easy_install Textile
4. install TurboTinyMCE, http://cheeseshop.python.org/pypi/TurboTinyMCE/
   • easy_install TurboTinyMce?
5. install MySQL, http://www.mysql.com/
   • please remember you MySQL accout name and password
   • you may open the port 3306 from you firewall setting
6. install MySQL-python, http://sourceforge.net/projects/mysql-python
7. install MySQL GUI Tools, http://www.mysql.com/ (it's optional, for better management of MySQL)
8. install SQLyog, http://webyog.com/en/
9. download TortoisesSVN http://tortoisesvn.tigris.org/ and install it
10. download WebHatTG at svn://colors.ee.ncku.edu.tw/CSHW-Repo
    • or at svn://colors.ee.ncku.edu.tw/CSHW-Repo/trunk/src/first-itreration/WebHatTG(suggest)
    • put WebHat directory in somewhere you like, such as C:\WebHatTG
11. configure WebHat for Subversion and Trac position
    • configure C:\WebHatTG\dev.cfg
      • modify line : sqlobject.dburi="mysql://account:passwd@localhost:3306/webhattg"
      • replace account and passwd with MySQL account and password
    • open C:\WebHatTG\webhattg\subcontrollers\StudentAccountController?.py with your favorite python editor
    • change all SVN_REPOSITORY_ROOT to where you like, such as C:\\svn-win32-1.4.0\\svn-repos
    • change all SVN_TEMPLATES_ROOT to where sou put your templates, such as C:\\svn-win32-1.4.0\\templates
    • change all SVN_REPOSITORY_ROOT_FOR_IMPORT as SVN_REPOSITORY_ROOT except the \\ simbol to /
    • change all SVN_TEMPLATES_ROOT_FOR_IMPORT as SVN_TEMPLATES_ROOT except the \\ simbol to /
    • change all TRAC_ENV_ROOT to where your like, such as C:/TracEnv
    • change all TRAC_TEMPLATE_ROOT to where you install your Trac, normally its in share directory of your python installation, such as C:/Python24/share/trac/templates
    • configure your Tracd position in TRACD_POSITION, such as C:/Python24/Scripts/tracd.py
12. Setting up MySQl tables
    • cd C:\WebHatTG\
    • tg-admin sql sql > sql.txt
    • delete "Using database URI mysql://root:cshw@localhost:3306/webhattg"
    • modify sql.txt, appending some missing ";" in each SQL table creation statement
    • start SQLyog and connect to your running MySQL server
    • create a database called webhattg
    • select the database and select DB -> Import Batch File from MenuBar?
    • import sql.txt that we just created
    • and all the tables needed in webhattg database should be created right now
13. start up WebHat with command : python C:\WebHatTG\start-webhattg.py

New Account Creation with WebHat

1. After starting up WebHat, using your browser to view http://localhost:8080
2. Input Account Name and Password to apply for new account
3. You may have to wait fot about fifteen seconds for the system environment creation operation
4. Atfer the environment is successfully created, success notification page and using guide page will be returned

Visiting Personal Trac

1. now you can visit your personal Trac at http://localhost:8000

Using Subversion

1. the subversion repository can also be accessed via svn://localhost/account-repos