Logged in as

Formatting modifiers

This section demonstrates the use of "modifiers", or in other words nesting inline tags such as , and inside outer elements to modify the default rendering, using simple CSS rules that render on all browsers.

Using these simple tags makes it easy to modify existing formatting just by using normal keyboard shortcuts like CTRL+B or CTRL+I within a WYSIWYG HTML editor.

In this way, wiki users can easily affect the wiki output by using standard formatting, without resorting to custom HTML markup or more complex Textile {attribute:modifiers}, but are still able to use them if they choose.

Note that these CSS rules only modify tags which would otherwise have little or no effect from the inline tags - for example headings are already bold, bold text doesn't display in Courier, and italics are usually lost.

In paragraph text, bold, italic and underline formats still behave as expected.

Heading modifiers

A standard heading

A standard H3 heading

This is the standard H3 heading, which is useful to highlight method signatures

h3. A standard H3 heading


A standard H3 heading

Modified headings

An H3 heading with bold text in it

This is an H3 heading with bold tags to make red text, which could be useful to highlight method names in long API pages.

h3. An H3 heading with *bold text* in it


An H3 heading with bold text in it

An H3 heading with italic text in it

This is an H3 heading with italic tags to make blue text, which might be used as alternative coloring, or to highlight property names.

h3. An H3 heading with _italic text_ in it


An H3 heading  italic text in it

An H3 heading with underlining

This is useful when you want to override the default operation of an H3 heading, to make it behave more like a section break.

h3. +An H3 heading with underlining+


An H3 heading  with underlining

Formatting modifiers

Code blocks

The following example shows highlighted code by nesting and tags inside 

 blocks.

          
// a highlighted comment, using the  tag

    function format_date($value, $index, $key)
    {
        return date('l jS F, $value);
    }

// a highlighted function, using the  tag

    function format_row($index, $table, $body, $rows, $data)
    {
        if($data['zebra_index']++ % 2 == 0)
        {
            return new Tr('', 'zebra'); // a highlighted highlight, nesting  inside 
        }
    }


          
Unfortunately Redmine Wiki doesn't parse the HTML inside pre-blocks, but the presence of the CSS rules has no negative consequences.

          
Perhaps there is a config file that can be adjusted?