Edgewall Software

Changes between Version 33 and Version 34 of TracDev/DevelopmentEnvironmentSetup


Ignore:
Timestamp:
Aug 9, 2011, 9:40:22 PM (13 years ago)
Author:
Thijs Triemstra
Comment:

add markup for commands and env vars

Legend:

Unmodified
Added
Removed
Modified

  • TracDev/DevelopmentEnvironmentSetup

    v33 v34  
    2525}}}
    2626
    27 '''Note:''' I don't create a directory called 'trac' yet. That comes later!  In the meantime, cd (change directory) to your projects directory.
     27'''Note:''' I don't create a directory called 'trac' yet. That comes later!  In the meantime, `cd` (change directory) into your projects directory.
    2828
    2929=== Get Subversion ===
    … …  
    4646 * ActiveState [http://www.activestate.com/activepython/ ActivePython]
    4747
    48 Mac OS X 10.5 and later has Python 2.5 pre-installed.
     48Mac OS X 10.5 and later has Python >= 2.5 pre-installed.
    4949
    5050=== Get easy_install ===
    51 You may already have easy_install if you have "setuptools" installed. Just make sure its version is >= 0.6c10. Previous versions do not work correctly with SVN 1.6.
     51You may already have `easy_install` if you have "setuptools" installed. Just make sure its version is >= 0.6c10. Previous versions do not work correctly with SVN 1.6.
    5252
    53 Otherwise 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:
     53Otherwise 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:
    5454{{{
    5555python ez_setup.py
    … …  
    7575source bin/activate
    7676}}}
    77 or for Windows
     77or for Windows:
    7878{{{
    7979python -m virtualenv trac
    … …  
    8282}}}
    8383
    84 If you have Trac installed in /usr/lib or /usr/local/lib, make sure to run the above virtualenv command with --no-site-packages.
     84If you have Trac installed in `/usr/lib` or `/usr/local/lib`, make sure to run the above virtualenv command with `--no-site-packages`.
    8585
    8686You'll see your command-line prompt has changed.  That means our environment is ready for Trac.
    8787
    8888=== Upgrade Setuptools ===
    89 Just to be sure you have a recent enough version of setuptools you may try to upgrade them (this was necessary on Ubuntu 10.04 Beta). For more options on upgrading packages with easy_install see [http://peak.telecommunity.com/DevCenter/EasyInstall#upgrading-a-package upgrading a package].
     89Just to be sure you have a recent enough version of setuptools you may try to upgrade them (this was necessary on Ubuntu 10.04 Beta). For more options on upgrading packages with `easy_install` see [http://peak.telecommunity.com/DevCenter/EasyInstall#upgrading-a-package upgrading a package].
    9090{{{
    9191easy_install --upgrade setuptools
    … …  
    119119trac-admin test initenv
    120120}}}
    121 '''note:''' Press return for every option.
     121'''Note:''' Press return for every option.
    122122
    123123=== Make anonymous users have full access ===
    … …  
    125125trac-admin test permission add anonymous TRAC_ADMIN
    126126}}}
    127 '''note:''' Don't do this in production!
     127'''Note:''' Don't do this in production!
    128128
    129129=== Installing the tracdeveloperplugin ===
    … …  
    144144}}}
    145145
    146 '''Note''': The -r command puts Trac into refresh mode so your code changes will show up quickly. See also the [TracIni#trac-section auto_reload] trac.ini flag which should be used for the changes in Genshi templates to be picked-up as well.
     146'''Note''': The `-r` command puts Trac into refresh mode so your code changes will show up quickly. See also the [TracIni#trac-section auto_reload] trac.ini flag which should be used for the changes in Genshi templates to be picked-up as well.
    147147
    148 To run tracd or work in the virtual environment, you must switch to the virtual environment each time a new shell is opened.
     148To run `tracd` or work in the virtual environment, you must switch to the virtual environment each time a new shell is opened.
    149149{{{
    150150cd test
    … …  
    153153
    154154=== Debugging Plugins ===
    155 To debug a plugin, install it to your test environment using the command:
     155To debug a plugin, install it into your test environment using the command:
    156156 {{{
    157157 $ python setup.py develop -md /path/to/projenv/plugins
    158158 }}}
    159 If you are experiencing troubles in debugging Trac code, make sure that PYTHONPATH in project properties doesn't contain pointers to other Trac sources. Otherwise those sources will be picked instead of the checked out sources.
     159If you are experiencing troubles in debugging Trac code, make sure that `PYTHONPATH` in project properties doesn't contain pointers to other Trac sources. Otherwise those sources will be picked instead of the checked out sources.
    160160
    161161=== Web stuff ===
    … …  
    169169 * Hit the admin link
    170170 * Logging
    171   - Set type to console
    172   - level to debug
     171  - Set type to `console`
     172  - Set level to `debug`
    173173
    174174=== Alternative frontends ===
    175 To develop on Trac with Apache rather than the standalone tracd, see the [TracDev/AlternativeFrontends alternative frontends] page for information on using Apache with mod_python and mod_wsgi.
     175To develop on Trac with Apache rather than the standalone `tracd`, see the [TracDev/AlternativeFrontends alternative frontends] page for information on using Apache with mod_python and mod_wsgi.