Edgewall Software

Changes between Version 236 and Version 237 of 0.12/TracFaq


Ignore:
Timestamp:
Jun 22, 2006, 3:25:47 PM (18 years ago)
Author:
Christian Boos
Comment:

Fixed several errors, but more review needed. Contributions welcomed!

Legend:

Unmodified
Added
Removed
Modified

  • 0.12/TracFaq

    v236 v237  
    3232=== What operating systems does Trac run on? === #what-operating-systems-does-trac-run-on
    3333
    34 Trac will run on any system supported by Python and the depending modules. Today we are aware of people running Trac on various Linux distributions, Mac OS X, FreeBSD, NetBSD and MS Windows. 
    35 
    36 
    37   See also: TracOnFreeBsd , TracOnNetBsd , TracOnOsx, TracOnMandrakelinux, TracOnGentoo, TracOnDebian, TracOnFedoraCore, TracOnRedhat, TracOnWindows, ["TracOnSLES9"]
     34Trac will run on any system supported by Python and the depending modules. Today we are aware of people running Trac on various Linux distributions, Mac OS X, FreeBSD, NetBSD and MS Windows.
     35
     36
     37  See also: TracOnFreeBsd , TracOnNetBsd , TracOnOsx, TracOnMandrakelinux, TracOnGentoo, TracOnDebian, TracOnFedoraCore, TracOnRedhat, TracOnWindows, ["TracOnSLES9"] ... and various others, listed in TracInstallPlatforms.
    3838
    3939=== What license governs the use of Trac? === #what-license-governs-the-use-of-trac
    … …  
    4949=== What are the dependencies of Trac? === #what-are-the-dependencies-of-trac
    5050
    51 Trac depends on the following software: Subversion w/Python bindings, [http://www.clearsilver.net/ Clearsilver], [http://www.sqlite.org/ SQLite w/Python bindings]. Syntax coloring requires [http://people.ssh.fi/mtr/genscript GNU Enscript] and/or [http://silvercity.sf.net/ SilverCity].
    52 
    53   See also: TracInstall, TracSyntaxColoring.
     51Trac depends on the following software: Python, of course, but also [http://www.clearsilver.net/ Clearsilver]. Other packages may also be required: the Subversion bindings for Python, [http://www.sqlite.org/ SQLite w/Python bindings] for the DatabaseBackend. Syntax coloring requires [http://people.ssh.fi/mtr/genscript GNU Enscript] and/or [http://silvercity.sf.net/ SilverCity]. For a precise list and additional details, refer to TracInstall#Requirements.
     52
     53  See also: TracSyntaxColoring.
    5454
    5555=== How do I install Clearsilver? === #how-do-i-install-clearsilver
    5656
    57 
    5857The following Trac error message indicates that Clearsilver is not installed correctly.
    59 Check first our ClearSilver wiki page. If this still doesn't work,
    60 maybe the following tips can help:
    6158{{{
    6259   TracError: ClearSilver not installed (No module named neo_cgi)
    6360}}}
     61
     62Check first our ClearSilver wiki page.
    6463Clearsilver has some bugs in its build process. The following process may help:
    6564
    … …  
    7675   python setup.py install
    7776}}}
     77
    7878See also http://groups.yahoo.com/group/ClearSilver/message/589 - it appears that PYTHON_SITE is not being set properly in the clearsilver-0.10.2 makefile so neo_cgi.so is not installed. Try:
    7979
    … …  
    9393=== Can I replace SQLite with MySQL or PostgreSQL? === #can-i-replace-sqlite-with-mysql-or-postgresql
    9494
    95 Yes.
    96 See #126 re Database Independence and DatabaseBackend.
     95Yes, PostgreSQL since [milestone:0.9] and MySQL since [milestone:0.10].
     96
     97  See also: DatabaseBackend.
    9798
    9899=== Can I manage multiple projects from a single installation of Trac? === #can-i-manage-multiple-projects-from-a-single-installation-of-trac
    … …  
    106107The rationale for this is that the scope of Trac (1.0) is to manage a single project, and do it well. Support for larger multi-project management adds a lot of complexity, but is planned for post-1.0 development, probably as a separate framework around Trac.
    107108
    108 
    109 
    110   See also: TracMultipleProjects
     109  See also: TracMultipleProjects and the [TitleIndex TracMultipleProjects/...] discussion pages.
    111110
    112111=== How can I create a nice URL to access trac.cgi? === #how-can-i-create-a-nice-url-to-access-trac-cgi
    … …  
    160159        - templates: ClearSilver templates; and
    161160   
    162     $TRAC_DB/conf/trac.ini:: settings, including (but not limited to):
     161    $TRAC_ENV/conf/trac.ini:: settings, including (but not limited to):
    163162        - templates_dir: where page templates are stored;
    164163        - htdocs_location: the base URL for this Trac installation; and
    165164
    166 
    167165and you can read more about the clearsilver templating language at http://www.clearsilver.net/docs/.
    168166
    … …  
    173171
    174172=== Can I use Trac with a remote subversion repository? === #can-i-use-trac-with-a-remote-subversion-repository
    175 
    176173
    177174You can't use Trac (not yet) with remote repository but you could mirror remote repository
    … …  
    180177If you're on Windows, the Python bindings support UNC paths, so you can use a repository that's shared out on another machine. Just use the UNC path instead of the local file path when setting up Trac.  (Note that this can be slow and that this usage is not recommended by the Subversion development team.)
    181178
     179  See also: #493, VersioningSystemBackend.
     180
    182181=== How do I change the format used for displaying date and time? === #how-do-i-change-the-format-used-for-displaying-date-and-time
    183182
    … …  
    187186  SetEnv LC_TIME "xx_YY"
    188187}}}
    189 
    190188
    191189Right after the line where you set TRAC_ENV.
    … …  
    197195
    198196Examples: `de_DE` is Germany, `en_GB` is Great Britain and `fr_FR` is France
     197For ending up with a ISO 8601 style, you could use [ticket:3008 ro_RO].
    199198
    200199On a Windows platform:
    … …  
    323322and click on the "Edit This page link"
    324323
    325 
     324Good "wiki" style suggests however that you start by editing some existing page, then insert a WikiPageName and save the page. The WikiPageName link will be displayed as a ''missing'' link (i.e. LikeThat), and by following this link, you end up on the page creation interface. By following this practice, you tend to avoid ["OrphanedPage"]s.
    326325
    327326=== How do I remove a page from the Wiki? === #how-do-i-remove-a-page-from-the-wiki
    … …  
    329328Users with the WIKI_DELETE permission can click the "Delete Page" button at the bottom of the page.
    330329
    331 The trac-admin utility can also remove Wiki pages like so:
    332 
     330The TracAdmin utility can also remove Wiki pages like so:
    333331{{{
    334332    trac-admin <yourprojenv> wiki remove PageName
    … …  
    356354=== Is there a way to edit attachments? === #is-there-a-way-to-edit-attachments
    357355
    358 Could I download attached file,  update it and upload it back with same name? See related #948. 
     356Could I download attached file,  update it and upload it back with same name? See related #948.
    359357
    360358=== Can I convert MediaWiki pages to Trac? === #can-i-convert-mediawiki-pages-to-trac
    361359
    362 You can use the mediawiki2trac.py script (attached to TracWiki) as a starting point. However, it would probably be better to write a WikiProcessor for the MediaWiki styles.
     360You can use the attachment:wiki:TracWiki:mediawiki2trac.py script as a starting point. However, it would probably be better to write a WikiProcessor for the MediaWiki styles.
    363361
    364362=== Can I directly add questions to this Wiki FAQ? === #can-i-directly-add-questions-to-this-wiki-faq
    365363
    366 
    367 Yes, you can! However, please don't add unanswered questions.  Good places to ask questions
     364Yes, you can! However, please don't add unanswered questions, only topics that you've regularly answered yourself or issues you're familiar with.  Good places to ask questions
    368365are the MailingList and the IrcChannel. 
    369366
    … …  
    373370Thanks to the ![[PageOutline]] macro, the index for this FAQ is generated automatically.
    374371
    375 [[comment(well, I know, the equivalent to the ::sectnum feature is currently missing...)]]
     372{{{
     373#!comment
     374
     375Well, I know, the equivalent to the ::sectnum feature is currently missing.
     376Also, it would probably be better if the PageOutline macro could be made to take
     377all the available page width.
     378}}}
     379
    376380
    377381=== But then how do we control spammers and malicious contributors? === #but-then-how-do-we-control-spammers-and-malicious-contributors
    378382
    379 I guess you would get an answer rapidly if you added a malicious contribution, and you just might get a bruise.
     383I guess you would get an answer rapidly if you added a malicious contribution, and you just might get a bruise (and we'll send you an [http://www.catb.org/jargon/html/I/ice.html ICE]).
    380384
    381385----
    … …  
    397401=== On Windows, why does Trac not display diffs? === #on-windows-why-does-trac-not-display-diffs
    398402
    399 
     403'''Note:''' this problem concerns old version of Subversion and Trac, and can probably be deleted from the FAQ.
     404''
    400405The tree diff functionality provided by the subversion python bindings use an
    401406external diff_ command. On UNIX-like systems, diff is usually installed already, so this wasn't an issue there. Installing [http://gnuwin32.sourceforge.net/packages/diffutils.htm diffutils] should solve the problem.
    402 
     407''
     408
     409''
    403410After installing diffutils, you will need to add the path to the diff executable to the Windows PATH environment variable and reboot the machine.
     411''
    404412
    405413=== Does Trac support syntax coloring/highlighting of source code files? === #does-trac-support-syntax-coloring-highlighting-of-source-code-files
    … …  
    413421=== Is there any way to remove tickets? === #is-there-any-way-to-remove-tickets
    414422
    415 
    416 You have to go through the db file in order to remove a ticket. No web interface is available for the moment (see #298).
     423Yes, using TracAdmin:
     424{{{
     425  trac-admin <yourprojenv> ticket remove <num>
     426}}}
     427You have to go through the db file in order to remove a ticket. For a web interface, see TracHacks:TicketDeletePlugin.
    417428
    418429=== Is there any way to migrate tickets from one Trac installation to another? === #is-there-any-way-to-migrate-tickets-from-one-trac-installation-to-another
    … …  
    483494=== We're already using Bugzilla, can I disable tickets? === #we-re-already-using-bugzilla-can-i-disable-tickets
    484495
    485 
    486 Use TracAdmin and disable the permissions for tickets:
    487 
    488 {{{
    489   trac-admin </path/to/projenv> permission remove TICKET_VIEW TICKET_CREATE TICKET_MODIFY TICKET_ADMIN
    490 }}}
     496Disable the ticket components, in your TracIni:
     497{{{
     498[components]
     499trac.ticket.* = disabled
     500}}}
     501
     502Also, it's quite simple to write a plugin to redirect ticket references
     503to your legacy ticket system: e.g. [attachment:wiki:ChristianBoos:mantis_tickets.py].
    491504
    492505=== Microsoft Outlook displays ticket notification mails in a non-monospace font, how do I change that? === #microsoft-outlook-displays-ticket-notification-mails-in-a-non-monospace-font-how-do-i-change-that