Text Formatting

Also available in Deutsch, Espanol, Français, Polski, Russian.


See also: Actions


Wacko text formatting is slightly different from other wikis, so you should read the examples below.
You can experiment with the Wiki Markup in the SandBox.
Text enclosed in pairs of double quotes is not formatted and remains unchanged when displayed.


source displayed

1. Table of contents


{{toc numerate=1}}


detailed description...

NB: if you are using this with the 'include' plugin, but don't want the headers that you're pulling in from the include file to be listed in the generated table of contents, use the 'notoc' option like so:


{{include page="Formatting/Headlines" notoc=1}}

2. Basic Formatting

**bold**
bold
//italic//
italic
__underline__
underline
##code##
code
--strikethrough--
strikethrough
++small++
small text
!!note!!
(also ''note'', but it is better not to use it).
note
!!(blue) blue color!!
blue color
!!(green) green color!!
red color
!!(red) red color!!
red color
??emphasis??
emphasis
??(blue)emphasis??
emphasis
??(red)emphasis??
emphasis
??(green)emphasis??
emphasis
%%Embed code%%
int main(int arc,char **argv)
{
    printf("Hello, %s!\n", (argc>1) ? argv[1] : "World");
    return 0;
}

NB Strikethrough, like all formattings below (in this chapter), are multiline. All previous formattings are not multiline because we going to make formatting that doesn't break your texts.

3. Alignment

The alignment is carried out with the help of such a complex structure:


default
left
%%(wacko wrapper=text wrapper_align=center) center%%
center
%%(wacko wrapper=text wrapper_align=right) right%%
right
%%(wacko wrapper=text wrapper_align=justify) justify%%
justify

wrapper_align can be center, right or justify.

4. Links

4.1. External Links

