Topic

# Wiki Syntax

Jan 4, 2007 / pixtur
Jan 25, 2010 / julio.coelho

wikiSyntax

## Basic text formatingπ

from Example wiki syntax

''emphasize''         <- two quotes
monospace / code    <- back quotes
*bold text*
V[sub]speed[/sub]
~~striked~~

Display:
emphasize
monospace / code
bold text
Vspeed
striked

There are two levels of headings:

from Example wiki syntax

== Top Level ==

=== Second Level ===

or

Top Level
=========      <-  3 or more '=' characters

Second Level
------------   <- 3 or more '-' charaters


## Top Level π

### Second Level π

Second Level

from Example wiki syntax

# First point
# Second point

Display:
1. First point
2. Second point

from Example wiki syntax

- starting line
- another line
- sub point

Display:
• starting line
• another line
• sub point

from Example wiki syntax

1. First line
2. Second line
- Sub

some line inbetween

5. Fith line

Display:
1. First line
2. Second line
• Sub
inbetween
1. Fith line

## Links to wiki pages and itemsπ

• You can link to other items either by their id, or by a their name in double square brackets.
• You may provide an alternative link title after a pipe symbols (|).
• Following links to undefined wiki pages will provide a form to create them.
• To avoid broken links when renaming wiki pages, the item id will automatically be inserted.

from Example wiki syntax

