Edgewall Software

Changes between Version 7 and Version 8 of 1.1/TracEnvironment


Ignore:
Timestamp:
May 20, 2015, 7:27:17 AM (4 years ago)
Author:
Ryan J Ollos
Comment:

Move the caveat to the introduction where it is easily spotted by a beginner, and easily dismissed by an experienced user.

Legend:

Unmodified
Added
Removed
Modified
  • 1.1/TracEnvironment

    v7 v8  
    11= The Trac Environment
    22[[TracGuideToc]]
    3 [[PageOutline]]
     3[[PageOutline(2-5)]]
    44
    55Trac uses a directory structure and a database for storing project data. The directory is referred to as the environment.
     
    3030
    3131 - TracPlugins located in a [TracIni#inherit-section shared plugins folder] that is defined in an [TracIni#GlobalConfiguration inherited configuration] are currently not loaded during creation, and hence, if they need to create extra tables for example, you'll need to [TracUpgrade#UpgradetheTracEnvironment upgrade the environment] before being able to use it.
     32
     33{{{#!div style="border: 1pt dotted; margin: 1em"
     34**Caveat:** don't confuse the //Trac environment directory// with the //source code repository directory//.
     35
     36This is a common beginners' mistake.
     37It happens that the structure for a Trac environment is loosely modeled after the Subversion
     38repository directory structure, but those are two disjoint entities and they are not and //must not//
     39be located at the same place.
     40}}}
    3241
    3342== Database Connection Strings
     
    116125  * `site.html` - Method to customize header, footer, and style, described in TracInterfaceCustomization#SiteAppearance.
    117126
    118 === Caveat: don't confuse a ''Trac environment directory'' with the ''source code repository directory'' #Caveat
    119 
    120 This is a common beginners' mistake.
    121 It happens that the structure for a Trac environment is loosely modelled after the Subversion repository directory
    122 structure, but those are two disjoint entities and they are not and ''must not'' be located at the same place.
    123 
    124127----
    125128See also: TracAdmin, TracBackup, TracIni, TracGuide