[[de:Hilfe:Hilfe]]
=Writing articles=
Before starting to write an artice it has to be veryfied that no previous article covering the selected topic exists. This can be done with the search function or via the [[Special:AllPages|list of all articles]].
Before saving an article the text should be proof read to best knowledge.
If you see any typos or grammatical mistakes, please keep in mind that a lot of the writers here are not speaking English as their native tongue and so you should correct any mistakes you find.

'''Articles should be written from a neutral and common point of view''' (i.e. do not write "''I view the page''" or "''You view the page''", but "''Viewing the page''"), to guarantee a homogenious writing style.
==Important: Provide the Contao-Version==
As Contao is under constant development and subject to change the used Version is of matter.
'''Therefore it is important to state the Contao version an article applies to.''' Otherwise the reader has no way to know which an article or howto refers to. By defining the version the user can follow the changes in the code and templates and change them accordingly.
To state the version within an article use the following code:
<pre>{{AppliesTo
|Version=All versions
|Ext1=SuperExtension
|Ext2=HyperExtension}}</pre>
The following parameters can be used:
* Version - The Contao version the article applies to.
* Ext1 ... ExtN - The extensions the article applies to. The number N is starting from 1 and is incremented by one for every extension.
* TLVersion - As a lot of the articles still apply to TYPOlight (the former name of Contao) the TYPOlight version can also be specified. The need to specify this version will decrease by time and then this parameter will cease to exist.

==Categorization==
An article can be filed under one or more categories. For every category one must specify a category tag. Each of those tags should be specified on a seperate line.

Example:
<pre>
[[Category:Admin HOWTOS]]
[[Category:Modules]]
</pre>

To mark an article as incomplete please add
<pre>{{stub}}</pre>
at the very top of the code, even before the categories. This will add a notice that the article is still not completed at the very top of the page and also include the article to the [[:Category:Stub|stub category]].

=Hints, notes and warnings=
One can add hints, notes and warnings to an article.

These are added by including a certain template in the code.

==Hints==
<pre>
{{Hint|Text of the hint}}
</pre>
Producing the following output:
{{Hint|Text of the hint}}

==Notes==
<pre>
{{Note|Text of the note}}
</pre>
Producing the following output:
{{Note|Text of the note}}

==Warnings==
<pre>
{{Caution|Text of the Warning}}
</pre>
Producing the following output:
{{Caution|Text of the Warning}}

=Formatting=
==Formatting text==
The most common text formats are:
'''bold'''
<pre>'''bold'''</pre>
''italic''
<pre>''italic''</pre>
'''''bold and italic'''''
<pre>'''''bold and italic'''''</pre>

==Lists==
Unordered lists
<pre>
* foo
* bar
</pre>
resulting in
* foo
* bar
Ordered lists
<pre>
# foo
# bar
</pre>
resulting in
# foo
# bar

==Structuring==
It is possible (and encouraged) to structure an article into several sections to keep them readable.
<pre>
=Section 1=
Text
==Subsection 1.1==
Text
==Subsection 1.2==
Text
=Section 2=
Text
==Subsection 2.1==
Text
==Subsection 2.2==
etc.
</pre>
when specifying more than three sections, a table of contents will automatically be added to the top of the page (see top of this page what it looks like).

=Linking=

==Text links==
Text links are divided into two categories: internal and external.

