The Trac Configuration File
Indice dei contenuti
Trac is configured through the trac.ini file, located in the <projectenv>/conf directory. The trac.ini configuration file and its parent directory should be writable by the web server.
Trac monitors the timestamp of the file to trigger an environment reload when the timestamp changes. Most changes to the configuration will be reflected immediately, though changes to the [components] or [logging] sections will require restarting the web server. You may also need to restart the web server after creating a global configuration file when none was previously present.
Global Configuration
Configuration can be shared among environments using one or more global configuration files. Options in the global configuration will be merged with the environment-specific options, with local options overriding global options. The global configuration file is specified as follows:
[inherit] file = /path/to/global/trac.ini
Multiple files can be specified using a comma-separated list. Non-absolute paths are relative to the Environment conf directory.
Note that you can also specify a global option file when creating a new project, by adding the option --inherit=/path/to/global/trac.ini to trac-admin's initenv command. If you specify --inherit but nevertheless intend to use a global option file with your new environment, you will have to go through the newly generated conf/trac.ini file and delete the entries that will otherwise override those in the global file.
There are three more options in the [inherit] section, templates_dir for sharing global templates, htdocs_dir for sharing global htdocs and plugins_dir, for sharing plugins. Those options can be specified in the shared configuration file, and in fact, configuration files can even be chained if you specify another [inherit] file there.
Note that the templates found in the templates/ directory of the TracEnvironment have precedence over those found in [inherit] templates_dir. In turn, the latter have precedence over the installed templates, so be careful about what you put there. Notably, if you override a default template, refresh your modifications when you upgrade to a new version of Trac. The preferred way to perform TracInterfaceCustomization is to write a custom plugin doing an appropriate ITemplateStreamFilter transformation.
Reference for settings
This is a reference of available configuration options, and their default settings.
Documentation improvements should be discussed on the trac-dev mailing list or described in a ticket. Even better, submit a patch against the docstrings in the code.
[account-manager]
account_changes_notify_addresses | Email addresses to notify on account created, password changed and account deleted. | (nessun default) |
allow_delete_account | Allow users to delete their own account. | enabled |
auth_init | Launch an initial Trac authentication setup. | enabled |
cookie_refresh_pct | Persistent sessions randomly get a new session cookie ID with likelihood in percent per work hour given here (zero equals to never) to decrease vulnerability of long-lasting sessions. | 10 |
db_htdigest_realm | Realm to select relevant htdigest db entries | (nessun default) |
environ_auth_overwrite | Whether environment variable REMOTE_USER should get overwritten after processing login form input. Otherwise it will only be set, if unset at the time of authentication. | enabled |
force_passwd_change | Force the user to change password when it's reset. | enabled |
generated_password_length | Length of the randomly-generated passwords created when resetting the password for an account. | 8 |
htdigest_file | Path relative to Trac environment or full host machine path to password file | (nessun default) |
htdigest_realm | Realm to select relevant htdigest file entries | (nessun default) |
notify_actions | Comma separated list of notification actions. Available actions are 'new', 'change', 'delete'. | (nessun default) |
password_store | Ordered list of password stores, queried in turn. | (nessun default) |
persistent_sessions | Allow the user to be remembered across sessions without needing to re-authenticate. This is, user checks a "Remember Me" checkbox and, next time he visits the site, he'll be remembered. | disabled |
refresh_passwd | Re-set passwords on successful authentication. This is most useful to move users to a new password store or enforce new store configuration (i.e. changed hash type), but should be disabled/unset otherwise. | disabled |
register_check | Ordered list of IAccountRegistrationInspector's to use for registration checks. | BasicCheck,EmailCheck,BotTrapCheck,RegExpCheck,UsernamePermCheck |
reset_password | Set to False, if there is no email system setup. | enabled |
username_char_blacklist | Always exclude some special characters from usernames. This is enforced upon new user registration. | :[] |
[attachment]
max_size | Dimensione massima consentita (in byte) per gli allegati. | 262144 |
max_zip_size |
Maximum allowed total size (in bytes) for an attachment list to be
downloadable as a | 2097152 |
render_unsafe_content | Se i file allegati debbano essere visualizzati nel browser, piuttosto che solo tramite scaricamento. Dal momento che praticamente qualsiasi file può essere interpretato come HTML dal browser, un malintenzionato potrebbe allegare un file contenente uno script che implementa un attacco "cross-site". Per siti pubblici dove utenti anonimi possono allegare un file, si raccomanda di lasciare questa opzione disabilitata. | disabled |
[browser]
color_scale | Abilita la colorazione della colonna età. Viene utilizzata la stessa scala di colori usata nelle visualizzazione delle annotazioni del codice sorgente: il blu indica cose più vecchie, il rosso cose recenti. | enabled |
downloadable_paths | Lista dei percorsi del repository che possono essere scaricati. Lascia questa opzione vuota se vuoi disabilitare la funzionalità, altrimenti impostala a una lista di percorsi consentiti (vengono interpretati come pattern glob, cioè "*" può essere usato come jolly), separati da virgole. In un ambiente multi-repository il percorso deve essere qualificato con il nome del repository se non si riferisce al repository di default (ad esempio /nomerepo/trunk). Nota che viene applicata una semplice verifica del prefisso, quindi gli eventuali alias non vengono considerati automaticamente. | /trunk,/branches/*,/tags/* |
hide_properties | Lista di proprietà del sistema di versionamento, separate da virgole, che devono essere nascoste dal visualizzatore del repository. | svk:merge |
intermediate_color |
Tripla (r,g,b) per indicare il colore intermedio, quando vengono
usate due interpolazioni lineari per stabilire la scala di colori
(vedi | (nessun default) |
intermediate_point |
Se impostato a un valore tra 0 e 1 (esclusi), verrà usato per
stabilire l' | (nessun default) |
newest_color |
Tripla (r,g,b) per indicare il colore usato per le cose più
recenti, nella scala colori usata nelle annotazioni o
nella colonna età se l'opzione | (255, 136, 136) |
oldest_color |
Tripla (r,g,b) per indicare il colore usato le cose più
vecchie, nella scala colori usata nelle annotazioni o
nella colonna età se l'opzione | (136, 136, 255) |
oneliner_properties | Lista di proprietà del sistema di versionamento, separate da virgole, da mostrare come contenuto wiki a singola riga nel visualizzatore del repository. | trac:summary |
render_unsafe_content | Se i file grezzi debbano essere visualizzati nel browser, piuttosto che solo tramite scaricamento. Dal momento che praticamente qualsiasi file può essere interpretato come HTML dal browser, un malintenzionato potrebbe creare un file contenente uno script che implementa un attacco "cross-site". Per repository aperti dove chiunque può inserire un file, si raccomanda di lasciare questa opzione disabilitata. | disabled |
wiki_properties | Lista di proprietà del sistema di versionamento, separate da virgole, da mostrare come contenuto wiki nel visualizzatore del repository. | trac:description |
[changeset]
max_diff_bytes | Dimensione massima totale in byte dei file modificati (dimensione precedente più dimensione attuale) per cui la vista del changeset cercherà di mostrare le differenze in linea. | 10000000 |
max_diff_files | Numero massimo di file modificati per cui la vista del changeset cercherà di mostrare le differenze in linea. | 0 |
wiki_format_messages | Se i messaggi nei changeset debbano essere interpretati come formattazione wiki. Se questa opzione è disabilitata, i messaggi nei changeset verranno mostrati come testo preformattato. | enabled |
[components]
Enable or disable components provided by Trac and plugins.
The component to enable/disable is specified by the option name.
The enabled state is determined by the option value: setting
the value to enabled or on will enable the component, any
other value (typically disabled or off) will disable the
component.
The option name is either the fully qualified name of the component or the module/package prefix of the component. The former enables/disables a specific component, while the latter enables/disables any component in the specified package/module.
Consider the following configuration snippet:
[components] trac.ticket.report.ReportModule = disabled acct_mgr.* = enabled
The first option tells Trac to disable the
report module.
The second option instructs Trac to enable all components in
the acct_mgr package. The trailing wildcard is required for
module/package matching.
To view the list of active components, go to the Plugins
section of About Trac (requires CONFIG_VIEW
permission).
See also: TracPlugins
[header_logo]
alt | Testo alternativo per il logo nell'intestazione. | (please configure the [header_logo] section in trac.ini) |
height | Altezza in pixel dell'immagine del logo nell'intestazione. | -1 |
link | URL per il collegamento associato al logo nell'intestazione. | (nessun default) |
src | URL dell'immagine da usare come logo nell'intestazione. Può essere assoluto, relativo al server o relativo.
Se è relativo, viene risolto rispetto a una delle posizioni | site/your_project_logo.png |
width | Larghezza in pixel dell'immagine del logo nell'intestazione. | -1 |
[http-headers]
Headers to be added to the HTTP request. (since 1.2.3)
The header name must conform to RFC7230 and the following reserved names are not allowed: content-type, content-length, location, etag, pragma, cache-control, expires.
[inherit]
htdocs_dir | Path to the shared htdocs directory. Static resources in that directory are mapped to /chrome/shared under the environment URL, in addition to common and site locations. This can be useful in site.html for common interface customization of multiple Trac environments.
Non-absolute paths are relative to the Environment | (nessun default) |
plugins_dir | Path to the shared plugins directory.
Plugins in that directory are loaded in addition to those in
the directory of the environment
Non-absolute paths are relative to the Environment | (nessun default) |
templates_dir | Path to the shared templates directory.
Templates in that directory are loaded in addition to those in the
environments
Non-absolute paths are relative to the Environment | (nessun default) |
[intertrac]
This section configures InterTrac prefixes. Option names in
this section that contain a . are of the format
<name>.<attribute>. Option names that don't contain a . define
an alias.
The .url attribute is mandatory and is used for locating the
other Trac. This can be a relative path when the other Trac
environment is located on the same server.
The .title attribute is used for generating a tooltip when the
cursor is hovered over an InterTrac link.
Example configuration:
[intertrac] # -- Example of setting up an alias: t = trac # -- Link to an external Trac: genshi.title = Edgewall's Trac for Genshi genshi.url = https://genshi.edgewall.org
[interwiki]
Ogni opzione nella sezione [interwiki] definisce un prefisso
InterWiki. Il nome dell'opzione definisce il prefisso, mentre il
suo valore definisce l'URL, opzionalmente seguito da una descrizione
separata da una spaziatura dall'URL. Sono supportati anche URL
parametrici.
Esempio:
[interwiki] MeatBall = http://www.usemod.com/cgi-bin/mb.pl? PEP = http://www.python.org/peps/pep-$1.html Python Enhancement Proposal $1 tsvn = tsvn: Interact with TortoiseSvn
[logging]
log_file |
Se | trac.log |
log_format | Personalizzazione del formato di logging. Se non viene impostato, verrà usato il seguente formato: Trac[$(module)s] $(levelname)s: $(message)s Oltre alle chiavi ordinariamente supportate dalla libreria logging di Python (vedi http://docs.python.org/library/logging.html), possono essere usati anche:
Da notare l'utilizzo della forma
Esempio:
| (nessun default) |
log_level | Livello di logging.
Valori consentiti: | INFO |
log_type | Tipo di logging utilizzato.
Valori consentiti: | file |
[mainnav]
Configures the main navigation bar, which by default contains Wiki, Timeline, Roadmap, Browse Source, View Tickets, New Ticket, Search and Admin.
The label, href, and order attributes can be specified. Entries
can be disabled by setting the value of the navigation item to
disabled.
The following example renames the link to WikiStart to Home, links the View Tickets entry to a specific report and disables the Search entry.
[mainnav] wiki.label = Home tickets.href = /report/24 search = disabled
See TracNavigation for more details.
[metanav]
Configura le meta voci di navigazione, che di default sono Accedi,
Esci, Preferenze, Aiuto/Guida e Info su Trac.
Gli attributi consentiti sono gli stessi che per [mainnav]. Oltre
a quelli, è supportata anche un'ulteriore voce speciale: logout.redirect
è la pagina dove viene rediretto l'utente dopo aver premuto il tasto di uscita.
Ad esempio:
[metanav] logout.redirect = wiki/Logout
Per ulteriori dettagli consulta TracNavigation.
[milestone]
default_group_by | Campo usato di default per raggruppare le segnalazioni nella barra di progressione. (dalla 1.2) | component |
default_retarget_to | Obiettivo di default dove spostare le segnalazioni quando l'obiettivo viene chiuso o cancellato. (dalla 1.1.2) | (nessun default) |
stats_provider |
Nome del componente che implementa | DefaultTicketGroupStatsProvider |
[milestone-groups]
As the workflow for tickets is now configurable, there can be many ticket states, and simply displaying closed tickets vs. all the others is maybe not appropriate in all cases. This section enables one to easily create groups of states that will be shown in different colors in the milestone progress bar.
Note that the groups can only be based on the ticket status, nothing else. In particular, it's not possible to distinguish between different closed tickets based on the resolution.
Example configuration with three groups, closed, new and active (the default only has closed and active):
# the 'closed' group correspond to the 'closed' tickets
closed = closed
# .order: sequence number in the progress bar
closed.order = 0
# .query_args: optional parameters for the corresponding
# query. In this example, the changes from the
# default are two additional columns ('created' and
# 'modified'), and sorting is done on 'created'.
closed.query_args = group=resolution,order=time,col=id,col=summary,col=owner,col=type,col=priority,col=component,col=severity,col=time,col=changetime
# .overall_completion: indicates groups that count for overall
# completion percentage
closed.overall_completion = true
new = new
new.order = 1
new.css_class = new
new.label = new
# Note: one catch-all group for other statuses is allowed
active = *
active.order = 2
# .css_class: CSS class for this interval
active.css_class = open
# .label: displayed label for this group
active.label = in progress
The definition consists in a comma-separated list of accepted status. Also, '*' means any status and could be used to associate all remaining states to one catch-all group.
The CSS class can be one of: new (yellow), open (no color) or
closed (green). Other styles can easily be added using custom
CSS rule: table.progress td.<class> { background: <color> }
to a site/style.css file
for example.
[mimeviewer]
max_preview_size | Dimensione massima del file per la visualizzazione HTML. | 262144 |
mime_map | Lista di tipi MIME addizionali e mappature di keyword
Le mappature sono separate da virgole e per ciascun tipo MIME viene
specificata una lista di parole chiave o di estensioni di file
separate dal carattere due punti ( | text/x-dylan:dylan,text/x-idl:ice,text/x-ada:ads:adb |
mime_map_patterns |
Lista di tipi MIME associati a pattern di filename.
Le mappature sono separate da virgole, e ciascuna consiste in un
tipo MIME e una espressione regolare Python usata per verificare
i filename, separati da un carattere due punti ( | text/plain:README(?!\.rst)|INSTALL(?!\.rst)|COPYING.* |
pygments_default_style | Stile di default utilizzato da Pygments. | trac |
pygments_modes | Lista di tipi MIME addizionali per Pygments.
Ciascun tipo deve essere specificato da una tupla
| (nessun default) |
tab_width | Larghezza del tab nella visualizzazione dei file. | 8 |
treat_as_binary | Lista di tipi MIME separati da virgole che devono essere considerati come dati binari. | application/octet-stream,application/pdf,application/postscript,application/msword,application/rtf |
[notification]
admit_domains | Lista dei domini che devono essere considerati come indirizzi email validi (tipo localdomain), separati da virgole. | (nessun default) |
ambiguous_char_width | Width of ambiguous characters that should be used in the table of the notification mail.
If | single |
batch_subject_template |
Come | ${prefix} Batch modify: ${tickets_descr} |
default_format.email | Formato predefinito per distribuire notifiche e-mail. | text/plain |
email_address_resolvers | Comma separated list of email resolver components in the order they will be called. If an email address is resolved, the remaining resolvers will not be called. | SessionEmailResolver |
email_sender |
Name of the component implementing
This component is used by the notification system to send emails.
Trac currently provides | SmtpEmailSender |
ignore_domains | Lista dei domini che non devono essere considerati parte del indirizzo email (per i nomi utente dei domini Kerberos), separati da virgole. | (nessun default) |
message_id_hash | Algoritmo di hash per creare associazioni ID intestazioni -Messaggi univoche. (dalla versione 1.0.13) | md5 |
mime_encoding | Specifica la codifica MIME usata per le email.
I valori supportati sono: | none |
sendmail_path | Path to the sendmail executable.
The sendmail program must accept the | sendmail |
smtp_always_bcc | Indirizzi email, separati da virgole, a cui inviare sempre le notifiche via email, non visibili dai destinatari (Bcc:). | (nessun default) |
smtp_always_cc | Indirizzi email, separati da virgole, a cui inviare sempre le notifiche via email, che sono visti da tutti i destinatari (Cc:). | (nessun default) |
smtp_default_domain | Host/domain di default da aggiungere agli indirizzi che ne sono sprovvisti. Gli indirizzi fully qualified non vengono modificati. Il dominio di default viene aggiunto ai nomi utente degli account che non abbiano specificato un indirizzo email nelle proprie impostazioni utente. | (nessun default) |
smtp_enabled | Abilita la notifica via email. | disabled |
smtp_from | Indirizzo del mittente usato nelle notifiche via email.
Almeno una delle opzioni | trac@localhost |
smtp_from_author |
Usa l'autore della modifica come mittente nelle notifiche via email
(ad esempio il segnalatore di una nuova segnalazione oppure l'autore
di un commento). Se l'autore non ha un indirizzo email verranno usate
le opzioni | disabled |
smtp_from_name | Nome del mittente nelle notifiche via email. | (nessun default) |
smtp_password | Password per l'autenticazione sul server SMTP. | (nessun default) |
smtp_port | Numero di porta del server SMTP da usare per le notifiche via email. | 25 |
smtp_replyto | Indirizzo di Reply-To usato nelle notifiche via email.
Almeno una delle opzioni | trac@localhost |
smtp_server | Hostname del server SMTP da usare per le notifiche via email. | localhost |
smtp_subject_prefix | Testo da aggiungere in testa all'oggetto delle notifiche via email. Se non viene definito, verrà usato [$nome_progetto] come prefisso. Se non si desidera alcun prefisso, specificare un valore vuoto. | __default__ |
smtp_user | Username per l'autenticazione sul server SMTP. | (nessun default) |
ticket_subject_template | A Jinja2 text template snippet used to get the notification subject. The template variables are documented on the TracNotification page. | ${prefix} #${ticket.id}: ${summary} |
use_public_cc | Gli indirizzi email sono visibili a tutti i destinatari. Se questa opzione è disabilitata, i destinatari vengono messi nel campo Bcc. | disabled |
use_short_addr | Consenti indirizzi email senza un host/domain (cioè, solo nome utente).
Il server SMTP dovrà accettare questi indirizzi, aggiungendovi un FQDN
oppure usando la spedizione locale. Vedi anche | disabled |
use_tls | Usa SSL/TLS per spedire le notifiche tramite SMTP. | disabled |
[notification-subscriber]
The notifications subscriptions are controlled by plugins. All
INotificationSubscriber components are in charge. These components
may allow to be configured via this section in the trac.ini file.
See TracNotification for more details.
Available subscribers:
| Subscriber | Descrizione |
|---|---|
AlwaysEmailSubscriber | |
CarbonCopySubscriber | Segnalazione dove sono elencato nel campo CC viene modificata |
NewTicketSubscriber | Any ticket is created |
TicketOwnerSubscriber | Segnalazione in carico a me viene creata o modificata |
TicketPreviousUpdatersSubscriber | Segnalazione che ho aggiornato in precedenza viene modificata |
TicketReporterSubscriber | Segnalazione che ho creato viene modificata |
TicketUpdaterSubscriber | Segnalazione modificata da me |
[project]
admin | Indirizzo email dell'amministratore del progetto. | (nessun default) |
admin_trac_url | URL di base dell'istanza Trac dove riportare gli errori che avvengono in questo Trac. Può essere un URL assoluto o relativo, oppure '.' per riferirsi a questa istanza Trac. Specificare un valore vuoto per disabilitare i pulsanti relativi. | . |
descr | Breve descrizione del progetto. | My example project |
footer | Testo usato come piè di pagina (allineato a destra). | Visit the Trac open source project at<br /><a href="https://trac.edgewall.org/">https://trac.edgewall.org/</a> |
icon | URL dell'icona del progetto. | common/trac.ico |
name | Nome del progetto. | My Project |
url | URL of the project web site.
This is usually the domain in which the | (nessun default) |
[pygments-lexer]
Configure Pygments lexer options.
For example, to set the
PhpLexer options
startinline and funcnamehighlighting:
[pygments-lexer] php.startinline = True php.funcnamehighlighting = True
The lexer name is derived from the class name, with Lexer stripped
from the end. The lexer short names can also be used in place
of the lexer name.
[query]
default_anonymous_query |
La query di default per gli utenti anonimy. La query può
essere nella sintassi specificata dal
query language, oppure una stringa URL di
query che comincia con il carattere | status!=closed&cc~=$USER |
default_query |
La query di default per gli utenti autenticati. La query può
essere nella sintassi specificata dal
query language, oppure una stringa URL di
query che comincia con il carattere | status!=closed&owner=$USER |
items_per_page |
Number of tickets displayed per page in ticket queries,
by default. Set to | 100 |
ticketlink_query |
The base query to be used when linkifying values of ticket
fields. The query is a URL query
string starting with | ?status=!closed |
[report]
items_per_page |
Number of tickets displayed per page in ticket reports,
by default. Set to | 100 |
items_per_page_rss |
Number of tickets displayed in the rss feeds for reports.
Set to | 0 |
[repositories]
One of the methods for registering repositories is to
populate the [repositories] section of trac.ini.
This is especially suited for setting up aliases, using a shared configuration, or specifying repositories at the time of environment creation.
See TracRepositoryAdmin for details on the format of this section, and look elsewhere on the page for information on other repository providers.
[revisionlog]
default_log_limit |
Valore di default del parametro | 100 |
graph_colors | Lista di colori, separati da virgole, usata nel grafo visualizzato nel TracRevisionLog. (dalla 1.0) | #cc0,#0c0,#0cc,#00c,#c0c,#c00 |
[roadmap]
stats_provider |
Nome del componente che implementa | DefaultTicketGroupStatsProvider |
[search]
default_disabled_filters |
Specifies which search filters should be disabled by
default on the search page. This will also restrict the
filters for the quick search function. The filter names
defined by default components are: | (nessun default) |
min_query_length | Lunghezza minima della stringa di query quando si effettua una ricerca. | 3 |
[sqlite]
extensions | Paths to sqlite extensions. The paths may be absolute or relative to the Trac environment. | (nessun default) |
[svn]
authz_file |
The path to the Subversion
authorization (authz) file.
To enable authz permission checking, the | (nessun default) |
authz_module_name |
Il prefisso del modulo usato da | (nessun default) |
[ticket]
allowed_empty_fields | Lista dei nomi dei campi, separati da virgole, che consentono un valore vuoto. (dalla 1.1.2) | milestone,version |
default_cc | CC: di default usato alla creazione di nuove segnalazioni. | (nessun default) |
default_component | Componente di default da usare alla creazione di una nuova segnalazione. | (nessun default) |
default_description | Descrizione di default da usare alla creazione di una nuova segnalazione. | (nessun default) |
default_keywords | Parole chiave di default da usare alla creazione di una nuova segnalazione. | (nessun default) |
default_milestone | Obiettivo di default da usare alla creazione di una nuova segnalazione. | (nessun default) |
default_owner |
Default owner for newly created tickets. The component owner
is used when set to the value | < default > |
default_priority | Priorità di default da usare alla creazione di una nuova segnalazione. | major |
default_resolution | Risoluzione di default usata per risolvere (chiudere) le segnalazioni. | fixed |
default_severity | Severità di default da usare alla creazione di una nuova segnalazione. | (nessun default) |
default_summary | Sommario (titolo) di default da usare alla creazione di una nuova segnalazione. | (nessun default) |
default_type | Tipo di default da usare alla creazione di una nuova segnalazione. | defect |
default_version | Versione di default da usare alla creazione di una nuova segnalazione. | (nessun default) |
max_comment_size | Dimensione massima consentita dei commenti, in caratteri. | 262144 |
max_description_size | Dimensione massima consentita della descrizione, in caratteri. | 262144 |
max_summary_size | Dimensione massima consentita del sommario, in caratteri. (dalla 1.0.2) | 262144 |
preserve_newlines | Se il formattatore Wiki debba rispettare gli a-capo presenti nel testo Wiki. Se impostato a 'default', è equivalente a 'yes' per i nuovi ambienti mentre viene mantenuto il comportamento precedente negli ambienti che sono stati aggiornati (cioè 'no'). | default |
restrict_owner |
Usa un menu a discesa per il campo Nota che gli indirizzi email non vengono offuscati nel menu, quindi questa opzione non deve essere usata se gli indirizzi email devono rimanere protetti. | disabled |
workflow | Lista ordinata dei controlli del flusso di lavoro da usare nelle azioni sulle segnalazioni. | ConfigurableTicketWorkflow |
[ticket-custom]
In questa sezione possono essere specificati campi addizionali per le segnalazioni. Vedi TracTicketsCustomFields per ulteriori dettagli.
[ticket-workflow]
Il flusso di lavoro delle segnalazioni è determinato dai plugin.
Di default, c'è un solo componente ConfigurableTicketWorkflow
che si occupa della gestione. Questo componente consente di
configurare il flusso di lavoro in questa sezione del file
trac.ini. Consulta TracWorkflow per ulteriori dettagli.
[timeline]
abbreviated_messages | Whether wiki-formatted event messages should be truncated or not. This only affects the default rendering, and can be overridden by specific event providers, see their own documentation. | enabled |
changeset_collapse_events | Se changeset consecutivi dello stesso autore aventi esattamente lo stesso messaggio debbano essere presentati come un singolo evento. In questo caso l'evento punterà a un intervallo di changeset nella vista cronologica. | disabled |
changeset_long_messages | Se la formattazione wiki dei messaggi nei changeset debba essere multi-riga oppure no.
Se questa opzione non è specificata o è false e | disabled |
changeset_show_files |
Numero di file da visualizzare (
Può essere impostato anche a | 0 |
default_daysback | Numero di giorni mostrati di default nella cronologia. | 30 |
max_daysback | Numero massimo di giorni (-1 per illimitato) visualizzabile nella cronologia. | 90 |
newticket_formatter | Quale tipo di formattatore (cioè 'html' o 'oneliner') deve essere utilizzato per mostrare la descrizione delle nuove segnalazioni. Quando è impostato a 'oneliner', viene usata l'opzione [timeline] abbreviated_messages. | oneliner |
ticket_show_component | Abilita la visualizzazione del componente delle segnalazioni nella cronologia. (dalla 1.1.1) | disabled |
ticket_show_details | Abilita la visualizzazione di tutte le modifiche alle segnalazioni nella cronologia, non solo le operazioni di apertura / chiusura. | enabled |
[trac]
anonymous_session_lifetime | Lifetime of the anonymous session, in days. Set the option to 0 to disable purging old anonymous sessions. (since 1.0.17) | 90 |
auth_cookie_lifetime | Lifetime of the authentication cookie, in seconds. This value determines how long the browser will cache authentication information, and therefore, after how much inactivity a user will have to log in again. The default value of 0 makes the cookie expire at the end of the browsing session. (since 0.12) | 0 |
auth_cookie_path | Path for the authentication cookie. Set this to the common base path of several Trac instances if you want them to share the cookie. (since 0.12) | (nessun default) |
auto_preview_timeout | Inactivity timeout in seconds after which the automatic wiki preview triggers an update. This option can contain floating-point values. The lower the setting, the more requests will be made to the server. Set this to 0 to disable automatic preview. | 2.0 |
auto_reload | Ricarica automaticamente i template modificati. | disabled |
backup_dir | Posizione del backup del database. | db |
base_url | Base URL of the Trac site. This is used to produce documents outside of the web browsing context, such as URLs in notification e-mails that point to Trac resources. | (nessun default) |
check_auth_ip | Whether the IP address of the user should be checked for authentication (since 0.9). | disabled |
database | Connessione al database. Stringa di connessione al database per questo progetto. | sqlite:db/trac.db |
debug_sql | Mostra le query SQL nel log di Trac, al livello DEBUG. | disabled |
default_charset | Codifica da usare in caso di ambiguità. | utf-8 |
default_date_format | Il formato delle date. I valori possibili sono 'iso8601' per selezionare il formato ISO 8601, o lasciarlo in bianco di modo che il formato venga desunto dalla lingua di default del browser. (dalla 1.0) | (nessun default) |
default_dateinfo_format | Formato dei valori temporali. Le opzioni possibili sono 'relative' per visualizzarli in un formato relativo oppure 'absolute' per mostrarli in formato assoluto. (dalla 1.0) | relative |
default_handler | Name of the component that handles requests to the base URL.
Options include The session preference for default handler take precedence, when set. | WikiModule |
default_language | The preferred language to use if no user preference has been set. | (nessun default) |
default_timezone | Fuso orario da usare di default. | (nessun default) |
htdocs_location | URL di base per service le risorse statiche sotto /chrome/common. Può essere lasciato vuoto, nel qual caso Trac semplicemente servirà tali risorse autonomamente.
Utenti esperti potranno usare questa opzione insieme a
trac-admin ... deploy <deploydir> per consentire al
web server di servire direttamente le risorse statiche.
Nota però che questo si applica solo alla directory
| (nessun default) |
ignore_auth_case | Whether login names should be converted to lower case (since 0.9). | disabled |
jquery_location | Location of the jQuery JavaScript library (version 3.6.3). An empty value loads jQuery from the copy bundled with Trac. Alternatively, jQuery could be loaded from a CDN, for example: http://code.jquery.com/jquery-3.6.3.min.js, http://ajax.aspnetcdn.com/ajax/jQuery/jquery-3.6.3.min.js or https://ajax.googleapis.com/ajax/libs/jquery/3.6.3/jquery.min.js. (since 1.0) | (nessun default) |
jquery_ui_location | Location of the jQuery UI JavaScript library (version 1.13.0). An empty value loads jQuery UI from the copy bundled with Trac. Alternatively, jQuery UI could be loaded from a CDN, for example: https://ajax.googleapis.com/ajax/libs/jqueryui/1.13.0/jquery-ui.min.js or http://ajax.aspnetcdn.com/ajax/jquery.ui/1.13.0/jquery-ui.min.js. (since 1.0) | (nessun default) |
jquery_ui_theme_location | Location of the theme to be used with the jQuery UI JavaScript library (version 1.13.0). An empty value loads the custom Trac jQuery UI theme from the copy bundled with Trac. Alternatively, a jQuery UI theme could be loaded from a CDN, for example: https://ajax.googleapis.com/ajax/libs/jqueryui/1.13.0/themes/start/jquery-ui.css or http://ajax.aspnetcdn.com/ajax/jquery.ui/1.13.0/themes/start/jquery-ui.css. (since 1.0) | (nessun default) |
never_obfuscate_mailto |
Non offuscare mai i link | disabled |
permission_policies |
Lista di componenti che implementano | DefaultWikiPolicy,DefaultTicketPolicy,DefaultPermissionPolicy,LegacyAttachmentPolicy |
permission_store |
Name of the component implementing | DefaultPermissionStore |
request_filters | Lista ordinata dei filtri da applicare a tutte le richieste. | (nessun default) |
resizable_textareas |
Make | enabled |
secure_cookies | Limita i cookie alle connessioni HTTPS.
Quando impostato a true, abilita la flag | disabled |
show_email_addresses | Mostra gli indirizzi email invece che i nomi utente. Se false, l'indirizzo email viene offuscato per gli utenti che non hanno il permesso EMAIL_VIEW. | disabled |
show_full_names | Mostra i nomi completi anziché i nomi utente. (dalla 1.2) | enabled |
timeout |
Valore di timeout per la connessione al database, in secondi.
Usare | 20 |
use_base_url_for_redirect |
Utilizza
In qualche configurazione, tipicamente quando Trac viene esposto
tramite un proxy HTTP, Trac non è in grado di ricostruire
automaticamente l'URL usato per accedervi. Potresti dover
usare questa opzione per forzare il Trac a usare l'impostazione
| disabled |
use_chunked_encoding |
Se abilitato, i contenuti vengono inviati utilizzando la chunked encoding.
Altrimenti vengono inviati con l'header | enabled |
use_xsendfile |
Se impostato a true, restituisci una intestazione | disabled |
wiki_toolbars | Add a simple toolbar on top of Wiki <textarea>s. (since 1.0.2) | enabled |
xsendfile_header |
Header da utilizzare se viene abilitata l'opzione | X-Sendfile |
[versioncontrol]
allowed_repository_dir_prefixes | Comma-separated list of allowed prefixes for repository directories when adding and editing repositories in the repository admin panel. If the list is empty, all repository directories are allowed. | (nessun default) |
default_repository_type | Default repository connector type. This is used as the default repository type for repositories defined in the repositories section or using the "Repositories" admin panel. | svn |
[wiki]
default_edit_area_height | Altezza di default della textarea usata per modificare una pagina wiki. (dalla 1.1.5) | 20 |
ignore_missing_pages | Abilita/disabilita l'evidenziazione dei link CamelCase alle pagine mancanti. | disabled |
max_size | Dimensione massima consentita di una pagina wiki, in caratteri. | 262144 |
render_unsafe_content |
Abilita/disabilita l'uso di tag HTML non sicure come Per siti pubblici dove l'utente anonimo può modificare il wiki si raccomanda di lasciare questa opzione disabilitata. | disabled |
safe_origins |
List of URIs considered "safe cross-origin", that will be
rendered as To make any origins safe, specify "*" in the list. | data: |
safe_schemes |
Lista di schemi URI considerati "sicuri", che verranno resi come
collegamenti esterni anche quando | cvs,file,ftp,git,irc,http,https,news,sftp,smb,ssh,svn,svn+ssh |
split_page_names | Abilita/disabilita la spezzatura dei WikiPageNames con caratteri di spaziatura. | disabled |
Configure Error Reporting
The error reporting page has a Create button for reporting issues. The site to which issues are reported depends on the configuration of the Trac site and the user’s permissions.
If the user doesn’t possess TRAC_ADMIN, the site to which a user is directed to create a ticket is determined by the [trac] admin_trac_url setting:
- If empty, there will be no Create button.
- If set to the default value (
.), the ticket will be created on the site which the error occurred. - Otherwise the ticket will be created at the site pointed
to by
admin_trac_url.
If [project] admin is not empty, the administrator's email address will be rendered on the error page.
If the user possesses TRAC_ADMIN, the Create button will direct the user to report the issue on trac.edgewall.org. If the error was generated in a plugin, the error will be reported to the project URL provided that the plugin author has included the project URL in the plugin installation data. The user possessing TRAC_ADMIN also sees a traceback and system information on the error page.
See also: TracAdmin, TracEnvironment
