none
[openafs-wiki.git] / TWiki / UsingHTML.mdwn
1 ## <a name="Using HTML"></a> Using HTML
2
3 You can use just about any HTML tag without a problem. You can add HTML if there is no TWiki equivalent, for example, write `<strike>deleted text</strike>` to get <strike>deleted text</strike>.
4
5 %X% There are a few usability and technical considerations to keep in mind:
6
7 - On collaboration pages, it's better **not** to use HTML, but to use [[TWiki shorthand|Main/WebHome#TWikiShorthand]] instead - this keeps the text uncluttered and easy to edit.
8 - If you use HTML use [XHTML 1.0 Transitional](http://www.w3.org/TR/xhtml1/) syntax.
9 - %X% Script tags may be filtered out, at the discretion of your TWiki administrator.
10
11 Recommendations when pasting HTML from other sources:
12
13 - Copy only text between `<body>` and `</body>` tags.
14 - Remove all empty lines. TWiki inserts `<p />` paragraph tags on empty lines, which causes problems if done between HTML tags that do not allow paragraph tags, like for example between table tags.
15 - Remove leading spaces. TWiki might interpret some text as lists.
16 - Do not span a tag over more than one line. TWiki requires that the opening and closing angle brackets - <code>**&lt;...&gt;**</code> - of an HTML tag are on the same line, or the tag will be broken.
17 - In your HTML editing program, save without hard line breaks on text wrap.
18
19 %T% TWiki converts shorthand notation to HTML for display. To copy a fully marked-up page, simply view the source in your browser and save the contents. If you need to save HTML frequently, you may want to check out TWiki:Plugins/PublishAddOn.