Internal links (within the Contao community Documentation) are specified as follows:
<pre>[[Page name|description]]</pre>
For external links a different notation is used:
<pre>[http://www.example.com description]</pre>(note the space between the URL and the description)

An exception to these external links are links to certain wikis as to wikipedia or the several translations of the ccd.
Links to those sources are specified in interwiki notation.

Taking a link to wikipedia for example:
<pre>[[w:page name|description]]</pre>
for specifying a page in a different language than the default language within the specified wiki the page name has to be prepended with the ISO language code.
For linking to the English page within wikipedia this results in:
<pre>[[w:de:page name|description]]</pre>
This notation is known as interwiki link notation.

==Image links==
Before using or linking an image in this wiki, one has to [[Special:Upload|upload]] it.

To include the image in an article, use the following code:
<pre>[[File:foo.jpg|Description]]</pre>

Images can also be used to link to another page.
Internal links:
<pre>[[File:foo.jpg|link=Main Page|Description]]</pre>
External links:
<pre>[[File:foo.jpg|link=http://www.example.com|Description]]</pre>

----

More advanced information about mediawiki syntax is available on the [http://www.mediawiki.org/wiki/Help:Contents MediaWiki Homepage]

=Translations of the Contao Community Documentation=

The ccd currently is available in three languages. German (http://de.contaowiki.org), Englisch (http://en.contaowiki.org) and French (http://fr.contaowiki.org).
In every article there should be a section at the bottom of the left side menu listing the languages the current article has been translated to.
If there is a language missing and the reader feels confident enough to provide a translation to the missing language please do so.

A small howto follows:
==Determining the title==
Before starting a translation one has to determine what the name translates to in the other language.
Taking the fictive article "Example" (The word "Example" translates to "Beispiel" for German) the article to create on de.contaowiki.org should be named <nowiki>http://de.contaowiki.org/Beispiel</nowiki>.

==Translating the text==
After translating the name and opening the article in edit mode on the other side the translation continues with the text (the hardest part).
One should keep in mind that the articles linked to in the original language will most likely have different names in the local language. One is encouraged to search them in the local language and update the name of the link accordingly. If there does not yet exist an article covering the linked topic, one will translate the name of the topic and link to it nonetheless. This will produce a red link to the aricle and place a new link within the [[Special:WantedPages|wanted pages]]. Translating these pages also is even better.

==Placing links to other languages==
After the article has been translated, the wiki must be told where it can find the translation.
This is done using Interwiki-notation.

In the German section the page "Beispiel" has to be edited and the following has to be added just after the categories:
<nowiki>[[en:Example]]</nowiki>

and on the English page "Example" the following has to be added on the same place:
<nowiki>[[de:Beispiel]]</nowiki>

Translating to French is almost the same but using the language prefix fr instead of de or en.

Predefinição:MsgWarning

2012-02-24T18:00:14Z

Ciaobello: Criou nova página com ' <div style="margin:10px 0;display:block;clear:both;float:left;overflow:hidden;position:relative;width:100%;border:1px solid;color:#9F6000;backgroun…'

<div style="margin:10px 0;display:block;clear:both;float:left;overflow:hidden;position:relative;width:100%;border:1px solid;color:#9F6000;background-color:#FEEFB3;">
<div style="float:left;left:100px;position:relative;width:200%;">
<div style="float:right;padding-bottom:1em;position:relative;right:80px;width:50%;">
<div style="display:block;margin:10px 25px 0px 50px;overflow:hidden;position:relative;right:100%;">
{{#if: {{{1|}}}|{{{1}}}|Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer pretium augue nec sapien ullamcorper a lacinia nunc fermentum. Sed sit amet vestibulum arcu. Vestibulum ultrices semper placerat. Cras quis eros sapien. Mauris suscipit metus eget eros mattis rhoncus at non nulla. Pellentesque justo odio, tempor vel lacinia non, dictum et ante. Aliquam erat volutpat. Fusce interdum neque at libero aliquet eu mollis odio lobortis. Praesent ut nulla sem. Nullam vitae tortor ac ipsum tempus bibendum.}}
</div>
</div>
<div style="display:block;float:left;position:relative;right:95px;width:80px;padding:10px 0;">[[Image:msgWarning.png|alt="Alerto"]]</div>
</div>
</div>

<noinclude>
[[Category: Modelos]]
Este modelo cria um mensagem de aviso (box).
<pre><nowiki>
{{msgWarning | Mensagem de aviso.}}
</nowiki></pre>
</noinclude>
[[Category: Modelos]]

2012-02-24T17:01:34Z

Ciaobello:

Predefinição:C2g

2012-02-24T17:00:51Z

2012-02-24T16:40:30Z

Ciaobello: Criou nova página com ' <div style="margin:10px 0;display:block;clear:both;float:left;overflow:hidden;position:relative;width:100%;border:1px solid;color:#4F8A10;backgroun…'

<div style="margin:10px 0;display:block;clear:both;float:left;overflow:hidden;position:relative;width:100%;border:1px solid;color:#4F8A10;background-color:#DFF2BF;">
<div style="float:left;left:100px;position:relative;width:200%;">
<div style="float:right;padding-bottom:1em;position:relative;right:80px;width:50%;">
<div style="display:block;margin:10px 25px 0px 50px;overflow:hidden;position:relative;right:100%;">
{{#if: {{{1|}}}|{{{1}}}|Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer pretium augue nec sapien ullamcorper a lacinia nunc fermentum. Sed sit amet vestibulum arcu. Vestibulum ultrices semper placerat. Cras quis eros sapien. Mauris suscipit metus eget eros mattis rhoncus at non nulla. Pellentesque justo odio, tempor vel lacinia non, dictum et ante. Aliquam erat volutpat. Fusce interdum neque at libero aliquet eu mollis odio lobortis. Praesent ut nulla sem. Nullam vitae tortor ac ipsum tempus bibendum.}}
</div>
</div>
<div style="display:block;float:left;position:relative;right:95px;width:80px;padding:10px 0;">[[Image:msgSuccess.png|alt="Success"]]</div>
</div>
</div>

<noinclude>
[[Category: Templates]]
Este modelo cria um mensagem de sucesso (box).
<pre><nowiki>
{{msgSuccess | O texto de mensagem de sucesso}}
</nowiki></pre>
</noinclude>

2012-02-23T20:36:47Z

Ciaobello:

<div style="margin:10px 0;display:block;clear:both;float:left;overflow:hidden;position:relative;width:100%;border:1px solid;color:#D8000C;background-color:#FFBABA;">
<div style="float:left;left:100px;position:relative;width:200%;">
<div style="float:right;padding-bottom:1em;position:relative;right:80px;width:50%;">
<div style="display:block;margin:10px 25px 0px 50px;overflow:hidden;position:relative;right:100%;">
{{#if: {{{1|}}}|{{{1}}}|Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer pretium augue nec sapien ullamcorper a lacinia nunc fermentum. Sed sit amet vestibulum arcu. Vestibulum ultrices semper placerat. Cras quis eros sapien. Mauris suscipit metus eget eros mattis rhoncus at non nulla. Pellentesque justo odio, tempor vel lacinia non, dictum et ante. Aliquam erat volutpat. Fusce interdum neque at libero aliquet eu mollis odio lobortis. Praesent ut nulla sem. Nullam vitae tortor ac ipsum tempus bibendum.}}
</div>
</div>
<div style="display:block;float:left;position:relative;right:95px;width:80px;padding:10px 0;">[[Image:msgError.png|alt="Error"]]</div>
</div>
</div>

<noinclude>
[[Categoria: Modelos]]
[[en:Template:MsgError]]
[[de:Vorlage:MsgInfo]]

Este modelo cria uma Box de Mensagem erro.
<pre><nowiki>
{{msgError | Seu texto de erro}}
</nowiki></pre>
</noinclude>

Ficheiro:MsgError.png

2012-02-23T20:35:33Z

Ciaobello:

Predefinição:MsgError

2012-02-23T20:34:36Z

Ciaobello: Criou nova página com ' <div style="margin:10px 0;display:block;clear:both;float:left;overflow:hidden;position:relative;width:100%;border:1px solid;color:#D8000C;background-…'

<div style="margin:10px 0;display:block;clear:both;float:left;overflow:hidden;position:relative;width:100%;border:1px solid;color:#D8000C;background-color:#FFBABA;">
<div style="float:left;left:100px;position:relative;width:200%;">
<div style="float:right;padding-bottom:1em;position:relative;right:80px;width:50%;">
<div style="display:block;margin:10px 25px 0px 50px;overflow:hidden;position:relative;right:100%;">
{{#if: {{{1|}}}|{{{1}}}|Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer pretium augue nec sapien ullamcorper a lacinia nunc fermentum. Sed sit amet vestibulum arcu. Vestibulum ultrices semper placerat. Cras quis eros sapien. Mauris suscipit metus eget eros mattis rhoncus at non nulla. Pellentesque justo odio, tempor vel lacinia non, dictum et ante. Aliquam erat volutpat. Fusce interdum neque at libero aliquet eu mollis odio lobortis. Praesent ut nulla sem. Nullam vitae tortor ac ipsum tempus bibendum.}}
</div>
</div>
<div style="display:block;float:left;position:relative;right:95px;width:80px;padding:10px 0;">[[Image:msgError.png|alt="Error"]]</div>
</div>
</div>

<noinclude>
[[Categoria:Modelos]]
[[en:Template:MsgError]]
[[de:Vorlage:MsgInfo]]

Este modelo cria uma Box de Mensagem erro.
<pre><nowiki>
{{msgError | Seu texto de erro}}
</nowiki></pre>
</noinclude>

Predefinição:Cuidado

2012-02-23T20:29:16Z

Ciaobello:

<div class="caution infotext">
{| style="border: 1px solid #6B4B0F; color:#6B4B0F; background-color: #FFF8AF"
| [[File:Caution.png]] || <span class="title">'''Cuidado:'''</span> {{ #if: {{{1|}}} | {{{1|}}} | Não tem nehum aviso. }}
|}
</div>
<noinclude>
[[Categoria: Modelos]]
[[de:Vorlage:Achtung]]
[[en:Template:Caution]]
Use este modelo para colocar um aviso dentro de um artigo.
<pre><nowiki>
{{Cuidado |O texto do aviso.}}
</nowiki></pre>
</noinclude>

Ficheiro:Caution.png

2012-02-23T20:28:23Z

Ciaobello:

Predefinição:Cuidado

2012-02-23T20:27:27Z

Ciaobello:

<div class="caution infotext">
{| style="border-bottom: 1px solid #C9AFFF; border-top: 1px solid #C9AFFF; background-color: #ddddff"
| [[File:Caution.png]] || <span class="title">'''Cuidado:'''</span> {{ #if: {{{1|}}} | {{{1|}}} | Não tem nehum aviso. }}
|}
</div>
<noinclude>
[[Categoria: Modelos]]
[[de:Vorlage:Achtung]]
[[en:Template:Caution]]
Use este modelo para colocar um aviso dentro de um artigo.
<pre><nowiki>
{{Cuidado |O texto do aviso.}}
</nowiki></pre>
</noinclude>

Predefinição:Cuidado

2012-02-23T20:26:20Z

Ciaobello:

<div class="caution infotext">
{| style="border-bottom: 1px solid #C9AFFF; border-top: 1px solid #C9AFFF; background-color: #ddddff"
| [[File:Caution.png]] || <span class="title">'''Cuidado:'''</span> {{ #if: {{{1|}}} | {{{1|}}} | Não tem nehum aviso. }}
|}
</div>
<noinclude>
[[Categoria: Modelos]]
[[de:Vorlage:Achtung]]
[[en:Template:Caution]]
Use this template to place a warning within an article.
<pre><nowiki>
{{Cuidado |O texto do aviso.}}
</nowiki></pre>
</noinclude>

Predefinição:Cuidado

2012-02-23T20:24:50Z

Ciaobello: Criou nova página com ' <div class="caution infotext"> {| style="border-bottom: 1px solid #C9AFFF; border-top: 1px solid #C9AFFF; background-color: #ddddff" | [[File:Caution.…'

<div class="caution infotext">
{| style="border-bottom: 1px solid #C9AFFF; border-top: 1px solid #C9AFFF; background-color: #ddddff"
| [[File:Caution.png]] || '''Cuidado:''' {{ #if: {{{1|}}} | {{{1|}}} | Não tem nehum aviso. }}
|}
</div>
<noinclude>
[[Categoria: Modelos]]
[[de:Vorlage:Achtung]]
[[en:Template:Caution]]
Use this template to place a warning within an article.
<pre><nowiki>
{{Cuidado |O texto do aviso.}}
</nowiki></pre>
</noinclude>

Predefinição:ExtInfo

2012-02-23T20:14:55Z

Ciaobello: Criou nova página com '<includeonly> <div class="extinfo"> {| border="2" cellspacing="0" cellpadding="4" rules="all" style="margin:1em 1em 1em 0; border:solid 1px #AAAAAA; bo…'

<includeonly>
<div class="extinfo">
{| border="2" cellspacing="0" cellpadding="4" rules="all" style="margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse; background-color:#eeeeee; font-size:95%; empty-cells:show;"
|- style="background:#303060; color:white"
! colspan="2" | '''Extension-Overview'''
|-
{{ #if: {{{Dev|}}} | {{tableitem|heading=Name of the developer|value={{{Dev|}}}}} | {{tableempty}} }}
{{ #if: {{{DevSite|}}} | {{tableitem|heading=Developer Website|value={{{DevSite|}}}}} | {{tableempty}} }}
{{ #if: {{{ExtVersion|}}} | {{tableitem|heading=Version of the extension|value={{{ExtVersion|}}}}} | {{tableempty}} }}
{{ #if: {{{Version|}}} | {{tableitem|heading=Compatibility with Contao Version|value={{{Version|}}}}} | {{tableempty}} }}
{{ #if: {{{TLVersion|}}} | {{tableitem|heading=Compatibility with TYPOlight Version|value={{{TLVersion|}}}}} | {{tableempty}} }}
{{ #if: {{{ERLink|}}} | {{tableitem|heading=Link to Extension Repository|value={{#ifeq: {{{ERLink|}}} | http:{{#replace:{{{ERLink|}}}|http:}} | [{{{ERLink|}}} View extension in ER] | {{{ERLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{DonateLink|}}} | {{tableitem|heading=Donate the developer|value={{#ifeq: {{{DonateLink|}}} | http:{{#replace:{{{DonateLink|}}}|http:}} | [{{{DonateLink|}}} Go to "Donate"-Page] | {{{DonateLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{TrackerLink|}}} | {{tableitem|heading=Link to Tracker|value={{#ifeq: {{{TrackerLink|}}} | http:{{#replace:{{{TrackerLink|}}}|http:}} | [{{{TrackerLink|}}} Go to Tracker] | {{{TrackerLink|}}} }}}} | {{tableempty}} }}
{{ #if: {{{Depending|}}} | {{tableitem|heading=Depending of ff. Extension|value={{{Depending|}}}}} | {{tableempty}} }}
{{ #if: {{{Comment|}}} | {{tableitem|heading=Comment|value={{{Comment|}}}}} | {{tableempty}} }}
|}
</div>
</includeonly><noinclude>
This template makes it possible to define an executive summary of the described extension, which concern an article.
<pre><nowiki>
{{ExtInfo
| Dev=Name of the developer
| DevSite=Developer Website
| ExtVersion=Version of the extension
| Version=Compatibility with Contao Version
| TLVersion=Compatibility with TYPOlight Version
| ERLink=Link to Extension Repository
| DonateLink=Link to the donation page to support the developer
| TrackerLink=Link to the issue tracker of the extension
| Depending=Depending of ff. Extension
| Comment=Special Note
}}
</nowiki></pre>

Bsp:

<pre><nowiki>
{{ExtInfo
| Dev=Christian Schiffler
| DevSite=http://www.cyberspectrum.de
| ExtVersion=1.0.0
| Version=ab 2.9
| TLVersion=2.7.0 - 2.8.3
| ERLink=http://www.contao.org/erweiterungsliste/view/catalog.html
| DonateLink=http://www.cyberspectrum.de/spendmegoodies.html
| TrackerLink=http://code.google.com/p/typolight-catalog/issues/list
| Depending=[[Taxonomy]] [[backend_filterwiz]]
| Comment=Demo: [http://catalogdemo.dasprojekt.org/ Catalog Demo]
}}
</nowiki></pre>

[[Categoria:Modelos]]
[[en:Template:ExtInfo]]
[[de:Vorlage:ExtInfo]]

</noinclude>