summaryrefslogtreecommitdiff
path: root/raw-wiki-dump/WikiHtml
diff options
context:
space:
mode:
authorRob Austein <sra@hactrn.net>2020-09-13 23:06:24 +0000
committerRob Austein <sra@hactrn.net>2020-09-13 23:06:24 +0000
commit891730d13b324fad916572a82f0bd610c5de9aad (patch)
treef46c94ddfff34f15aafe7cac0596716d1c13c412 /raw-wiki-dump/WikiHtml
parentb092ffbcbe2c9398494f7dc9db6f0796971633e0 (diff)
Rename for conversion
Diffstat (limited to 'raw-wiki-dump/WikiHtml')
-rw-r--r--raw-wiki-dump/WikiHtml337
1 files changed, 0 insertions, 337 deletions
diff --git a/raw-wiki-dump/WikiHtml b/raw-wiki-dump/WikiHtml
deleted file mode 100644
index 3e16327..0000000
--- a/raw-wiki-dump/WikiHtml
+++ /dev/null
@@ -1,337 +0,0 @@
-= Using HTML in Wiki Text =
-
-Trac supports the display of HTML in any wiki context, by using the `#!html` [wiki:WikiProcessors WikiProcessor].
-
-However, this HTML has to be [http://en.wikipedia.org/wiki/Well-formed_element well-formed].
-In particular, you can't insert a start tag in an `#!html` block, resume normal wiki text and insert the corresponding end tag in a second `#!html` block.
-
-Fortunately, for creating styled <div>s, <span>s or even complex tables containing arbitrary Wiki text, there is a powerful alternative: `#!div`, `#!span` and `#!table`, `#!tr`, `#!td` and `#!th` blocks. Those Wiki processors are built-in and do not require additional packages to be installed.
-
-== How to use `#!html` == #HowtoUseHTML
-To inform the wiki engine that a block of text should be treated as HTML, use the ''html'' processor:
-
-||= Wiki Markup =||= Display =||
-{{{#!td
- {{{
- {{{
- #!html
- <h1 style="text-align: right; color: blue">HTML Test</h1>
- }}}
- }}}
-}}}
-{{{#!td style="padding-left: 2em"
- {{{
- #!html
- <h1 style="text-align: right; color: blue">HTML Test</h1>
- }}}
-}}}
-
-Note that Trac sanitizes your HTML code before displaying it. That means that potentially dangerous constructs, such as Javascript event handlers, will be removed from the output.
-
-The filtering is done by [http://genshi.edgewall.org/ Genshi] and the output will be a well-formed fragment of HTML. This means that you can no longer use two HTML blocks, one for opening a <div> and another for closing it, in order to wrap arbitrary wiki text.
-The new way to wrap any wiki content inside a <div> is to use the `#!div` Wiki processor.
-
-== How to use `#!div` and `#!span` == #HowtoUseDivSpan
-
-||= Wiki Markup =||= Display =||
-{{{#!td
- {{{
- {{{
- #!div class="important"
- **important** is a predefined class.
- }}}
- }}}
- {{{
- {{{
- #!div style="border: 1pt dotted; margin: 1em"
- **wikipage** is another predefined class that will
- be used when no class is specified.
- }}}
- }}}
- {{{
- {{{
- #!div class="compact" style="border: 1pt dotted; margin: 1em"
- **compact** is another predefined class reducing
- the padding within the `<div>` to a minimum.
- }}}
- }}}
- {{{
- {{{
- #!div class="wikipage compact" style="border: 1pt dotted"
- Classes can be combined (here **wikipage** and **compact**)
- which results in this case in reduced //vertical//
- padding but there's still some horizontal space for coping
- with headings.
- }}}
- }}}
- {{{
- {{{
- #!div class="" style="border: 1pt dotted; margin: 1em"
- Explicitly specifying no classes is //not// the same
- as specifying no class attribute, as this will remove
- the //wikipage// default class.
- }}}
- }}}
-}}}
-{{{#!td style="padding-left: 2em"
-
- {{{
- #!div class="important"
- **important** is a predefined class.
- }}}
-
- {{{
- #!div style="border: 1pt dotted; margin: 1em"
- **wikipage** is another predefined class that will
- be used when no class is specified.
- }}}
-
- {{{
- #!div class="compact" style="border: 1pt dotted; margin: 1em"
- **compact** is another predefined class reducing
- the padding within the `<div>` to a minimum.
- }}}
-
- {{{
- #!div class="wikipage compact" style="border: 1pt dotted"
- Classes can be combined (here **wikipage** and **compact**)
- which results in this case in reduced //vertical//
- padding but there's still some horizontal space for coping
- with headings.
- }}}
-
- {{{
- #!div class="" style="border: 1pt dotted; margin: 1em"
- Explicitly specifying no classes is //not// the same
- as specifying no class attribute, as this will remove
- the //wikipage// default class.
- }}}
-
-}}}
-
-Note that the contents of a `#!div` block are contained in one or more paragraphs, which have a non-zero top and bottom margin. This leads to the top and bottom padding in the example above. To remove the top and bottom margin of the content, add the `compact` class to the `#!div`. Another predefined class besides `wikipage` and `compact` is `important`, which can be used to make a paragraph stand out. Extra CSS classes can be defined via the `site/style.css` file for example, see TracInterfaceCustomization#SiteAppearance.
-
-For spans, you should use the Macro call syntax:
-||= Wiki Markup =||
-{{{#!td
- {{{
- Hello
- [[span(''WORLD'' (click [#anchor here]), style=color: green; font-size: 120%, id=anchor)]]!
- }}}
-}}}
-|---------------------------------------------------------------------------------
-||= Display =||
-{{{#!td style="padding-left: 2em"
- Hello
- [[span(''WORLD'' (click [#anchor here]), style=color: green; font-size: 120%, id=anchor)]]!
-}}}
-
-== How to use `#!td` and other table related processors == #Tables
-
-The `#!td` or `#!th` processors should be used to create table data and table header cells, respectively. The other processors `#!table` and `#!tr` are not required for introducing a table structure, as `#!td` and `#!th` will do this automatically. The `|-` row separator can be used to start a new row when needed, but some may prefer to use a `#!tr` block for that, as this introduces a more formal grouping and offers the possibility to use an extra level of indentation. The main purpose of the `#!table` and `#!tr` is to give the possibility to specify HTML attributes, like ''style'' or ''valign'' to these elements.
-
-||= Wiki Markup =||= Display =||
-{{{#!td
- {{{
- Simple 2x2 table with rich content:
- {{{#!th align=left
- - Left
- - Header
- }}}
- {{{#!th align=left
- - Right
- - Header
- }}}
- |----------------------------------
- {{{#!td style="background: #ffd"
- - Left
- - Content
- }}}
- {{{#!td style="vertical-align: top"
- !RightContent
- }}}
- |----------------------------------
- || ... and this can be mixed||\
- ||with pipe-based cells ||
- {{{#!td colspan=2
- Pick the style the more appropriate
- to your content
-
- See WikiFormatting#Tables for details
- on the pipe-based table syntax.
- }}}
-
- If one needs to add some
- attributes to the table itself...
-
- {{{
- #!table style="border:none;text-align:center;margin:auto"
- {{{#!tr ====================================
- {{{#!th style="border: none"
- Left header
- }}}
- {{{#!th style="border: none"
- Right header
- }}}
- }}}
- {{{#!tr ==== style="border: 1px dotted grey"
- {{{#!td style="border: none"
- 1.1
- }}}
- {{{#!td style="border: none"
- 1.2
- }}}
- }}}
- {{{#!tr ====================================
- {{{#!td style="border: none"
- 2.1
- }}}
- {{{#!td
- 2.2
- }}}
- }}}
- }}}
-
-
- }}}
-}}}
-{{{#!td valign=top
-Simple 2x2 table with rich content:
-{{{#!th align=left
- - Left
- - Header
-}}}
-{{{#!th align=left
- - Right
- - Header
-}}}
-|----------------------------------
-{{{#!td style="background: #ffd"
- - Left
- - Content
-}}}
-{{{#!td style="vertical-align: top"
-!RightContent
-}}}
-|----------------------------------
-|| ... and this can be mixed||\
-||with pipe-based cells ||
-{{{#!td colspan=2
-Pick the style the more appropriate
-to your content
-
-See WikiFormatting#Tables for details
-on the pipe-based table syntax.
-}}}
-
-If one needs to add some
-attributes to the table itself...
-
-{{{
-#!table style="border:none;text-align:center;margin:auto"
- {{{#!tr ====================================
- {{{#!th style="border: none"
- Left header
- }}}
- {{{#!th style="border: none"
- Right header
- }}}
- }}}
- {{{#!tr ==== style="border: 1px dotted grey"
- {{{#!td style="border: none"
- 1.1
- }}}
- {{{#!td style="border: none"
- 1.2
- }}}
- }}}
- {{{#!tr ====================================
- {{{#!td style="border: none"
- 2.1
- }}}
- {{{#!td
- 2.2
- }}}
- }}}
-}}}
-}}}
-
-Note that by default tables are assigned the "wiki" CSS class, which gives a distinctive look to the header cells and a default border to the table and cells, as can be seen for the tables on this page. By removing this class (`#!table class=""`), one regains complete control on the table presentation. In particular, neither the table nor the rows nor the cells will have a border, so this is a more effective way to get such an effect rather than having to specify a `style="border: no"` parameter everywhere.
-
-{{{#!table class=""
-||= Wiki Markup =||= Display =||
- {{{#!td
- {{{
- {{{#!table class=""
- || 0|| 1|| 2||
- || 10|| 20|| 30||
- || 11|| 22|| 33||
- ||||||= numbers =||
- }}}
- }}}
- }}}
- {{{#!td
- {{{#!table class=""
- || 0|| 1|| 2||
- || 10|| 20|| 30||
- || 11|| 22|| 33||
- ||||||= numbers =||
- }}}
- }}}
-}}}
-
-Other classes can be specified as alternatives (remember that you can define your own in [TracInterfaceCustomization#SiteAppearance site/style.css]).
-
-||= Wiki Markup =||= Display =||
-{{{#!td
- {{{
- {{{#!table class="listing"
- || 0|| 1|| 2||
- || 10|| 20|| 30||
- || 11|| 22|| 33||
- ||||||= numbers =||
- }}}
- }}}
-}}}
-{{{#!td
- {{{#!table class="listing"
- || 0|| 1|| 2||
- || 10|| 20|| 30||
- || 11|| 22|| 33||
- ||||||= numbers =||
- }}}
-}}}
-
-== HTML comments ==
-HTML comments are stripped from the output of the `html` processor. To add an HTML comment to a wiki page, use the `htmlcomment` processor, available since Trac 0.12:
-||= Wiki Markup =||
-{{{#!td
- {{{
- {{{
- #!htmlcomment
- This block is translated to an HTML comment.
- It can contain <tags> and &entities; that will not be escaped in the output.
- }}}
- }}}
-}}}
-|---------------------------------------------------------------------------------
-||= Display =||
-{{{#!td
- {{{
- <!--
- This block is translated to an HTML comment.
- It can contain <tags> and &entities; that will not be escaped in the output.
- -->
- }}}
-}}}
-
-Please note that the character sequence "`--`" is not allowed in HTML comments, and will generate a rendering error.
-
-
-== More Information ==
-
- * http://www.w3.org/ -- World Wide Web Consortium
- * http://www.w3.org/MarkUp/ -- HTML Markup Home Page
-
-----
-See also: WikiProcessors, WikiFormatting, WikiRestructuredText