~kosova/+junk/tuxfamily-twiki

« back to all changes in this revision

Viewing changes to foswiki/data/System/UsingHTML.txt

  • Committer: James Michael DuPont
  • Date: 2009-07-18 19:58:49 UTC
  • Revision ID: jamesmikedupont@gmail.com-20090718195849-vgbmaht2ys791uo2
added foswiki

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
%META:TOPICINFO{author="ProjectContributor" date="1231502400" format="1.1" version="1"}%
 
2
---++ Using HTML
 
3
 
 
4
%STARTINCLUDE%
 
5
You can use most HTML tags in topics without a problem. This is useful where you want to
 
6
add some content that is formatted in a way that is not supported using [[ShortHand][shorthand]], for example,
 
7
you can write =&lt;strike&gt;deleted text&lt;/strike&gt;= to get <strike>deleted text</strike>.
 
8
 
 
9
There are a few usability and technical considerations to keep in mind:
 
10
   * On collaboration pages, it's better *not* to use HTML, but to use [[ShortHand][shorthand]] instead -
 
11
     this keeps the text uncluttered and easy to edit using the plaintext editor.
 
12
   * If you _must_ use HTML, use [[http://www.w3.org/TR/xhtml1/][XHTML 1.0 Transitional]] syntax.
 
13
   * Use =&lt;literal&gt;..&lt;/literal&gt;= tags around blocks of HTML to avoid accidental interpretation of
 
14
     [[ShortHand][shorthand]] within the HTML.
 
15
   * %X% Script tags may be filtered out, at the discretion of your Wiki administrator.
 
16
 
 
17
Recommendations when pasting HTML from other sources (using the plain-text editor):
 
18
   * Copy only text between =&lt;body&gt;= and =&lt;/body&gt;= tags.
 
19
   * Remove all empty lines. Foswiki inserts =&lt;p /&gt;= 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.
 
20
   * Remove leading spaces. Foswiki might interpret some text as lists.
 
21
   * Do not span a tag over more than one line. Foswiki requires that the opening and closing angle brackets - ==&lt;...&gt;== - of a HTML tag are on the same line, or the tag will be broken.
 
22
   * In your HTML editing program, save without hard line breaks on text wrap.
 
23
 
 
24
When using a WYSIWYG editor, you can just copy-paste directly into the editor, and the content will
 
25
be converted to [[ShortHand][shorthand]] automatically when you save.
 
26
 
 
27
%STOPINCLUDE%