Diferenças entre edições de "Ajuda:Conteúdos"
Da Contao Community Documentation
(Criou nova página com 'en:Help:Contents =Verfassen von Artikeln= Vor dem Verfassen eines neuen Artikels sollte kontrolliert werden, ob schon ein Artikel zum gleichen Thema existiert. Dies kann…') |
(→Escrever artigos) |
||
| (11 edições intermédias de um utilizador não apresentadas) | |||
| Linha 1: | Linha 1: | ||
| − | [[ | + | [[de:Hilfe:Hilfe]] |
| − | = | + | =Escrever artigos= |
| − | + | Antes de começar a escrever um artigo tem que ser verificado que nenhum artigo anterior abrange o tema escolhido já existe. | |
| − | + | Isto pode ser feito com a função de pesquisa ou através da [[Especial: AllPages | lista de todos os artigos]]. | |
| − | + | Antes de salvar o texto deste artigo deve ser revisto para melhor conhecimento. | |
| − | + | ||
| − | + | ||
| − | + | Se você vir erros de digitação ou erros gramaticais, por favor, tenha em mente que muitos dos escritores aqui não estão falando Portuguese como sua língua nativa e por isso você deve corrigir quaisquer erros que encontrar. | |
| − | + | '''Os artigos devem ser escritos a partir de um ponto de vista neutro e comum''' | |
| − | + | (p. ex. não escreve "''eu vejo a página''" ou "''você veja a página''" mas, "''Ver a página''"), para garantir um estilo de escrita homogênea. | |
| − | == | + | ==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 | <pre>{{AppliesTo | ||
| − | |Version= | + | |Version=All versions |
|Ext1=SuperExtension | |Ext1=SuperExtension | ||
|Ext2=HyperExtension}}</pre> | |Ext2=HyperExtension}}</pre> | ||
| − | + | The following parameters can be used: | |
| − | * Version - | + | * Version - The Contao version the article applies to. |
| − | * Ext1 ... ExtN - | + | * Ext1 ... ExtN - The extensions the article applies to. The number N is starting from 1 and is incremented by one for every extension. |
| − | * TLVersion - | + | * 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> | <pre> | ||
[[Category:Admin HOWTOS]] | [[Category:Admin HOWTOS]] | ||
| − | [[Category: | + | [[Category:Modules]] |
</pre> | </pre> | ||
| − | + | ||
| + | To mark an article as incomplete please add | ||
<pre>{{stub}}</pre> | <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]]. | |
| − | + | =Aviso, nota e cuidado= | |
| + | Para adicionar um aviso, notas e mensagens de cuidado nos artigos. | ||
| − | + | Estes são adicionados através da inclusão de um determinado modelo no código. | |
| − | = | + | ==Aviso== |
| − | + | ||
| − | + | ||
| − | + | ||
<pre> | <pre> | ||
| − | {{ | + | {{Aviso|Texto do aviso.}} |
</pre> | </pre> | ||
| − | |||
| − | |||
| − | == | + | Resultado: |
| + | {{Aviso|Texto do aviso.}} | ||
| + | |||
| + | ==Nota== | ||
<pre> | <pre> | ||
| − | {{ | + | {{Nota|Texto da nota.}} |
</pre> | </pre> | ||
| − | + | Resultado: | |
| − | {{ | + | {{Nota|Texto da nota.}} |
| − | == | + | ==Cuidado== |
<pre> | <pre> | ||
| − | {{ | + | {{Cuidado|Texto do aviso.}} |
</pre> | </pre> | ||
| − | + | Resultado: | |
| − | {{ | + | {{Cuidado|Texto do aviso.}} |
| + | =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> | <pre> | ||
* foo | * foo | ||
* bar | * bar | ||
</pre> | </pre> | ||
| − | + | resulting in | |
* foo | * foo | ||
* bar | * bar | ||
| − | + | Ordered lists | |
<pre> | <pre> | ||
# foo | # foo | ||
# bar | # bar | ||
</pre> | </pre> | ||
| − | + | resulting in | |
# foo | # foo | ||
# bar | # bar | ||
| − | == | + | |
| − | + | ==Structuring== | |
| + | It is possible (and encouraged) to structure an article into several sections to keep them readable. | ||
<pre> | <pre> | ||
| − | = | + | =Section 1= |
Text | Text | ||
| − | == | + | ==Subsection 1.1== |
Text | Text | ||
| − | == | + | ==Subsection 1.2== |
Text | Text | ||
| − | = | + | =Section 2= |
Text | Text | ||
| − | == | + | ==Subsection 2.1== |
Text | Text | ||
| − | == | + | ==Subsection 2.2== |
| − | + | etc. | |
</pre> | </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> | + | <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) | |
| − | + | ||
| − | + | ||
| − | < | + | |
| − | </pre> | + | |
| − | + | 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> | |
| − | <pre> | + | |
| − | + | ||
| − | </pre> | + | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | Images can also be used to link to another page. | |
| − | <pre>[[ | + | 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> | <nowiki>[[en:Example]]</nowiki> | ||
| − | |||
| + | and on the English page "Example" the following has to be added on the same place: | ||
<nowiki>[[de:Beispiel]]</nowiki> | <nowiki>[[de:Beispiel]]</nowiki> | ||
| − | + | Translating to French is almost the same but using the language prefix fr instead of de or en. | |
| − | + | ||
Edição atual desde as 19h37min de 24 de fevereiro de 2012
Índice
Escrever artigos
Antes de começar a escrever um artigo tem que ser verificado que nenhum artigo anterior abrange o tema escolhido já existe. Isto pode ser feito com a função de pesquisa ou através da lista de todos os artigos. Antes de salvar o texto deste artigo deve ser revisto para melhor conhecimento.
Se você vir erros de digitação ou erros gramaticais, por favor, tenha em mente que muitos dos escritores aqui não estão falando Portuguese como sua língua nativa e por isso você deve corrigir quaisquer erros que encontrar.
Os artigos devem ser escritos a partir de um ponto de vista neutro e comum
(p. ex. não escreve "eu vejo a página" ou "você veja a página" mas, "Ver a página"), para garantir um estilo de escrita homogênea.
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:
{{AppliesTo
|Version=All versions
|Ext1=SuperExtension
|Ext2=HyperExtension}}
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:
[[Category:Admin HOWTOS]] [[Category:Modules]]
To mark an article as incomplete please add
{{stub}}
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 stub category.
Aviso, nota e cuidado
Para adicionar um aviso, notas e mensagens de cuidado nos artigos.
Estes são adicionados através da inclusão de um determinado modelo no código.
Aviso
{{Aviso|Texto do aviso.}}
Resultado:
 |
Aviso: Texto do aviso. |
Nota
{{Nota|Texto da nota.}}
Resultado:
 |
Nota: Texto da nota. |
Cuidado
{{Cuidado|Texto do aviso.}}
Resultado:
 |
Cuidado: Texto do aviso. |
Formatting
Formatting text
The most common text formats are: bold
'''bold'''
italic
''italic''
bold and italic
'''''bold and italic'''''
Lists
Unordered lists
* foo * bar
resulting in
- foo
- bar
Ordered lists
# foo # bar
resulting in
- foo
- bar
Structuring
It is possible (and encouraged) to structure an article into several sections to keep them readable.
=Section 1= Text ==Subsection 1.1== Text ==Subsection 1.2== Text =Section 2= Text ==Subsection 2.1== Text ==Subsection 2.2== etc.
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:
[[Page name|description]]
For external links a different notation is used:
[http://www.example.com description](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:
[[w:page name|description]]
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:
[[w:de:page name|description]]
This notation is known as interwiki link notation.
Image links
Before using or linking an image in this wiki, one has to upload it.
To include the image in an article, use the following code:
[[File:foo.jpg|Description]]
Images can also be used to link to another page. Internal links:
[[File:foo.jpg|link=Main Page|Description]]
External links:
[[File:foo.jpg|link=http://www.example.com|Description]]
More advanced information about mediawiki syntax is available on the 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 http://de.contaowiki.org/Beispiel.
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 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:
[[en:Example]]
and on the English page "Example" the following has to be added on the same place:
[[de:Beispiel]]
Translating to French is almost the same but using the language prefix fr instead of de or en.
