Changes between Version 11 and Version 12 of WikiStart


Ignore:
Timestamp:
Mar 4, 2014, 1:32:07 AM (4 years ago)
Author:
Iritscen
Comment:

this page really needs manual linebreaks to be comfortable reading

Legend:

Unmodified
Added
Removed
Modified
  • WikiStart

    v11 v12  
    11= Welcome to the Oni Community Bug Tracker =
    22
    3 This is where we report bugs and desired features in the software that the community has produced and stored on our [http://websvn.chrilly.net/listing.php?repname=Oni2 Subversion repository], as well as the core mod packages for the [http://wiki.oni2.net/AE Anniversary Edition] on the [http://mods.oni2.net Mod Depot]. This site runs on [http://trac.edgewall.org/ Trac], which provides a '''wiki''', '''timeline''', '''ticket system''', and roadmap (not used here). Full documentation is found under the "Help/Guide" link at the top-right, but here's some starter tips and links.
     3This is where we report bugs and desired features in the software that the community has produced and stored on our[[br]]
     4[http://websvn.chrilly.net/listing.php?repname=Oni2 Subversion repository], as well as the core mod packages for the [http://wiki.oni2.net/AE Anniversary Edition] on the [http://mods.oni2.net Mod Depot]. This[[br]]
     5site runs on [http://trac.edgewall.org/ Trac], which provides a '''wiki''', '''timeline''', '''ticket system''', and roadmap (not used here). Full[[br]]
     6documentation is found under the "Help/Guide" link at the top-right, but here's some starter tips and links.
    47
    5 If you're familiar with editing Wikipedia but not a Trac '''wiki''', you'll have a small amount of adjusting to do, as Trac's a bit closer to the original wiki software, [wikipedia:WikiWikiWeb]. Overall, though, the markup is pretty similar to MediaWiki, on which Wikipedia runs. Read WikiFormatting to learn the markup; I suggest especially paying attention to the CamelCase and WikiPageNames pages, as this aspect is quite different from MediaWiki. To disable wiki markup in various contexts, pre-pend a '!' to it. Click "Edit this page" to see how I use the '!' in the sentence after this one, for example. Raw HTML can be used by typing !{{{#!html htmlStuffHere}}}.
     8If you're familiar with editing Wikipedia but not a Trac '''wiki''', you'll have a small amount of adjusting to do, as Trac's a[[br]]
     9bit closer to the original wiki software, [wikipedia:WikiWikiWeb]. Overall, though, the markup is pretty similar to MediaWiki, on[[br]]
     10which Wikipedia runs. Read WikiFormatting to learn the markup; I suggest especially paying attention to the CamelCase[[br]]
     11and WikiPageNames pages, as this aspect is quite different from MediaWiki. To disable wiki markup in various contexts,[[br]]
     12pre-pend a '!' to it. Click "Edit this page" to see how I use the '!' in the sentence after this one, for example. Raw[[br]]
     13HTML can be used by typing !{{{#!html htmlStuffHere}}}.
    614
    7 The '''Timeline''' shows the recent commits to Subversion, recent ticket changes, and edits to the wiki. It's an easy way to keep your finger on the pulse of the community's projects. If you are an RSS kind of person, here's your feed URL: http://bugs.oni2.net/timeline?format=rss&ticket_details=on. Here is a fancier URL that doesn't give you the source commits, in case you already use WebSVN's RSS feed: http://bugs.oni2.net/timeline?daysback=30&authors=&ticket=on&ticket_details=on&wiki=on&update=Update&format=rss.
     15The '''timeline''' shows the recent commits to Subversion, recent ticket changes, and edits to the wiki. It's an easy way to[[br]]
     16keep your finger on the pulse of the community's projects. If you are an RSS kind of person, [http://bugs.oni2.net/timeline?format=rss&ticket_details=on here's your feed URL].[[br]]
     17[http://bugs.oni2.net/timeline?daysback=30&authors=&ticket=on&ticket_details=on&wiki=on&update=Update&format=rss Here is a fancier URL] that doesn't give you the source commits, in case you already use [http://websvn.chrilly.net/rss.php?repname=Oni2&path=%2F&isdir=1& WebSVN's RSS feed].
    818
    9 Filing '''tickets''' is pretty straight-forward, but one little tip: when you want to attach a file, and you check that little box called "I have files to attach to this ticket"... nothing will happen. Not right then. You have to hit "Create ticket", and ''then'' you will get a chance to attach the file. Now, what this means is that if you wanted to embed an image in your ticket, you have to name the image in your ticket before it even exists on the site. For instance, you would type "Here's the problem I'm having: ![[Image(Screenshot.jpg)]].", check the "I have files" box, hit Create, then upload Screenshot.jpg, and the image should now appear embedded in your ticket. Of course, you could always just go back and modify your ticket to add the image link after uploading the image, but the first way cuts down on edit noise in Trac's history and Timeline.
     19Filing '''tickets''' is pretty straight-forward, but one little tip: when you want to attach a file, and you check that little box[[br]]
     20called "I have files to attach to this ticket"... nothing will happen. Not right then. You have to hit "Create ticket", and ''then''[[br]]
     21you will get a chance to attach the file. Now, what this means is that if you wanted to embed an image in your ticket, you[[br]]
     22have to name the image in your ticket before it even exists on the site. For instance, you would type "Here's the problem[[br]]
     23I'm having: ![[Image(Screenshot.jpg)]].", check the "I have files" box, hit Create, then upload Screenshot.jpg, and the[[br]]
     24image should now appear embedded in your ticket. Of course, you could always just go back and modify your ticket to[[br]]
     25add the image link after uploading the image, but the first way cuts down on edit noise in Trac's history and Timeline.
    1026
    1127Finally, you can read TracBatchModify to learn how to modify more than one ticket at a time.
    1228
    1329== Feel the Gestalt ==
    14 There's a great synergy from having a ticket system tied to a wiki tied to version control, which is that we can type things on the wiki or in tickets like "When are we taking care of ticket:1?" and "I see what you did there in r1" and you get automatic links with hovertext descriptions! Read TracLinks to see all the ways you can interlink the systems.
     30There's a great synergy from having a ticket system tied to a wiki tied to version control, which is that we can type things[[br]]
     31on the wiki or in tickets like "When are we taking care of ticket:1?" and "I see what you did there in r1" and you get[[br]]
     32automatic links with hovertext descriptions! Read TracLinks to see all the ways you can interlink the systems.
    1533
    1634