Changes between Version 405 and Version 406 of TracInstall
- Timestamp:
- Mar 18, 2015, 4:47:14 AM (9 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracInstall
v405 v406 92 92 for WikiRestructuredText. 93 93 * [http://pygments.org Pygments] for 94 [ wiki:TracSyntaxColoring syntax highlighting].94 [TracSyntaxColoring syntax highlighting]. 95 95 [http://silvercity.sourceforge.net/ SilverCity] and/or 96 96 [http://gnu.org/software/enscript/enscript.html Enscript] may still be used … … 207 207 A [TracEnvironment Trac environment] is the backend where Trac stores information like wiki pages, tickets, reports, settings, etc. An environment is basically a directory that contains a human-readable [TracIni configuration file], and other files and directories. 208 208 209 A new environment is created using [ wiki:TracAdmin trac-admin]:209 A new environment is created using [TracAdmin trac-admin]: 210 210 {{{#!sh 211 211 $ trac-admin /path/to/myproject initenv … … 240 240 === Running the Standalone Server 241 241 242 After having created a Trac environment, you can easily try the web interface by running the standalone server [ wiki:TracStandalone tracd]:242 After having created a Trac environment, you can easily try the web interface by running the standalone server [TracStandalone tracd]: 243 243 {{{#!sh 244 244 $ tracd --port 8000 /path/to/myproject … … 267 267 268 268 Trac provides various options for connecting to a "real" web server: 269 - [ wiki:TracFastCgi FastCGI]269 - [TracFastCgi FastCGI] 270 270 - [wiki:TracModWSGI mod_wsgi] 271 - [ wiki:TracModPython mod_python]272 - //[ wiki:TracCgi CGI] (should not be used, as the performance is far from optimal)//271 - [TracModPython mod_python] 272 - //[TracCgi CGI] (should not be used, as the performance is far from optimal)// 273 273 274 274 Trac also supports [trac:TracOnWindowsIisAjp AJP] which may be your choice if you want to connect to IIS. Other deployment scenarios are possible: [trac:TracNginxRecipe nginx], [http://projects.unbit.it/uwsgi/wiki/Example#Traconapacheinasub-uri uwsgi], [trac:TracOnWindowsIisIsapi Isapi-wsgi] etc. … … 276 276 ==== Generating the Trac cgi-bin directory #cgi-bin 277 277 278 In order for Trac to function properly with FastCGI you need to have a `trac.fcgi` file and for mod_wsgi a `trac.wsgi` file. These are Python scripts which load the appropriate Python code. They can be generated using the `deploy` option of [ wiki:TracAdmin trac-admin].279 280 There is, however, a bit of a chicken-and-egg problem. The [ wiki:TracAdmin trac-admin] command requires an existing environment to function, but complains if the deploy directory already exists. This is a problem, because environments are often stored in a subdirectory of the deploy. The solution is to do something like this:278 In order for Trac to function properly with FastCGI you need to have a `trac.fcgi` file and for mod_wsgi a `trac.wsgi` file. These are Python scripts which load the appropriate Python code. They can be generated using the `deploy` option of [TracAdmin trac-admin]. 279 280 There is, however, a bit of a chicken-and-egg problem. The [TracAdmin trac-admin] command requires an existing environment to function, but complains if the deploy directory already exists. This is a problem, because environments are often stored in a subdirectory of the deploy. The solution is to do something like this: 281 281 {{{#!sh 282 282 mkdir -p /usr/share/trac/projects/my-project … … 340 340 }}} 341 341 342 Alternatively to aliasing `/trac/chrome/common`, you can tell Trac to generate direct links for those static resources (and only those), using the [[ wiki:TracIni#trac-section| [trac] htdocs_location]] configuration setting:342 Alternatively to aliasing `/trac/chrome/common`, you can tell Trac to generate direct links for those static resources (and only those), using the [[TracIni#trac-section| [trac] htdocs_location]] configuration setting: 343 343 {{{#!ini 344 344 [trac] … … 398 398 Once you have your Trac site up and running, you should be able to create tickets, view the timeline, browse your version control repository if configured, etc. 399 399 400 Keep in mind that //anonymous// (not logged in) users can by default access only a few of the features, in particular they will have a read-only access to the resources. You will need to configure authentication and grant additional [ wiki:TracPermissions permissions] to authenticated users to see the full set of features.400 Keep in mind that //anonymous// (not logged in) users can by default access only a few of the features, in particular they will have a read-only access to the resources. You will need to configure authentication and grant additional [TracPermissions permissions] to authenticated users to see the full set of features. 401 401 402 402 '' Enjoy! ''