Exporting code samples

Normally, Tinderbox lets you embed html in your notes, and exports that embedded HTML without change.

Sometimes, though, you want to show an example of your HTML (or some other programming language) on a Web page. That means you want the HTML tags to appear as you see them in Tinderbox, i.e. you see the character sequence "<b>", not the effect of bolding some text.

Previously, setting HTMLQuoteHTML to false let you export HTML examples in an entire note. But, sometimes, you want the example to be handled differently than the rest of the note, and v4.1.0 introduced some new features.

• Tinderbox respects the tags <code> and </code> when they appear within notes. HTML between these tags is always encoded so it appears as you see it, instead of being passed unchanged to the browser.
• Tinderbox also respects the tags <pre> and </pre> when they appear within notes. Inside these tags, Tinderbox adds no paragraph formatting and leaves whitespace unchanged; since the intent of the <lt;pre> tag is to allow manual line breaks, adding paragraph markup in this context defeats its purpose.

Setting HTMLQuoteHTML to true will override this feature - so don't mix the two! If it it is set to false and you want to over-ride auto

Note that if you use <code> for a single line sample, you won't emit a wrapping <p> tag as Tinderbox doesn't emit an 'auto-paragraph' if:

• The line beings with a < character
• The line beings with a < character preceded by whitespace (space, tab, etc.)

So, if you want such a single line code example emitted as a separate paragraph, place an option+space at the end of the line after the </code> tag. Tinderbox will detect this and add the <p> tags; even better, if the line starts with a tab it will use your TBX's defined indented-paragraph styling.

Licensed under Creative Commons Attribution-Noncommercial-Share Alike 3.0 License
[See aTbRef CC licence Attribution/Waiver info info]