Sintaxe do Wiki
Wiki usa a sintaxe Markdown & Texy com vários aprimoramentos.
Links
Para referências internas, a notação entre parênteses rectos [link]
é utilizado. Isto é na forma com uma
barra vertical [link text |link target]
ou na forma abreviada [link text]
se o alvo for o mesmo que
o texto (após transformação para minúsculas e hífens):
[Page name]
→<a href="/en/page-name">Page name</a>
[link text |Page name]
→<a href="/en/page-name">link text</a>
Podemos fazer um link para outro idioma ou para outra seção. Uma seção é uma biblioteca Nette (por exemplo,
forms
, latte
, etc.) ou seções especiais como best-practices
,
quickstart
, etc:
[cs:Page name]
→<a href="/en/page-name">Page name</a>
(mesma seção, idioma diferente)[tracy:Page name]
→<a href="//tracy.nette.org/en/page-name">Page name</a>
(seção diferente, mesmo idioma)[tracy:cs:Page name]
→<a href="//tracy.nette.org/en/page-name">Page name</a>
(seção e idioma diferentes)
Também é possível direcionar um título específico na página com #
`.
[#Heading]
→<a href="#toc-heading">Heading</a>
(título na página atual)[Page name#Heading]
→<a href="/en/page-name#toc-heading">Page name</a>
Link para a página inicial da seção: (@home
é um termo especial para a página inicial da seção)
[link text |@home]
→<a href="/en/">link text</a>
[link text |tracy:]
→<a href="//tracy.nette.org/en/">link text</a>
Links para a documentação API
Use sempre as seguintes notações:
[api:Nette\SmartObject]
→ Nette\SmartObject[api:Nette\Forms\Form::setTranslator()]
→ Nette\Forms\Form::setTranslator()[api:Nette\Forms\Form::$onSubmit]
→ Nette\Forms\Form::$onSubmit[api:Nette\Forms\Form::Required]
→ Nette\Forms\Form::Required
Os nomes totalmente qualificados são utilizados apenas na primeira menção. Para outros links, use um nome simplificado:
[Form::setTranslator() |api:Nette\Forms\Form::setTranslator()]
→ Formulário::setTranslator()
Links para documentação PHP
[php:substr]
→ substr
Código fonte
O bloco de código começa com ```lang
e termina com ```
Os idiomas suportados são
php
, latte
, neon
, css
, html
, , js
e
sql
. Utilize sempre as abas para recuo.
```php
public function renderPage($id)
{
}
```
Você também pode especificar o nome do arquivo como ```php .{file: ArrayTest.php}
e o bloco de código será
renderizado desta forma:
public function renderPage($id)
{
}
Cabeçalhos
Título superior (nome da página) sublinhado com estrelas (*
). For normal headings use equal signs
(=
) and then hyphens (-
).
MVC Applications & Presenters
*****************************
...
Link Creation
=============
...
Links in Templates
------------------
...
Caixas e Estilos
Parágrafo de chumbo marcado com classe .[perex]
Notas marcadas com classe .[note]
Dica marcada com classe .[tip]
Advertência marcada com classe .[caution]
Aviso forte marcado com classe .[warning]
Número da versão .{data-version:2.4.10}
As aulas devem ser escritas antes da linha relacionada:
.[note]
This is a note.
Por favor, note que caixas como .[tip]
chama a atenção e, portanto, deve ser usada para enfatizar, não para
informações menos importantes.
Tabela de Conteúdos
O índice (links na barra lateral) é gerado automaticamente quando a página é maior que 4 000 bytes. Este comportamento
padrão pode ser alterado com um {{toc}}
meta tag. O texto para TOC é retirado por
padrão do título, mas é possível usar um texto diferente com uma meta tag. .{toc}
modificador. Isto é
especialmente útil para títulos mais longos.
Long and Intelligent Heading .{toc: A Different Text for TOC}
=============================================================
Meta Tags
- definindo seu próprio título de página (em
<title>
e migalhas de pão){{title: Another name}}
- redirecionamento
{{redirect: pla:cs}}
– ver links - fazendo cumprir
{{toc}}
ou desativação{{toc: no}}
tabela de conteúdo