ReTxt2tags: about, details, sampler, Original txt2tags sample, issues

Options and other technical details

Disclamer: As the reTxt2tags tool is derived from reMarkdown CSS, most of the original details are no longer relevant.

You can trigger a number of options using specific classes. You can declare those classes on the same element you used to declare rt2t-on, on sub-containers, or on the targetted elements themselves. The stylesheet is rather flexible.

Available options

Important notes on option classes:

  1. Words in the class name are always singular: “bracket”, not “brackets”.
  2. Each option class has an equivalent which can be used on the affected element itself, and which omits the element name, e.g. rmd-underscore on strong elements, rmd-showurl on links, etc.

Note that the rmd-a-printref option needs the rmd-print.js script. The script generates an invisible list of URLs at the end of each container with this class, and the print styles reveal this list when printing the page.

Example code

<!doctype html>
<html lang="en">
<head>
  <title>Using ReTxt2tags</title>
  <link rel="stylesheet" href="retxt2tags.css">
</head>
<body>
<nav>
  Site navigation
</nav>
<article class="rt2t-on rmd-h1-underline rmd-link-footnote rmd-hr-center">
  <h1 class="rmd-uppercase">Hello World</h1>
  <p>Goodnight, and <a href="/l/">good luck</a>.</p>
  <hr>
  <p>More content.</p>
</article>
<script src="rmd-print.js"></script>
</body>
</html>

For more examples of how you can use ReTxt2tags classes, see the sampler page and take a look at the source code. Note that it’ll probably be easier to set all option classes on one container element, rather than on individual elements.

How does it work exactly?

The gist of it:

There are a few special cases, such as underlined titles, block quotes, ordered lists, and print styles for links. Do read retxt2tags.css if you speak CSS and want to know more.

Note that there is a number of known issues.