Sintassi Wiki
Wiki utilizza la sintassi Markdown e Texy con diversi miglioramenti.
Collegamenti
Per i riferimenti interni, si utilizza la notazione tra parentesi quadre [link]
è utilizzata. Si tratta della
forma con barra verticale [link text |link target]
oppure nella forma abbreviata [link text]
se il target
è lo stesso del testo (dopo la trasformazione in minuscolo e i trattini):
[Page name]
→<a href="/en/page-name">Page name</a>
[link text |Page name]
→<a href="/en/page-name">link text</a>
Possiamo collegarci a un'altra lingua o a un'altra sezione. Una sezione è una libreria Nette (ad esempio forms
,
latte
, ecc.) o sezioni speciali come best-practices
, quickstart
, ecc:
[cs:Page name]
→<a href="/en/page-name">Page name</a>
(stessa sezione, lingua diversa)[tracy:Page name]
→<a href="//tracy.nette.org/en/page-name">Page name</a>
(sezione diversa, stessa lingua)[tracy:cs:Page name]
→<a href="//tracy.nette.org/en/page-name">Page name</a>
(sezione e lingua diversa)
È anche possibile puntare a un'intestazione specifica della pagina con #
.
[#Heading]
→<a href="#toc-heading">Heading</a>
(titolo della pagina corrente)[Page name#Heading]
→<a href="/en/page-name#toc-heading">Page name</a>
Collegamento alla pagina iniziale della sezione: (@home
è un termine speciale per indicare la home page della
sezione)
[link text |@home]
→<a href="/en/">link text</a>
[link text |tracy:]
→<a href="//tracy.nette.org/en/">link text</a>
Link alla documentazione API
Utilizzare sempre le seguenti notazioni:
[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
I nomi completamente qualificati si usano solo nella prima menzione. Per gli altri collegamenti, utilizzare un nome semplificato:
[Form::setTranslator() |api:Nette\Forms\Form::setTranslator()]
→ Form::setTranslator()
Collegamenti alla documentazione PHP
[php:substr]
→ substr
Codice sorgente
Il blocco di codice inizia con ```lang
e termina con ```
I linguaggi supportati sono
php
, latte
, neon
, html
, css
, js
e sql
.
Usare sempre le tabulazioni per l'indentazione.
```php
public function renderPage($id)
{
}
```
Si può anche specificare il nome del file come ```php .{file: ArrayTest.php}
e il blocco di codice sarà reso in
questo modo:
public function renderPage($id)
{
}
Titoli
Titolo superiore (nome della pagina) sottolineato con stelle (*
). For normal headings use equal signs
(=
) and then hyphens (-
).
MVC Applications & Presenters
*****************************
...
Link Creation
=============
...
Links in Templates
------------------
...
Caselle e stili
Paragrafo di testa contrassegnato dalla classe .[perex]
Note contrassegnate con la classe .[note]
Suggerimento contrassegnato con la classe .[tip]
Avviso contrassegnato con la classe .[caution]
Avviso forte contrassegnato con la classe .[warning]
Numero di versione .{data-version:2.4.10}
Le classi devono essere scritte prima della relativa riga:
.[note]
This is a note.
Si noti che i riquadri come .[tip]
attirano l'attenzione e quindi dovrebbero essere usati per enfatizzare, non
per informazioni meno importanti.
Indice dei contenuti
L'indice (link nella barra laterale) viene generato automaticamente quando la pagina è più lunga di 4 000 byte. Questo
comportamento predefinito può essere modificato con un tag {{toc}}
tag meta. Il testo
per il TOC è preso per impostazione predefinita dall'intestazione, ma è possibile usare un testo diverso con un
.{toc}
modificatore. Questo è particolarmente utile per le intestazioni più lunghe.
Long and Intelligent Heading .{toc: A Different Text for TOC}
=============================================================
Tag Meta
- impostare il titolo della propria pagina (in
<title>
e briciole di pane){{title: Another name}}
- reindirizzamento
{{redirect: pla:cs}}
– vedere i link - imporre
{{toc}}
o disabilitare{{toc: no}}
tabella dei contenuti