Textile tutorial

Seeing as the Textile website is down and obviously isn’t coming back, can somebody who knows anything about these forums produce a document on the wiki giving the full format specification? (I see there’s an as yet unused section for ‘Forums’...) I’m starting from zero here, and can’t get help.

I’ve found use of this Textile testing/conversion thing to be pretty helpful.

Edit: This table plugin documentation also came up via a search engine but I can’t get row/col span working like that! However, this reference manual teaches tables with more success!

The quick reference page moved. It’s now here:

http://redcloth.org/hobix.com/textile/quick.html

I keep meaning to update the templates with the new link…

Which now seems to have been done. Thank you!

Blimey. You noticed that quick. I haven’t even checked it in yet… It’s a dodgy modification to the relevant part of the live site without real testing, but it should be safe – it’s just a change of URLs in various places. Hopefully I didn’t make any mistakes during editing!

Some pages in some parts of the site may be cached and might not show the new URL until the server restart at 5:00am GMT.

In addition – sorry for not doing this sooner; I’ve known about the URL change for ages but just didn’t get my finger out. It’s only taken a few minutes now I finally sat down and got on with it.

OK, for those that care, the overall small set of changes is listed here:

https://www.riscosopen.org/tracker/repository/changesets/272

...with the source downloads updated here:

https://www.riscosopen.org/content/downloads/web-site-tarballs

Wondering why many users seem to avoid superscript¹ for notes references, I’m just posting to this thread to see if the superscript referencing does work.

¹ Or is it a 7-bit, 8-bit thing!

Well, it does seem to work, so why don’t people use it. After all, we all have Chars at least!

It seems to work here with Sargasso and  with NetSurf!

The footnote superscript is from [ 1 ] – without the spaces of course.

and then down there¹ you tag with a meaningful fn1 dot, fn2 dot etc

¹ And this is the “down there” :)

Or rather than relying on specific things which may or may not exist in the available character set….

….realise instead ^{that there is an HTML tag to do superscript}! ¹

¹ Unless you mean to have numbered footnotes, that is.

The footnote superscript is from [ 1 ] – without the spaces of course.

What I should have done ¹ was to read the Textile notes ².

¹ Where how to do it is described using up arrows
² The "Textile reference here

 
What I should have done ^1^ was to read the Textile notes ^2^.

^1^ Where how to do it is described using up arrows
^2^ The "Textile reference "here":http://redcloth.org/hobix.com/textile/quick.html
 

Now how to get the initial reference directly after the word with no space!

Now how to get the initial reference directly after the word with no space!

According to the Textile 4 manual, you surround the superscript construct with square brackets.

So instead of example^1^ you would use example[^1^]

Like this: example¹

???

Are you trying to do linked footnote¹ tagging or superscript?
The latter should be an HTML < sup > ^{superscript text} _{subscript text} <— you can guess.

Edit: Basically, it accepts various HTML tags so obscure Textile stuff is often redundant.

¹ Linked footnote, click on the bit up there and you end up looking down here.

Now how to get the initial reference directly after the word with no space!

Why not actually do it the correct way, so that you get a link as well?

This is some text with a footnote[1] after it.

and then

fn1. And this is the footnote.

which results in:

This is some text with a footnote¹ after it.

¹ And this is the footnote.

Basically, it accepts various HTML tags so obscure Textile stuff is often redundant.

But that’s not necessary to do footnotes. The [..] construct sorts out the superscript formatting for you.

I’ve added details to the Forum guide.

But that’s not necessary to do footnotes. The [..] construct sorts out the superscript formatting for you.

Indeed so, and more to the point it’s an actual link to the footnote rather than some random text in superscript that you need to manually scroll down to rather than the express single mouse click action. Oh, and clicking on the fn1 derived tag in the footnote takes you back – a service that isn’t there with the “random superscript”.

Indeed so, and more to the point it’s an actual link

For me, that’s a step too far. I’d rather have a recognisable superscript number and look down the page myself than a spurious full size number with a few dots under it which looks like a typo and (unless of course it was a HeyRick massive post) leaps about! I have a mouse that scrolls nicely in NetSurf anyway!

For me, that’s a step too far. I’d rather have a recognisable superscript number and look down the page myself than a spurious full size number with a few dots under it

I don’t know what you’re doing, by the numbers produced by the two approaches are identical. They are both superscript, but using footnotes results in the additional link bit, too.

I don’t know what you’re doing,

Detecting bugs and deficiencies in NetSurf apparently.

by the numbers produced by the two approaches are identical. They are both superscript, but using footnotes results in the additional link bit, too

Not quite identical. NetSurf renders the code delivered from the server for the link as a number in line instead of superscript and instead of jumping to the link point “fn1” it re-renders hence his comments about

I’d rather have a recognisable superscript number and look down the page myself than a spurious full size number with a few dots under it

Fix required for NetSurf, not the forum. So, if John would care to carefully describe what should be rendered and what is actually rendered for the NetSurf developer(s) it may get fixed. NB. That would be by sending the data to the developers not here.

I think I may test the ability of Otter in that respect.

So, if John would care to carefully describe what should be rendered and what is actually rendered for the NetSurf developer(s) it may get fixed. NB. That would be by sending the data to the developers not here.

Now I understand the nature of the problem, I could do that, where it not for the fact that I have no idea what magic incantations you are using which produce the wrong effect in NetSurf.

I think that this might better be done by someone like you! It seems that you have access to NetSurf even though you do not use it for the ROOL forums.

All I see is the full-size number 1 with some dots under it! How you produce it remains a mystery!

All I see is the full-size number 1 with some dots under it! How you produce it remains a mystery!

This is the magic (found by pressing F8 to view the page source, and doing a search for “with a footnote”)

<p>This is some text with a footnote<sup class="footnote" id="fnr11605348591905180128"><a href="#fn11605348591905180128">1</a></sup> after it.</p> <p class="footnote" id="fn11605348591905180128"><a href="#fnr11605348591905180128"><sup>1</sup></a> And this is the footnote.</p>
and the result:

Validating the whole page as delivered to NetSurf gives 11 errors, a number (3 or 4) of which are to do with the section you quote.

And, of course, what you quote is the result of the Textile interpretation – it still gives me no clues at all as to what that original stuff was that was typed in, the magic itself!

As I’m posting anyway, I just want to check Stuart’s contribution:

According to the Textile 4 manual, you surround the superscript construct with square brackets.

So instead of example^1^ you would use example¹

example¹ followed by example²

So, thank you Stuart. Works a treat!

Validating the whole page as delivered to NetSurf gives 11 errors, a number (3 or 4) of which are to do with the section you quote.

The </p> tag is inside a <td> </td> section, which explains those errors. Firefox says the </p> tag is ignored. That could be confusing Netsurf. However it looks as though Netsurf doesn't handle <sup> tags correctly.

And, of course, what you quote is the result of the Textile interpretation – it still gives me no clues at all as to what that original stuff was that was typed in, the magic itself!

That’s totally irrelevant, however. The issue is what NetSurf is doing with the markup that Alan quoted.

Works a treat!

…but doesn’t give footnotes.