Changes between Initial Version and Version 1 of TracIni


Ignore:
Timestamp:
Oct 11, 2005, 12:24:32 AM (19 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracIni

    v1 v1  
     1= trac.ini Reference =
     2[[TracGuideToc]]
     3
     4Trac configuration is done by editing the ''trac.ini'' config file, located in {{{<projectenv>/conf/trac.ini}}}.
     5
     6This is a brief reference of available configuration options.
     7
     8== [trac] ==
     9|| `database`        || [wiki:TracEnvironment#DatabaseConnectionStrings Database connection string] for this project ||
     10|| `default_charset` || Charset used in text files in the subversion repository (default is `iso-8859-15`) ||
     11|| `default_handler` || Name of the component that handles requests to the base URL (default is `WikiHandler`) (''since 0.9'') ||
     12|| `repository_dir`  || Path to local Subversion repository ||
     13|| `authz_file`      || Path to Subversion [http://svnbook.red-bean.com/en/1.1/ch06s04.html#svn-ch-6-sect-4.4.2 authorization (authz) file]. ||
     14|| `check_auth_ip` || Whether the IP address of the user should be checked for authentication (true, false) (''since 0.9'') ||
     15|| `ignore_auth_case` || Whether case should be ignored for login names (true, false) (''since 0.9'') ||
     16|| `templates_dir`   || Path to the !ClearSilver templates ||
     17
     18== [project] ==
     19|| `name`   || Project name ||
     20|| `descr`  || Short project description ||
     21|| `url`    || URL to the main project website ||
     22|| `icon`   || URL to icon file to use as shortcut icon (favicon) ||
     23|| `footer` || Page footer text (right-aligned) ||
     24
     25== [header_logo] ==
     26|| `src`    || URL to image to use as header logo ||
     27|| `link`   || Destination URL to link to from header logo ||
     28|| `alt`    || ''alt'' text for header logo ||
     29|| `width`  || Header logo width in pixels ||
     30|| `height` || Header logo height in pixels ||
     31
     32== [logging] ==
     33|| `log_type`  || Logging facility to use. (none, file, stderr, syslog, winlog) ||
     34|| `log_file`  || If ''log_type'' is ''file'', this should be a path to the log-file ||
     35|| `log_level` || Level of verbosity in log (CRITICAL, ERROR, WARN, INFO, DEBUG) ||
     36See also: TracLogging
     37
     38== [attachment] ==
     39|| `max_size` || Maximum allowed file size for ticket and wiki attachments ||
     40
     41== [notification] ==
     42|| `smtp_enabled`   || Enable SMTP (email) notification (true, false) ||
     43|| `smtp_server`    || SMTP server to use for email notifications ||
     44|| `smtp_user`      || Username for SMTP server (''since 0.9'') ||
     45|| `smtp_password`  || Password for SMTP server (''since 0.9'') ||
     46|| `smtp_from`      || Sender address to use in notification emails ||
     47|| `smtp_replyto`   || Reply-To address to use in notification emails ||
     48|| `smtp_always_cc` || Email address(es) to always send notifications to ||
     49|| `always_notify_reporter` || Always send notifications to any address in the ''reporter'' field ||
     50|| `always_notify_owner` || Always send notifications to the ticket owner (''since 0.9'') ||
     51See also: TracNotification
     52
     53== [mimeviewer] ==
     54|| `enscript_path` || Path to the Enscript program ||
     55|| `php_path` || Path to the PHP program ||
     56|| `max_preview_size` || Maximum file size for HTML preview (''since 0.9'') ||
     57|| `tab_width` || Displayed tab width in file preview (''since 0.9'') ||
     58
     59== [ticket] ==
     60|| `default_version`   || Default version for newly created tickets ||
     61|| `default_severity`  || Default severity for newly created tickets ||
     62|| `default_priority`  || Default priority for newly created tickets ||
     63|| `default_milestone` || Default milestone for newly created tickets ||
     64|| `default_component` || Default component for newly created tickets ||
     65|| `restrict_owner`    || Make the owner field of tickets use a drop-down menu (''since 0.9'') ||
     66
     67== [ticket-custom] ==
     68Creates user-defined ticket fields.
     69See TracTicketsCustomFields.
     70
     71== [timeline] ==
     72|| `changeset_show_files` || Number of files to show (-1 for unlimited, 0 to disable) ||
     73|| `default_daysback` || Default "depth" of the Timeline, in days (''since 0.9'') ||
     74
     75== [browser] ==
     76|| `hide_properties` || List of subversion properties to hide from the repository browser (''since 0.9'') ||
     77
     78== [wiki] ==
     79|| `ignore_missing_pages` || enable/disable highlighting CamelCase links to missing pages (''since 0.9'') ||
     80
     81== [disabled_components] ==
     82You can disable any Trac component by listing its name in this section and assigning a truth value (e.g. ''yes''). See the ''Plugins'' page on ''About Trac'' to get the list of active components.
     83(''since 0.9'')
     84
     85----
     86See also: TracGuide, TracAdmin, TracEnvironment