Menu

WikiDocumentation

Ulf Dittmer

The big new feature of jTrac 2.3 is a built-in wiki. It's accessible through the Wiki link at the top menu bar. Initially, the wiki contains three pages the HomePage, the SandBox and RecentChanges. HomePage is the starting point behind the Wiki link, SandBox is a place where everyone can practice editing wiki pages without disturbing any actual content, and RecentChanges is an automatically updated page that lists all pages that have recently been edited. It's not supposed to be edited, just to inform anyone curious about where changes have been made.

link to wiki

The menu at the left has links to these pages, as well as a search box, and a link to take people back to the dashboard of the bug tracker (all this is in theOther pages section.) The This Page section relates to the current page, and has links to show the previous version (the linked date of the last change), show the differences since the last change (What's changed?), an Edit link that allows you to do just that, as well as a Watch or Unwatch link. The latter will cause you to get an email notifying you every time a change has been made to this page. (Not quite every time, though - if you haven't visited the page since the previous edit, you won't get another email.) Note that the watch is for this one page only; if you're interested in other pages as well, you need to click Watch on those pages as well. If you're no longer interested in those mails, click the Unwatch link.

wiki menu

The syntax used to create end edit pages is Markdown, and you can learn about its basics, and find a longer tutorial if you follow the link. You can create a new page by adding a link to it to an existing page. A link is the page name in camel case. A question mark will automatically be appended to it - this means the page doesn't yet exist. If you click on the question mark, you'll be taken to the new page in edit mode, where you can start adding content to the page. Once you save it, the page will be properly linked wherever its name is added to a page.

after adding the page name: page does not exist after editing the new page: page exists

A few options are available when editing pages, below the content edit area. Besides buttons to preview any changes (the preview will appear at the bottom of the screen), saving the changes, and cancelling them, 3 text fields are more additional information: * What's changed? can be used to add information about what changes on a page. While the What's Changed? link will show the textual differences, sometimes it can be useful to describe in a few words what those changes amount to. This text will be displayed at the top of the What's Changed? page. * Alternative title While the page needs to be named as a word in camel case, that's not a particular good way to show the title. So whatever is in this field will be used as the title at the top of the page. If it's empty, the camel-cased page name is used instead. * Redirect to Sometimes a particular page no longer makes sense - maybe it's obsolete, or its contents have been added to some other page. If the name of another page name is put into this field, whenever the page is brought up through a link or bookmark, it will redirect to the one entered here. That way any bookmarks or links to this page are not broken, but instead redirect to a more appropriate place.

edit options

By default, the wiki is protected just like the bug tracker, but it's possible to make it publicly accessible without login. For that, change the wiki.public setting under Options -> Manage Settings to true


Related

News: 2023/02/jtrac-230-has-been-released
Wiki: Home

Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.