[[http://wackowiki.org WackoWiki]] or ((http://wackowiki.org WackoWiki))
WackoWiki
http://wackowiki.org is highlighted automatically.
http://wackowiki.org
PPR:OneMinuteWiki
InterWiki linking
PPR:OneMinuteWiki
mailto:address@example.com
((address@example.com))
email.
mailto:address@example.com
address@example.com
xmpp:adresse@example.com
Jabber.
xmpp:adresse@example.com
((https://example.com/archive.zip Archive (zip) ))
https://example.com/archive.zip
Archive (zip)
https://example.com/archive.zip

4.2. Internal Links

[[SandBox]] or ((SandBox))
SandBox
[[SandBox The sandbox page]]
or ((SandBox The sandbox page))
The sandbox page
https://www.google.com/images/google_sm.gif
Image with no link.

((/HomePage https://www.google.com/images/google_sm.gif))
Image with a link.
https://www.google.com/images/google_sm.gif
{{anchor href="test"}}
anchor declaration.

((#test)) or ((/HomePage#TOC_1))
anchor reference.
test or /HomePage#TOC_1

NB: mixed case words (LikeThis) do not need to be enclosed in brackets. For internal links (inside this Wiki), the complete URL should not be written
(otherwise the link will not work). Add "http://" only for external links.


NB: To prevent a WordLikeThis from becoming a link, place a ~ (tilde) in front of it.


NB: You can also link to non BumpyText words using: ((Cluster here)) = here.


TH: How do you use a link to a local file with spaces in it? (e.g.: "S:\Network Drive\File 1.txt" or "//server1\file name.txt")


RF: To link to local files on a server with spaces like that, use file:/// and switch all backslashes to forward slashes. Also, replace any spaces with %20, so your link would become "file://///server1/file%20name.txt" Also, there is an issue with linking to local files on Firefox: Solution

5. Including uploaded files

file:/mammut_mascot.jpg
checks only for global file
file:mammut_mascot.jpg
checks first for local then global file
file:/Subpage/archive.zip
absolute path for local file, necessary for files in included pages
The file must already be uploaded.


detailed description...

mammut mascot
file:/Subpage/archive.zip

6. Headlines


== Primary Heading ==

(2) Primary Heading


=== Secondary Heading ==

(3) Secondary Heading

==== Tertiary Heading ==

(4) Tertiary Heading

===== Small Heading ==

(5) Small Heading

====== Even Smaller Heading ==
(6) Even Smaller Heading

======= Smallest Heading ==
(7) Smallest Heading

Note: Right of the Heading it does not require the same number of "=" characters, it suffice two "=" signs.
The ==Primary Heading== is usually set with the page title and is by default not included in the table of content.

7. Bulleted and Numbered Lists


Indent lists with tabs or double spaces, and use *, 1., A., a., or i. to specify the type of list you want.
Lists:
  first line
    indented line
----
  * bullet list
  * bullet list-2
----
  1. numbered list
  1. numbered list-2
  2.#8 numbered list, with transition
----
  A. using upper case characters
  A. using upper case characters-2
----
  a. using lower case characters
  a. using lower case characters-2
----
  i. using Roman numbers
  i. using Roman numbers-2
----
  1. list
    1. nested list
      * and even more nested list
    1. nested list 2
  2. list 2

Lists:

first line
indented line

  • bullet list
  • bullet list-2

  1. numbered list
  2. numbered list-2
  3. numbered list, with transition

  1. using upper case characters
  2. using upper case characters-2

  1. using lower case characters
  2. using lower case characters-2

  1. using Roman numbers
  2. using Roman numbers-2

  1. list
    1. nested list
      • and even more nested list
    2. nested list 2
  2. list 2

8. Cite and definitions

<[ Citation of text
(blockquote) ]>

Citation of text
(blockquote)

(?Term Some definition?)
Term
(?Term containing spaces == Some other definition?)
Term containing spaces

9. Footnotes

Text, then footnote[[*]] and second one[[**]]
Text, then footnote* and second one**
Text, then numeric footnote[[*1]] and second one[[*2]]
Text, then numeric footnote1 and second one2
[[#*]] Text for first footnote
[[#**]] Text for second footnote
[[#1]] Text for numeric footnote
[[#2]] Text for second numeric footnote
* Text for first footnote
** Text for second footnote
1 Text for numeric footnote
2 Text for second numeric footnote

auto-generated footnotes
[[fn text of footnote here]]
generates the footnotes at the end of the page, see example

10. Tables


Table with border
#|
*|header 1|header 2|header 3|*
||cell11|cell12|cell13||
||cell21|cell22||
|#


header 1header 2header 3
cell11cell12cell13
cell21cell22

Table without border, 100% width
#||
||cell11|cell12|cell13||
||cell21|cell22||
||#


cell11cell12cell13
cell21cell22

Note: You can also create tables using HTML code if allowed.

11. Miscellaneous


Horizontal rule (separator):
----



Forced line break:
test---new line
test
new line


Forced empty line:
---"" ""---


Text output "as-is" — ignoring markup
Text should be enclosed by a pair of double quotes, e.g. ""test---new line"". You can look at the source of this page for numerous examples.
Furthermore, for the screening of any form of marking, it is possible to use  ~ (tilde).

12. Inline HTML

HTML output "as-is"
this works only if site the admin allows it.


<# <input type="text"/> #>
<# <input type="text"/> #>


If you see <input type="text"/> instead of the input field, the site admin don't turn up this function (config parameter: allow_rawhtml).
NB: It is very dangerous option, avoid XSS!).

13. Special Character

The automatic proofreader built into the wiki automatically adjusts the saved text to the formatting norms, saving the authors from excessively detailed editing. Here are the changes he makes:

Superscript
E=mc^^2^^
E=mc2
Subscript Insert spaces before and after vv.
H vv2vv O
2 O
Additional
^F °F
^C °C
(p) §
(tm)
(c) ©
(r) ®
+- ±
~~ ~

14. Macros


Macros are little shortcuts which automatically update the document you're writing with relevant variables such as your name and wikiname, the date of writing etc. Basically, they're just little text shortcuts.


To automatically insert your name, use:
::::
RomanIvanov


Auto name and date:
::@::
RomanIvanov /20.06.2003 18:13/


Date:
::+::
20.06.2003 18:13

15. Code and Syntax highlighting

WackoWiki is easily extended with text formatters. They are called using syntax %%(name) text%%.
There are several formatters included in Wacko package:

%%(wacko)The text as it is. ((/HomePage))%%
This format displays the text in the same way as if it was written without a formatter. Convenient for applying additional wrappers to text (alignment, boxes, etc. See below.)
The text as it is. /HomePage
%%(php) PHP-code%%


<?php
phpinfo
();
$s "Hello, World!\n";
print 
"$s";
?>

Attention: that code should begin with <?php ?>, because builtin PHP parser identifies PHP by those separators.
%%(comment) Comments, they will be hidden when the page is stored and redisplayed %%

%%(noautolinks) no AutoLinks if CamelCase-Words%%
no AutoLinks if CamelCase-Words

%%(cl)zypper dup --no-recommends%%
zypper dup --no-recommends


%%(email) Email%%
Hi!
RI>> Yes, it is.
>Are you sure?

Of course, yes!

Roman.

%%(sql) SQL-code%%
SELECT * FROM sometable 
WHERE a = '12' and b = 2 
ORDER BY c DESC

There's also (ini), (html), (css), (java) and (pascal) highlighters.
%%(html) HTML-Code%%
<html>
<a href="http://www.ya.ru">test</a>
</html>

%%(ini) ini-Code%%
[Wiki]
BestEngine="WackoWiki"
Version=4

%%(css) CSS-Code%%
body {margin: 0; padding:5px;}
.class {background:url("http://www.ya.ru/")} 

%%(pascal) PASCAL-Code%%
program megaprogramme;
{ comment }
BEGIN
 if a = 15 then writeln('test');
END.

There's also highlighters for ABAP, CPP, CSS, DIFF, DTD, HTML, JAVA, JAVASCRIPT, PERL, PHP, RUBY, PYTHON, SH, SQL, VBSCRIPT, XML.
They can be called as (hl css) etc.

%%(hl css) CSS-Code%%
body {margin: 0; padding:5px;}
.class {background:url("http://www.ya.ru/")}


%%(hl javascript) Javascript-Code%%
var a = document.getElementById("test");
a.value = new Array(15, 31);
function echo (msg) {alert(msg)};


%%(hl php numbers=2) PHP-Code%%
1
2
3
4
5
<?php
phpinfo();
$s = "Hello, World!\n";
print "$s";
?>


%%(hl xml) xml-Code%%
<config>
<section name="test">
  <var>Test</var>
  <val><![CDATA[..text...]]></val>
</section>
</config>


16. Wrappers around formatters

Furthermore, to any formatter %%(Formatierer) Text%% it is possible to assign one of frame after indicating to it the parameter wrapper .


%%(formatter
[wrapper="box | shade | page | text"]
[wrapper_align= "left | center | right | justify"]
[wrapper_width="pixel"]
[clear])
Text%%

box shade page text
Wrapper + x1 +
Alignment + x1 2 +
Width + x1 + 3
Frame + +
Automatic line feed + + +

1 This option does not make sense, because the width of the block is always equal to the width of the page.
2 Only to the left.
3 If you don't put the line feeds yourself, the block width is fixed by the engine at approximately 90% of the page width.


Grammar = [FORMATTER | FORMAT WRAPPER | FORMAT WRAPPER OPTION | Text]


FORMATTER = [ cl | comment | css | email | fyi | hl * | html | ini | java | nb | pascal | php | sql | wacko ]


FORMAT WRAPPER = box, shade, page und text


FORMAT WRAPPER OPTION = [ wrapper_width=Pixel | wrapper_align=[ left | right ] ]


TEXT = alles, frei.


P.S.: hl is available for the following formatters = [ abap | cpp | css | diff | dtd | html | java | javascript | mysql | perl | php | ruby | python | sh | sql | vbscript | xml ]

16.1. Example



%%(css wrapper=box wrapper_align=left wrapper_width=270)
.d { font-size: 70% }
%%


As we see, wrapper box makes it possible to form the convenient "menu", streamlined with text. By the way, there is special formatter (Box), which does not make anything except as it turns around text into this wrapper.

16.2. shade


%%(css wrapper=shade)
.d2 { font-size: 70% }
%%

.d2 { font-size: 70% } 

shade — this box without the tuning.

16.3. text


%%(wacko wrapper=text wrapper_align=center)
text on to center
%%

text on to center

text is derived the "floating" (float) block of text.

16.4. page

%%(wacko wrapper=page wrapper_width=200)
this text cannot be wider than two hundred pixel
%%

this text cannot be wider than two hundred pixel

page it makes it possible to regulate the width of the usual block of text.

16.5. box


%%(wacko wrapper=box wrapper_width=300)
**Box**---- «A hundred times every day I remind myself that my inner and outer life depend upon the labors of other men, living and dead, and that I must exert myself in order to give in the measure as I have received and am still receiving.» &#8211; Albert Einstein
%%


Read comments (2 comments)