From fc50dbdc3c15e0e8ad144fbd11c8524bce1a0f1f Mon Sep 17 00:00:00 2001 From: MikeMannix Date: Mon, 3 Dec 2001 04:11:51 +0000 Subject: none --- TWiki/TextFormattingRules.mdwn | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) (limited to 'TWiki') diff --git a/TWiki/TextFormattingRules.mdwn b/TWiki/TextFormattingRules.mdwn index 1abdca91..84bbdf4b 100644 --- a/TWiki/TextFormattingRules.mdwn +++ b/TWiki/TextFormattingRules.mdwn @@ -257,11 +257,20 @@ Know.ReadmeFirst ## Using HTML -You can use just about any HTML tag without a problem - however, to keep in mind: +You can use just about any HTML tag without a problem - however, there are a few usability and technical considerations to keep in mind. + +### HTML and TWiki Usability * On collaboration pages, it's preferable NOT to use HTML, and to use TWiki shorthand instead - this keeps the text uncluttered and easy to edit. - * **_NOTE:_** TWiki converts shorthand notation to XHTML 1.0 for display. To copy a fully marked-up page, simply view source in your browser and save the contents. - * **_NOTE:_** The standard installation TWiki is compatible across a wide range of browsers and computer platforms. If this is important to you, remember that using browser-specific tags or any other mark-up that doesn't degrade well will reduce compatibility. +* %X% **NOTE:** TWiki is designed to work with a wide range of browsers and computer platforms, holding to HTML 3.2 compatibility in the standard installation - adding raw HTML, particularly browser-specific tags (or any other mark-up that doesn't degrade well) will reduce compatibility. + +### TWiki HTML Rendering + +* TWiki converts shorthand notation to XHTML 1.0 for display. To copy a fully marked-up page, simply view source in your browser and save the contents. + * %T% If you need to save HTML frequently, you may want to check out TWiki:Plugins/GenHTMLAddon - it will "generate a directory containing rendered versions of a set of TWiki pages together with any attached files." +* %X% **NOTE:** The opening and closing angle brackets - **<...>** - of an HTML tag **_must be on the same line_**, or the tag will be broken. + * This feature allows you to enter an unclosed angle bracket - as a greater than or less than symbol - and have it automatically rendered as if you had entered its HTML character, `<`, ex: **a > b** + * %T% If you're pasting in preformatted HTML text and notice problems, check the file in a text processor with no text wrap. Also, save without hard line breaks on text wrap, in your HTML editing program. ## Hyperlinks -- cgit v1.2.3