back to [/site Site Home]

== Trac Usage Help ==
=== Wiki Tips ===
News and Downloads, which used to be maintained by the project admins in some admittedly awful PHP screens, may now be maintained in wiki pages.

==== Downloads ====
Please try to make use of the {{{[download:}}} macro.  The preferred way of getting your downloads/packages to the server is to put them in the /downloads folder of your SVN repos.  Instead of pointing to the /downloads repos section like: {{{ [source:/downloads/file-0.0.zip file-0.0.zip] }}}, this is the preferred method:
{{{
[download:/downloads/file-0.0.zip file-0.0.zip]
}}}
The effect of this is to append ''?format=raw'' to the end of the hyperlink, thus skipping over Trac's attempt to display the file as source code.  The file will immediately be served for download.

==== Project Information ====
Use the '''!ProjectInfo''' macro to get information from the central dsource.org projects database about your project.  Then, when you update it in the Admin section of Trac, the next page views using the macro will be up-to-date.  For example, this wiki code:
{{{
||Name||'''[[ProjectInfo(name)]]'''
||Category||[[ProjectInfo(cat)]]
||Status||[[ProjectInfo(status_id)]] - [[ProjectInfo(status_name)]]
||Home Page||[[ProjectInfo(home_page)]]
||Short Description||[[ProjectInfo(short_desc)]]
||Long Description||[[ProjectInfo(long_desc)]]
}}}
should yield something like this:
{{{
#!html
<table class="wiki">
<tr><td>Name</td><td><strong>test</strong>
</td></tr><tr><td>Category</td><td>Server Resources
</td></tr><tr><td>Status</td><td>1 - Planning

</td></tr><tr><td>Home Page</td><td>http://test.dsource.org
</td></tr><tr><td>Short Description</td><td>a great test project
</td></tr><tr><td>Long Description</td><td>bleck
blah
</td></tr></table>
}}}

Or, simply, 
{{{
[[ProjectInfo(short_desc)]]
}}}
should yield:
{{{
#!html
a great test project
}}}

==== News ====
News, Changelogs, Status updates may be maintained by hand in a wiki page, as no central integration is planned at this time.

back to [/site Site Home]