Help:Custom Retro functions

From Sonic Retro

Sonic Retro deviates from the standard wiki formula with the addition of many new features for marking up wiki pages.

1 Adding Music to a Page
- 1.1 Single Song
- 1.2 Multiple Songs
2 Adding video to a page
3 Using an image to link to a page
4 Syntax Highlighted Code
5 Showing Sonic Retro posts

Adding Music to a Page

Single Song

When adding a single song to a page, use the <flashmp3> tag, which displays a small mp3 player. Do not use encoded URLs, and please limit your song linking to music on the Retro server--to use other sites' music is leeching and generally not kosher.

For instance, to display a song from the AlbumDump, use:

<flashmp3>http://albums.sonicretro.org/Seven Rings in Hand/Adventure Disc/103 LET THE SPEED MEND IT.mp3</flashmp3>

This will show

Multiple Songs

When adding multiple songs to a page, use the <mp3> tag instead. It is similar to the flashmp3 tag, but cuts off music when focus is taken off the page, thus saving bandwidth.

Using <mp3>http://albums.sonicretro.org/Seven Rings in Hand/Adventure Disc/112 UNAWAKENING FLOAT.mp3</mp3>

Displays

Adding video to a page

In order to use video in an article, you will need to use the <flowplayer> tag to bring up a video player. Note that videos must be in FLV format. Larger videos will need to be uploaded by an administrator. You can define the height and width of the video if necessary, with the default resolution being 320x240.

Using <flowplayer>Image:Sonic Drift Japanese Commercial.flv</flowplayer>

Displays

Using an image to link to a page

When adding images to a page, clicking on an image will generally bring up that image's Image page. If you want an image to link to a page, use the <iimg> tag.

iimg tags are set up in the <iimg>[[Link]]![[Image:image.png]]</iimg> format. For instance, using <iimg>[[Hedgehog]]![[Image:Hedgehog.jpg]]</iimg> will generate the image link

Syntax Highlighted Code

To have your code marked up in an article, use either the <asm> tag (for m68k ASM) or <z80> tag (for Z80 ASM). Simply include the tags around a section of code to display something like

 
EntryPoint:
		tst.l	($A10008).l	; test port A control
		bne.s	PortA_Ok
		tst.w	($A1000C).l	; test port C control
 
PortA_Ok:
		bne.s	PortC_Ok
		lea	SetupValues(pc),a5
		movem.w	(a5)+,d5-d7
		movem.l	(a5)+,a0-a4
		move.b	-$10FF(a1),d0	; get hardware version
		andi.b	#$F,d0
		beq.s	SkipSecurity
		move.l	#'SEGA',$2F00(a1)
 
SkipSecurity:
		move.w	(a4),d0		; check	if VDP works
		moveq	#0,d0
		movea.l	d0,a6
		move.l	a6,usp		; set usp to $0
		moveq	#$17,d1

Showing Sonic Retro posts

Single Sonic Retro forum posts can be displayed by using the <ipbwiki_post> tag. In order to display a post, you will need that post's ID number. To find a post's ID number, find the Post #10 or similar in the top-right corner of a post. The URL on the number's link will have a p= on the end. Use this number to enter the post number you would like to display.

For instance, post number 159080 can be displayed by using <ipbwiki_post post=159080/>:

Neo Chaotikal	Jan 12 2007, 01:22 PM Post #159080
	This particular 128x128 chunk is used in the layout for Emerald Hill Zone 2 in the drx proto, but is unused in both the Wai proto and final version. On another note, the parallax calculations used for the Emerald Hill Zone background in the drx proto are different to those of both the Wai proto and final version, and the outcome is a much less fluid graphical scroll.