RISC OS Open
Safeguarding the past, present and future of RISC OS for everyone
ROOL
Home | News | Downloads | Bugs | Bounties | Forum | Documents | Photos | Contact us
Account
Forums → Wish lists →

Textile tutorial

Subscribe to Textile tutorial 54 posts, 12 voices

Posts per page:

Pages: 1 2 3

 
Feb 8, 2010 8:32pm
Avatar Martin Bazley (331) 379 posts

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.

 
Feb 8, 2010 9:10pm
Avatar Trevor Johnson (329) 1645 posts

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!

 
Feb 8, 2010 9:47pm
Avatar Andrew Hodgkinson (6) 451 posts

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…

 
Feb 8, 2010 9:51pm
Avatar Martin Bazley (331) 379 posts

Which now seems to have been done. Thank you!

 
Feb 8, 2010 9:54pm
Avatar Andrew Hodgkinson (6) 451 posts

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.

 
Feb 8, 2010 9:54pm
Avatar Andrew Hodgkinson (6) 451 posts

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.

 
Feb 8, 2010 10:07pm
Avatar Andrew Hodgkinson (6) 451 posts

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

 
Nov 13, 2020 11:07pm
Avatar John WILLIAMS (8368) 446 posts

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!

 
Nov 13, 2020 11:42pm
Avatar Steve Pampling (1551) 7463 posts

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

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

1 And this is the “down there” :)

 
Nov 13, 2020 11:42pm
Avatar Rick Murray (539) 12530 posts

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! 1

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

 
Nov 14, 2020 9:34am
Avatar John WILLIAMS (8368) 446 posts

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

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

 
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!

 
Nov 14, 2020 9:53am
Avatar Stuart Painting (5389) 616 posts

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: example1

 
Nov 14, 2020 10:01am
Avatar Steve Pampling (1551) 7463 posts

???

Are you trying to do linked footnote1 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.

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

 
Nov 14, 2020 10:09am
Avatar Steve Fryatt (216) 1866 posts

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 footnote1 after it.

1 And this is the footnote.

 
Nov 14, 2020 10:13am
Avatar Steve Fryatt (216) 1866 posts

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.

 
Nov 14, 2020 10:21am
Avatar Steve Fryatt (216) 1866 posts

I’ve added details to the Forum guide.

 
Nov 14, 2020 11:19am
Avatar Steve Pampling (1551) 7463 posts

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”.

 
Nov 14, 2020 3:16pm
Avatar John WILLIAMS (8368) 446 posts

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!

 
Nov 14, 2020 3:55pm
Avatar Steve Fryatt (216) 1866 posts

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.

 
Nov 14, 2020 4:46pm
Avatar Steve Pampling (1551) 7463 posts

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.

 
Nov 15, 2020 10:06am
Avatar John WILLIAMS (8368) 446 posts

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!

 
Nov 15, 2020 10:27am
Avatar Alan Adams (2486) 1032 posts

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:

 
Nov 15, 2020 11:55am
Avatar John WILLIAMS (8368) 446 posts

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 example1

example1 followed by example2

So, thank you Stuart. Works a treat!

 
Nov 15, 2020 12:03pm
Avatar Alan Adams (2486) 1032 posts

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.

 
Nov 15, 2020 12:26pm
Avatar Steve Fryatt (216) 1866 posts

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.

Next page

Pages: 1 2 3

Reply

To post replies, please first log in.

Forums → Wish lists →

Search forums

Social

Follow us on and

ROOL Store

Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.

Donate! Why?

Help ROOL make things happen – please consider donating!

RISC OS IPR

RISC OS is an Open Source operating system owned by RISC OS Developments Ltd and licensed primarily under the Apache 2.0 license.

Description

What would you like to see written or changed?

Voices

  • Martin Bazley (331)
  • Trevor Johnson (329)
  • Andrew Hodgkinson (6)
  • John WILLIAMS (8368)
  • Steve Pampling (1551)
  • Rick Murray (539)
  • Stuart Painting (5389)
  • Steve Fryatt (216)
  • Alan Adams (2486)

Options

  • Forums
  • Login
Site design © RISC OS Open Limited 2018 except where indicated
The RISC OS Open Beast theme is based on Beast's default layout

Valid XHTML 1.0  |  Valid CSS

Powered by Beast © 2006 Josh Goebel and Rick Olson
This site runs on Rails

Hosted by Arachsys