[[TracNav(NuwaNav)]]

= Keywords/Tags =

To help find things, please assign descriptive Tags to tickets that you create or comment on.  
   * Use '''C'''apitalised words without spaces, for the tags
   * Reuse preexisting tags if they are appropriate
   * Use multiple Tags if appropriate, delimited by spaces 

[[TagCloud]]

= Welcome to Nuwa Trac  =

This Trac instance provides an interface to the SVN repository 
     *  http://dayabay.ihep.ac.cn/svn/dybsvn/

In addition to this page see other documentation on IHEP Trac 
    * wiki:NuWa_Trac   --  introduction to Trac, creating tickets etc.. ||
    * wiki:Testing_Quickstart -- installation/usage of python based testing infrastructure  || 
    * tagged:Help    -- documents tagged with the Keyword  '''Help''' at IHEP 
 
These pages are also translated/copied (with some delay) to the BNL wiki :
    * db:NuWa_Trac --  introduction to Trac, creating tickets etc.. 
    * db:Testing_Quickstart -- installation/usage of python based testing infrastructure   
    * db_:Trac  -- documents in '''Trac''' category  at BNL 

NB although Nuwa Trac provides yet another wiki, 
creating pages on it '''is not encouraged'''  unless they are directly related to the use of Trac or the testing system.

== Trac Login And Preferences ==

Your SVN account identity is used by Trac, so use this to login using the above link.  Before
doing this most links will yield '''PERMISSION DENIED''' messages.

  * After log in be sure to set your '''email address''' in the  preferences, in order to be notified of changes to tickets you create.
  * While the '''dayabay''' identity will allow you to login you are requested to '''only use this until you get your own SVN identity''' from Xinchun Tian ('''tianxc AT ihep.ac.cn''')

== Usage Tips ==

The search box at top right  provides simple searches of commit messages, tickets and wiki pages. 
In addition to this simple search functionality, entering snippets of ''wikitext'' in the search box provides shortcut access to 
tickets, changesets, reports links etc..   
   ||  ''search'' text     ||   '''result''' ||
   || /dybgaudi/trunk || browse repository path (when used in ordinary wiki text use source:/dybgaudi/trunk )   ||
   || {{{r42}}}                    ||  changeset r42 ||
   || {{{#1}}}                      ||  ticket #1 ||
   || {{{{6}}}}                      || report {6} presentation of a selection of tickets ||
   || {{{[/build/dybinst]}}}   || a project relative link, [/build/dybinst] || 
   || {{{[/build/dybinst/199]}}} ||  a specific build  [/build/dybinst/199]  ||    
   || {{{log:dybgaudi/trunk/DybKernel/}}}  || revision log:dybgaudi/trunk/DybKernel/  ||
 

Some links of form {{{prefix:whatever}}} such as doc:101 are configured by a special wiki page  InterMapTxt  that maps the prefixes to URLs, you  
can add URL prefixes by editing the InterMapTxt wiki page. Examples of using these prefix links :

 || '''text to enter''' || '''what it looks like''' ||  '''action'''  (mostly jumping somewhere)  || 
 ||  {{{search:?q=yield}}}   ||  search:?q=yield  ||  search commit messages and tickets ||
 || {{{root:TH1}}} || root:TH1           ||  roots documentation for class '''TH1''' ||
 || {{{doc:101}}} || doc:101            || docdb document 101 ||
 || {{{source:/legacy/trunk}}}  ||  source:/legacy/trunk     ||  repository browser on a directory or file ||  
 || {{{db_:SVN db_:Gaudi}}}   || db_:SVN db_:Gaudi     || BNL wiki pages for categories ''SVN'', ''Gaudi''  ||
 || {{{db:SVN_Web_Interface}}} || db:SVN_Web_Interface || BNL wiki page ||
 || {{{dbp_:Gaudi}}}   || dbp_:Gaudi                   || private BNL wiki page for a category  ||
 || {{{db__:SVN}}}     || db__:SVN                     || search BNL wiki ||
 || {{{dbp__:Gaudi}}}  || dbp__:Gaudi                  || search private BNL wiki    ||
 || {{{swish:Acrylic}}} || swish:Acrylic               || swish search for the string ||    
 || {{{offline:2008-08/msg00058.html}}} || offline:2008-08/msg00058.html || link to archived mail ||  
 || {{{dox_pkg_class:GenTools:GtGunGenTool}}} || dox_pkg_class:GenTools:GtGunGenTool || Doxygen class documentation||

All of the above can be used in normal wiki text, and can also be used as shortcuts in the search box.  
You can use these in all places that wiki text is allowed,  namely :
   * in commit messages from your '''svn''' commandline 
   * on wiki pages 
   * in issue/feature request tickets    

To prettify the presentation of the link you can use the square bracket form :
 ||  '''text to enter''' ||  '''what it looks like''' || '''action'''  ||
 || {{{[search:?q=yield yield]}}}    || [search:?q=yield yield]   || search commit messages and tickets ||
 || {{{[source:/dybgaudi/trunk /dybgaudi/trunk/]}}}   ||  [source:/dybgaudi/trunk /dybgaudi/trunk/]  || browser on a directory/file ||
 
For full details see TracLinks and TracSearch.



== Further Search Tips ==

 * searching for !CamelCase strings like ''!GenHeader'' using the quick search box will offer to create wiki pages, avoid this by using quotes "!GenHeader"
 



== Trac Starting Points ==

 * OriginalWikiStart -- Trac welcome page 
 * TracGuide --  Built-in Documentation
 * [http://trac.edgewall.org/ The Trac project] -- Trac Open Source Project
 * [http://trac.edgewall.org/wiki/TracFaq Trac FAQ] -- Frequently Asked Questions
 * TracSupport --  Trac Support

For a complete list of local wiki pages, see TitleIndex.