Changes between Initial Version and Version 1 of TracDev/DevelopmentEnvironmentSetup

Timestamp:

Mar 17, 2008, 12:47:46 AM (16 years ago)

Author:

Daniel Greenfeld <pydanny@…>

Comment:

Not yet tested!

TracDev/DevelopmentEnvironmentSetup

@@ +1 @@
+= Developer setup for Trac =
+This tutorial assumes you have SVN installed.  If you don't please go to the [http://subversion.tigris.org/ Subversion] website and follow the directions of installation there.
+
+== Setting up the environment ==
+Before we begin to develop in Trac, or even download Trac code, lets create a standalone environment.
+
+=== Create a working directory ===
+No matter my operating system, I like to create a projects or working directory for my development efforts.  So for example on some systems, I might have:
+{{{
+/Users/myname/projects
+}}}
+On Windows I would have:
+{{{
+c:\projects
+}}}
+
+'''Note:''' I don't create a directory called 'trac' yet. That comes later!  In the meantime, cd (change directory) to your projects directory.
+
+=== Get easy_install ===
+Go to [http://peak.telecommunity.com/DevCenter/EasyInstall#installing-easy-install installing-easy-install] and follow the instructions there.  However, most of the time you just take the text at [http://peak.telecommunity.com/dist/ez_setup.py ez_setup.py], save it as ez_setup.py on your hard drive, then from the command-line prompt type:
+{{{
+python ez_setup.py
+}}}
+
+=== Get virtual env ===
+From the command-line prompt type:
+{{{
+easy_install virtualenv
+}}}
+
+=== Set up a virtual environment ===
+From the command-line prompt type:
+{{{
+virtualenv trac
+cd trac
+source bin/activate
+}}}
+
+You'll see your command-line prompt has changed.  That means our environment is ready for Trac.
+ 
+=== Downloading trac ===
+From the command-line prompt:
+{{{
+svn co http://svn.edgewall.org/repos/trac/trunk/ trac-trunk
+svn co http://svn.edgewall.org/repos/genshi/trunk/ genshi-trunk
+cd trac-trunk
+python setup.py develop 
+cd ../genshi-trunk
+python setup.py develop
+cd ..
+}}}
+
+=== Creating your test trac environment ===
+From the command-line prompt:
+{{{
+trac-admin test initenv
+... abount installation
+trac-admin test permission add anonymous TRAC_ADMIN
+}}}
+
+=== Installing the trackdeveloperplugin ===
+From the command-line prompt:
+{{{
+svn co http://trac-hacks.org/svn/tracdeveloperplugin/trunk/ tracdeveloperplugin
+cd tracdeveloperplugin
+python setup.py bdist_egg
+cp dist/*.egg ../test/plugins
+cd ..
+}}}
+
+=== Starting trac in development mode ===
+From the command-line prompt:
+{{{
+tracd -r --port 8000 test
+}}}
+
+'''note''': The -r command puts Trac into refresh mode so your code changes will show up quickly.
+
+
+
+=== Web stuff ===
+Switch to your browser and go to this URL:
+
+http://127.0.0.1:8000/test 
+
+Now lets follow a few more steps
+
+ * Go to web admin
+ * Hit the admin link
+ * Logging
+  - Set type to console
+  - level to debug