#3651 (link to item with id 3651)
[[#3651|Alternative title]]
[[pixtur]] (is a lazy person)

Display:
(link to item with id 3651)
Alternative title
pixtur (is a lazy person)

from Example wiki syntax

http://www.pixtur.de
[[http://www.pixtur.de|pixtur]]
mailto:jesus@heaven.org

Display:
http://www.pixtur.de
pixtur
mailto:jesus@heaven.org

## Imagesπ

You embed images by their item id.

### Simpleπ

from Example wiki syntax

[[image:234]]

[[image:234|?options?|?description?]]

Whereas ?options? could be a comma separated combination of the following:
• left - float left
• right - float right
• framed - display with description as subtitle. Use image-description, if no description is given within link
• maxsize=234 - will use gd2 to scale this down to 234 pixels if its width or height exceed this size.

[[image:234|maxsize=320,framed,right]]

## Tablesπ

• The first line is always treated as table header.
• There must not be any characters before or after the pipes.
• Links and other formatting can be used inside cells.

from Example wiki syntax

|Header |Header |
|Cell |Cell |


Cell Cell

## Quotesπ

• Use the from and url arguments to enhance your quote.

from Example wiki syntax

[quote from="Mark Twain in Eruption (1940)" url="http://en.wikiquote.org"]
He is *a stranger* to me, but he is a most remarkable man — and I am the other one.
Between us, we cover all knowledge; he knows all that can be known, and I know the rest.
[/quote]


He is a stranger to me, but he is a most remarkable man — and I am the other one. Between us, we cover all knowledge; he knows all that can be known, and I know the rest.

## Code Blocksπ

• All utf8 chars (including all sorts of quotes or html-chars) are allowed.
• Use the optinional from-attribute and language attributes the clarify the meaning and syntax highlighting.
• Please ignore the blanks before code and /code in the following example:

from Example wiki syntax

[ code from="index.php" language="php"]
<?php
print "Hello world";
?>
[ /code]

Display:

from index.php

<?php
print "Hello world";
?>


## Latex-Formatingπ

We use online rendering provided by codecogs

from Example wiki syntax

The formula $K=\frac{1}{2}mV^{2}$ is easy.

The formula $K=\frac{1}{2}mV^{2}$ is easy.

from Example wiki syntax

$$$\int\limits_a^b {\frac{d}{dx}F(x)dx} = F(b)-F(a)$$$

Display:
$$$\int\limits_a^b {\frac{d}{dx}F(x)dx} = F(b)-F(a)$$$

## Horizontal Lineπ

• Three or more underscore characters (_) will create a horizontal line

from Example wiki syntax

______

11 years ago -

is there a possibility to get strike throuhg (e.g. < u>test< /u>

11 years ago

I just implemented this in rev249

11 years ago

Hi,

if I use bla bla /etc/syconfig/blabla, it doesn't work. Is it possible to change this behaviour ?

Thanks

11 years ago

problem "WikiSyntax!" does not lead to the correct item! ;)

11 years ago

very good hint :) This was a typo in the rating of search results. It cause the shortname to be ignored... But adding the item id is a much better solution, though.

### guest:FCKeditor?

11 years ago -

streber is such a great application, I love the flow, organization and functionality. I work at a very large telecom company - wish they had something this nice.

Anyway, I'm new to the whole Wiki thing. Maybe this is blasphemy - but what about adding a WYSIWYG editor like FCKeditor to task creation, comments etc.?

Or is Wiki that much more efficient? (For instance I know coders love VI but being a mere mortal I always have to have my icons and menus)

Thanks for the great tool!

11 years ago

Thanks for you feedback!

I love FCKeditor and spent some time thinking about the pros and cons for a WYSIWYG editor. But at this end my person opinion boils down like this:

In many many cases Formatting is bad. Although there are some areas where complex formating like tables is mandatory in most cases caring about the format will get you distracted from what you want to write.

Nevertheless I would love to have an editor like FKCE boiled down to allowed wiki syntax, which is converted back to normal wiki text, because:
1. wikitexts can nicely be stored and compared (important for comparing versions)
2. wikitexts can easily be formated / style differently.
3. you can very easily sent wiki text with email (without requiring Word or PDF)
So I guess until this editor is available, we are struck with the current state of affairs...

### guest:Quick icons then?

11 years ago -

Why not just create a simple icon bar at the top which just inserts the required start and stop characters for the wiki format items?

This way users who refuse to learn the syntax or use it infrequently can still utilize the text entry with its full potential.

Also, it might be cool to have a preview button for these people also while they are learning. This could be a simple compromise before an editor shows up with wiki-ascii formatting.

### guest:maxsize seems not to work

11 years ago -

In at least 0.078...

### guest:Quotes

11 years ago -

One line quotes can't be read due to the scrollbars. Any way the box can be made bigger?

### pixtur:Antwort auf Quotes

11 years ago (3. update 9 years ago)

I created a ticket: One line quotes can not be read due to the scrollbars. Please provide additional information there.

### guest:Preview button

11 years ago -

It would be very nice to have a "Preview" button beside the "Submit" button to show me what I'm about to submit, without having to submit it, edit it, submit it, edit it, etc.

11 years ago -

Is there a way to address a sub page in a link.

For example:

To have a link to the Documetnation sub page of a project I provide the full URL:

http://myserver/streber/index.php?go=projViewDocu&prj=94

But would be more wiki like to provide it like this:

?projViewDocu

(or the like).

### eh:Better formatting

11 years ago

Ooops, see rigth now that my text above isnt' very readable. so here it comes again:

For example:

To have a link to the Documetnation sub page of a project I provide the full URL:

http://myserver/streber/index.php?go=projViewDocu&prj=94


But would be more wiki like to provide it like this:

#94?projViewDocu


(or the like).

PS:
Preview could really be something good.

11 years ago

Yeah. Preview would be really nice. Especially since it could be ajax driven... But this will come in a later version.

I don't really see, why you would want to address projViewDocu at all (the display of documentation topics as task was a bug which has been fixed).

Addressing chapters (e.g. Headlines) would be a cool think, but I have not really good idea, how to do this. I could insert some anchors at the headlines, but links to them would become invalid when changing the headline.

Addressing pages like (projView, taskView, taskViewEfforts, etc) would probably be a nice think, but I am affraid it's too seldom used to be implemented.

We urgently need a syntax to replace an URL with a readable title. Possibilities:
1. mediaWiki Links enclosed with single square brackets. Optional title after space.
[http://www.streber-pm.org streber]

1. simple syntax (works not inside tables)
http://www.streber-pm.org|streber

1. complex syntax (fits best into current syntax)
[[link:http://www.streber-pm.org|streber]]


### eh:

11 years ago

We gather documentation for a project and organize it in folders. From time to time I want to give a hint in a task that there's documentation available and want provide the link to the doc overview (and not to a particular doc page), for example for the streber project it would be:

http://www.streber-pm.org/index.php?go=projViewDocu&prj=5

Actually I can live with the full URL, but it gets broken in case our streber installation gets moved to another server. And since there's no such thing like a "global replace" some manual work would be needed.

### pixtur:very good argument...

11 years ago (3. update 9 years ago)

[[item:123|Optional name|function=taskViewEfforts] ]


11 years ago

### guest:How can I mark part of code?

11 years ago -

Hi, can you help me, how can I mark part of code, I mean color mark.
And not one or three words. I need mark big text part.
Can I do it?

### pixtur:Antwort auf How can I mark part of code?

11 years ago

You can turn on "Starlight" but this will have some drawbacks.

11 years ago -

using "# 98" does not work, any alternatives ?

### guest:

11 years ago -

ignore Cannot link to item #5686 of type 7, I found the way

### guest:Original text

11 years ago -

Hi, can I have the original text (wiki format) of this () content? I'd like to install it locally. I could have just copy and paste whatever seen/rendered by browser that would be rather ugly. Thanks.

### guest:how embed external images?

10 years ago -

I want to put external images but i can't.
This could be easy I think but I can't find the formater script wich php file do it?.

Suggested sintax coudl be:

### damian2:external image

8 years ago (2. update 8 years ago)

see in
after applying the mods, the format for external images will be:
[[http://url/image.png|maxsize=123,right]]

10 years ago -

Hi,

Just discovering this fantastic tool. I have however a suggestion: why not support relative links? Today you can link to external pages using http://xxx.xxx.com but it's not possible to create relative links to pages on the same server (something like ../../Doc/mypage.html). This would be very useful when you have several sites on the same server and the location of this server changes: you don't want to have to replace all absolute urls in the pages.

10 years ago -

Here is how you can give your URL a specific name:
[[http://www.streber-pm.org|streberPM]]

streberPM

### guest:How to link strange url?

10 years ago -

http://mydomain.com/index.html?test=1&asd=*&lol=1234

Ex:
Normal: http://mydomain.com/index.html?test=1&asd=&lol=1234

How I can do it?

### guest:Syntax for external links - again

10 years ago -

From my point of view that makes perfect sense.

What do you guys think?

gb5256

9 years ago

### dekamerone:Wiki Syntax compatibility?

10 years ago

I'm just looking for a possibility to automatically convert OpenOffice Dokuments to the Wiki-Syntax of Streber.

Maybe there is a OpenOffice macro for other Wiki-Systems usable or could be taken as easy customizable template?

thx and happy projects : Michael

### pixtur:Antwort auf Wiki Syntax compatibility?

9 years ago

Probably not.

10 years ago (2. update 9 years ago)

Yes,

http:// links should open a new window like target="blank".
If you use
#12345
it should be just like today.

10 years ago -

But I do not know what you mean.
My external links do all start with HTTP:// and they all open in the currently open window/tab and not in a new window/tab.
I tested on Firefox and Safari (both MAC).

Furthermore I do not understand your "Unkwown item 12345".

Sorry, I seem to be too dumb for this...

Any help really appreciated.
gb5256

9 years ago

### kjsphoto:Underline word?

9 years ago (2. update 9 years ago)

How do you underline a word or a group of words?

### pixtur:This is not possible

9 years ago

Maybe you could use latex for special formulas, though.

### kjsphoto:

9 years ago (3. update 9 years ago)

Figured it out. To underline text you do this;
$\underline{test}$


$\underline{test}$

### guest:How do you arrange text

9 years ago -

is there a way to arrange texts?
Is there a way to user layers (like float left, float right etc)

MFG
chris

### pixtur:No,

9 years ago

Maybe we will add an [html]-tag somewhere in the future. But this would no longer be editable with the wiki-syntax.

9 years ago -

Using file id Unkwown item 9999 used to link to the description (fileView action). Now it links to not the latest but the specified version of the file.

9 years ago

### guest:markup editor?

9 years ago -

I agree with you to not include a wysiwyg editor, but I add a markup editor like http://markitup.jaysalvat.com/home/ .
It's easy to configure and the code is clean :)
Chalda

### ifreeman:code language parameter

9 years ago

What's the point of specifying the language parameter for code blocks if nothing is displayed when you enter it?

### guest:Line Break within a Table Cell?

9 years ago -

As soon as I try to use line breaks within a table cell, the table is now longer displayed correctly. Is it possible to use a line break within a table using a special code e.g. a double backslash or any other ?

### clawfrown:Colorize part of text?

8 years ago

Is there a possibility to put in color specific text or paragraph?
Like in html: <span style="background:#cccccc;">hello world</span>

### guest:Alternate text in table cells does not work

8 years ago -

HistoryComment
2009-10-02
2009-10-08alternate text

8 years ago -

### guest:

8 years ago - visible as suggested -