www-content/pages/wiki/syntax.txt

657 lines
13 KiB
Plaintext

~~Title: Wiki Syntax~~
~~CODE-c~~
A title like the title of this page:
<code>
~~Title: Wiki Syntax~~
</code>
----
How to define what programming language the rest of the page will be
dealing with:
<code>
~~CODE-c~~
</code>
----
A paragraph is simply text, on a single line or across multiple lines
until a blank line before/after the section of text.
<code>
A paragraph is simply text, on a single line or across multiple lines
until a blank line before/after the section of text.
</code>
----
Within text you can do **Bold Text**, //Italic Text//, __Underlined Text__, and ''Monospaced Text'' as well as <del>Strike-through Text</del>.
<code>
Within text you can do **Bold Text**, //Italic Text//, __Underlined Text__, and ''Monospaced Text'' as well as <del>Strike-through Text</del>.
</code>
----
====== Level 1 Headline ======
<code>
====== Level 1 Headline ======
</code>
----
===== Level 2 Headline =====
<code>
===== Level 2 Headline =====
</code>
----
==== Level 3 Headline ====
<code>
==== Level 3 Headline ====
</code>
----
=== Level 4 Headline ===
<code>
=== Level 4 Headline ===
</code>
----
== Level 5 Headline ==
<code>
== Level 5 Headline ==
</code>
----
A horizontal rule is like
----
<code>
----
</code>
----
- Ordered List Item
- Item 2
- Last item
<code>
- Ordered List Item
- Item 2
- Last item
</code>
----
* Un-ordered List Item
* Item 2
* Third item
* Last item
<code>
* Un-ordered List Item
* Item 2
* Third item
* Last item
</code>
----
An external link like: [[http://example.com|External Link]] would go here. An internal link that uses the wiki page title as text is like: [[syntax]]. Or you can give it a manual title like [[syntax|this here]]. You can link to a full path like [[:docs:efl:start|This here]].
<code>
An external link like: [[http://example.com|External Link]] would go here. An internal link that uses the wiki page title as text is like: [[syntax]]. Or you can give it a manual title like [[syntax|this here]]. You can link to a full path like [[:docs:efl:start|This here]].
</code>
----
A left-aligned image with text flowing around it
{{ :efl-core.png?nolink|Left}}
<code>
{{ :efl-core.png?nolink|Left}}
</code>
----
A right-aligned image with text flowing around it
{{:efl-core.png?nolink |Right}}
<code>
{{:efl-core.png?nolink |Right}}
</code>
----
A centered image on its own on a line:
{{ :efl-core.png?nolink }}
<code>
{{ :efl-core.png?nolink }}
</code>
----
A centered image on its own on a line with a mouse-over label
{{ :efl-core.png?nolink |Label here}}
<code>
{{ :efl-core.png?nolink |Label here}}
</code>
----
An inlined image put into the content along with any text around
{{:efl-core.png?nolink&24|Inlined image with content}}
it so it looks like it's part of the text and has just been slotted in as well as scaled down to 24 pixels in size.
<code>
{{:efl-core.png?nolink&24|Inlined image with content}}
</code>
----
An image that links to the same image if clicked on for a "full resolution" display.
{{ :efl-core.png |A Linked Image}}
<code>
{{ :efl-core.png |A Linked Image}}
</code>
----
Images inlined and scaled to 16, 32 and 64 pixels in size respectively.
{{:efl-core.png?nolink&16|16 Pixels in size}}
{{:efl-core.png?nolink&32|32 Pixels in size}}
{{:efl-core.png?nolink&64|64 Pixels in size}}
<code>
{{:efl-core.png?nolink&16|16 Pixels in size}}
{{:efl-core.png?nolink&32|32 Pixels in size}}
{{:efl-core.png?nolink&64|64 Pixels in size}}
</code>
----
An link to somewhere else with an image
[[http://www.enlightenment.org|{{ :efl-core.png |A Website image link}}]]
<code>
[[http://www.enlightenment.org|{{ :efl-core.png |A Website image link}}]]
</code>
----
Sample C source code
<code c>
typedef struct blah Blah;
int c;
void function(char *blah) {
double x;
This_Type *y;
Type_Here *z;
int e = ENUM_HERE;
x = 10;
char *p = malloc(10);
evas_object_del(p);
}
</code>
<file>
<code c>
typedef struct blah Blah;
int c;
void function(char *blah) {
double x;
This_Type *y;
Type_Here *z;
int e = ENUM_HERE;
x = 10;
char *p = malloc(10);
evas_object_del(p);
}
</code>
</file>
----
Sample lua source code
<code lua>
function hello(x)
local y
end
</code>
<file>
<code lua>
function hello(x)
local y
end
</code>
</file>
----
Sample shall/bash script
<code bash>
$ cat blah.txt | grep pants > output.txt
</code>
<file>
<code bash>
$ cat blah.txt | grep pants > output.txt
</code>
</file>
----
A raw file content "quote"
<file>
This is a aw segment of file
verbatim placed in the page as a monospace
sample section.
</file>
<code>
<file>
This is a aw segment of file
verbatim placed in the page as a monospace
sample section.
</file>
</code>
----
EFL functions will auto link such as evas_object_del() and even other types like Evas_Object and EINA_TRUE will all become links, as long as you have a ''~~CODE-c~~'' at the top of the page indicating which language the page discusses. There is no need to manually link such things. They also auto-link from C code quotes like above.
<code>
EFL functions will auto link such as evas_object_del() and even other types like Evas_Object and EINA_TRUE will all become links, as long as you have a ~~CODE-c~~ at the top of the page indicating which language the page discusses. There is no need to manually link such things. They also auto-link from C code quotes like above.
</code>
-----
You can include another page named ''PAGENAME'' with:
<code>
{{page>PAGENAME}}
</code>
----
You can do tables like:
^ Header 1 ^ Header Column 2 ^ Column 3 header ^
| Cell 1 | Cell 2 | Cell 3 |
| Cell 1 | Cell 2 | Cell 3 |
| Cell 1 | Cell 2 | Cell 3 |
| Cell 1 | Cell 2 | Cell 3 |
<code>
^ Header 1 ^ Header Column 2 ^ Column 3 header ^
| Cell 1 | Cell 2 | Cell 3 |
| Cell 1 | Cell 2 | Cell 3 |
| Cell 1 | Cell 2 | Cell 3 |
| Cell 1 | Cell 2 | Cell 3 |
</code>
----
You can quote people like e-mails with multiple levels of nesting:
Some text
> Quote this level
> More on this level
>> Another level
>>> Yet another level
<code>
Some text
> Quote this level
> More on this level
>> Another level
>>> Yet another level
</code>
----
You can do folded segments or entire blocks of text like:
Here is some folded text/content below. But
++First | test if we can fold/unfold inline++.
Then try a block below:
++++ Folded block here |
The content would be here along with a table inside.
^ Table ^ Blah ^ Blah ^
| Row | Row | Row |
| Your | Boat | Gently |
| Down | The | Stream |
++++
<code>
Here is some folded text/content below. But
++First | test if we can fold/unfold inline++.
Then try a block below:
++++ Folded block here |
The content would be here along with a table inside.
^ Table ^ Blah ^ Blah ^
| Row | Row | Row |
| Your | Boat | Gently |
| Down | The | Stream |
++++
</code>
----
You can do complex tables with itemtable like:
<itemtable header=test;c=column_a;c=column_b,column_c;c=column_d;fdelim=:>
_line_a
column_a:text_a1
column_b:<tablecell>text_a2 \\ This is an example
how to fill a cell over several lines</tablecell>
_line_b
column_a:<tablecell>text_b1 \\ \\ As you can see, local DokuWiki CRLF sequences
can be added to force a linebreak in the cell. Other formatting
elements could be used as well.
</tablecell>
column_c:text_b2
</itemtable>
<code>
<itemtable header=test;c=column_a;c=column_b,column_c;c=column_d;fdelim=:>
_line_a
column_a:text_a1
column_b:<tablecell>text_a2 \\ This is an example
how to fill a cell over several lines</tablecell>
_line_b
column_a:<tablecell>text_b1 \\ \\ As you can see, local DokuWiki CRLF sequences
can be added to force a linebreak in the cell. Other formatting
elements could be used as well.
</tablecell>
column_c:text_b2
</itemtable>
</code>
----
Also you can do tables this way
{|
|+//Extended Table Example//
! style="width: 12em;"|
A1 Header
! style="width: 10em;"|
B1 Header
|- style="background-color: #223344;"
|
{{ :icon-enlightenment.png?50&nolink}}
Lorem ipsum dolor sit amet,
consetetur sadipscing elitr,
sed diam nonumy eirmod tempor invidunt
ut labore et dolore magna aliquyam erat,
sed diam voluptua.
|
B2 Data
* //italic//
* ''monospace''
* [[:start|page link]]
**ATTENTION:**\\
Needs an extra empty line
after the end of whole table!
|}
<code>
{|
|+//Extended Table Example//
! style="width: 12em;"|
A1 Header
! style="width: 10em;"|
B1 Header
|- style="background-color: #223344;"
|
{{ :icon-enlightenment.png?50&nolink}}
Lorem ipsum dolor sit amet,
consetetur sadipscing elitr,
sed diam nonumy eirmod tempor invidunt
ut labore et dolore magna aliquyam erat,
sed diam voluptua.
|
B2 Data
* //italic//
* ''monospace''
* [[:start|page link]]
**ATTENTION:**\\
Needs an extra empty line
after the end of whole table!
|}
</code>
----
You can do more complex ordered and un-ordered lists like:
- Ordered list item 1
- Ordered list item 2
-- Ordered list item 3...
.. ... in multiple paragraphs
- Ordered list item 4
* Unordered list item
** Unordered list item...
.. ... in multiple paragraphs
- Ordered list, first level
- Second level
- Third level
- Fourth level
-- Back to second level
- //Second?! What happened to third?//
.. //Quiet, you.//
- Back to first level
- Still at first level
<code>
- Ordered list item 1
- Ordered list item 2
-- Ordered list item 3...
.. ... in multiple paragraphs
- Ordered list item 4
* Unordered list item
** Unordered list item...
.. ... in multiple paragraphs
- Ordered list, first level
- Second level
- Third level
- Fourth level
-- Back to second level
- //Second?! What happened to third?//
.. //Quiet, you.//
- Back to first level
- Still at first level
</code>
----
You can do definition lists as follows:
? Definition list
: Definition lists vary only slightly from other types of lists in that list items consist of two parts: a term and a description. The term is given by the DT element and is restricted to inline content. The description is given with a DD element that contains block-level content. [Source: W3C]
? Definition list w/ multiple paragraphs
:: The style sheet provided with this plugin will render these paragraphs...
.. ... to the left of the term being defined.
? Definition list w/ multiple "paragraphs"
: Another way to separate blocks of text in a definition...
: ... is to simply have multiple definitions for a term (or group of terms).
: This definition list has DD tags without any preceding DT tags.
: Hey, it's legal XHTML.
? Just like DT tags without following DD tags.
?? But DT tags can't contain paragraphs. That would __not__ be legal XHTML.
.. If you try, the result will be rendered oddly.
<code>
? Definition list
: Definition lists vary only slightly from other types of lists in that list items consist of two parts: a term and a description. The term is given by the DT element and is restricted to inline content. The description is given with a DD element that contains block-level content. [Source: W3C]
? Definition list w/ multiple paragraphs
:: The style sheet provided with this plugin will render these paragraphs...
.. ... to the left of the term being defined.
? Definition list w/ multiple "paragraphs"
: Another way to separate blocks of text in a definition...
: ... is to simply have multiple definitions for a term (or group of terms).
: This definition list has DD tags without any preceding DT tags.
: Hey, it's legal XHTML.
? Just like DT tags without following DD tags.
?? But DT tags can't contain paragraphs. That would __not__ be legal XHTML.
.. If you try, the result will be rendered oddly.
</code>
----
You can add "notes" to a page with:
<note>
This is my note ! Remember it!!
</note>
<code>
<note>
This is my note ! Remember it!!
</note>
</code>
<note important>
Warning ! You're about to lose your mind ;-)
</note>
<code>
<note important>
Warning ! You're about to lose your mind ;-)
</note>
</code>
<note tip>
The clues are in the images.
</note>
<code>
<note tip>
The clues are in the images.
</note>
</code>
<note warning>
Beware of the cat when you open the door !!
</note>
<code>
<note warning>
Beware of the cat when you open the door !!
</note>
</code>
----
You can inline YouTube videos with:
Video at small size
{{youtube>S5RLWlBQYfY?small}}
<code>
{{youtube>S5RLWlBQYfY?small}}
</code>
Medium size
{{youtube>S5RLWlBQYfY?medium}}
<code>
{{youtube>S5RLWlBQYfY?medium}}
</code>
Set start and end point in seconds for the video
{{youtube>S5RLWlBQYfY?large&start=20&end=40}}
<code>
{{youtube>S5RLWlBQYfY?large&start=20&end=40}}
</code>
Turn autoplay on, and disable related videos
{{youtube>S5RLWlBQYfY?360x660&autoplay=1&rel=0}}
<code>
{{youtube>S5RLWlBQYfY?360x660&autoplay=1&rel=0}}
</code>
----
You can inline videos directly from upload media:
{{:sample.mp4|320x240}}
<code>
{{:sample.mp4|320x240}}
</code>
Or from full URLs
{{http://people.xiph.org/~maikmerten/demos/BigBuckBunny.ogv}}
<code>
{{http://people.xiph.org/~maikmerten/demos/BigBuckBunny.ogv}}
</code>
----
You can add a discussion section to the bottom of any page if you add
<code>
~~DISCUSSIONS~~
</code>
At the bottom of a page.