Guida alla notazione della formattazione del testo

Intestazioni

Per creare un'intestazione, posiziona "hn. " all'inizio della riga (dove n può essere un numero da 1 a 6).

Notazione Commenta
h1. Intestazione più grande

Intestazione più grande

h2. Intestazione più grande

Intestazione più grande

h3. Intestazione grande

Intestazione grande

h4. Intestazione normale

Intestazione normale

h5. Intestazione piccola
Intestazione piccola
h6. Intestazione più piccola
Intestazione più piccola

Effetti testuali

Gli effetti testuali sono utilizzati per modificare la formattazione di parole e frasi.

Notazione Commenta
*grassetto*
Trasforma il testo in grassetto.
_corsivo_
Trasforma il testo in corsivo..
??citazione??
Trasforma il testo in citazione.
-eliminati-
Trasforma il testo in testo eliminato.
+inseriti+
Trasforma il testo in testo inserito.
^apice^
Trasforma il testo in apice.
~pedice~
Trasforma il testo in pedice.
{{a spaziatura fissa}}
Trasforma il testo in testo con spaziatura fissa.
bq. Testo incluso in una citazione

Per trasformare l'intero paragrafo in citazione, anteponi il codice "bq.".

Esempio:

Testo incluso in una citazione
{quote}
    voci di contenuto citabili
che possono essere citate {quote}

Cita un blocco di testo più lungo di un paragrafo.

Esempio:

voci di contenuto citabili
che possono essere citate
{color:red}
    mamma guarda, del testo in rosso!
{color}

Cambia il colore di un blocco di testo.

Esempio:

mamma guarda, del testo in rosso!

Interruzioni testuali

La maggior parte del tempo, le interruzioni espliciti di paragrafo non sono richieste - Il renderer wiki sarà in grado di formattare i paragrafi in modo corretto.

Notazione Commenta
(riga vuota)
Produce un nuovo paragrafo
\\
Crea un'interruzione di riga. Di solito la funzione non è richiesta, nella maggior parte dei casi il renderer wiki valuta correttamente quando viene il momento di andare a capo.
----
Crea un righello orizzontale.
---
Produce il simbolo .
--
Produce il simbolo .

Collegamenti

È importante imparare come creare collegamenti rapidamente.

Notazione Commenta
[#anchor]
[^attachment.ext]
Crea un collegamento ipertestuale interno per l'allegato o l'ancoraggio specificato. Accodare il simbolo '#' seguito da un nome di ancoraggio condurrà in un punto aggiunto ai segnalibri della pagina desiderata. Inserire '^' seguito dal nome di un allegato condurrà a un collegamento all'allegato della ticket corrente.
[http://jira.atlassian.com]
[Atlassian|http://atlassian.com]

Crea un collegamento a una risorsa esterna. I caratteri speciali successivi all'URL e non fanno parte dell'indirizzo e devono essere separati da uno spazio.

Le parentesi quadre [] intorno ai collegamenti esterni sono facoltative qualora tu non voglia usare nessun alias per il collegamento.

Esempi:

http://jira.atlassian.com
Atlassian

[mailto:legendaryservice@atlassian.com]

Crea un collegamento a un indirizzo e-mail, completo di icona della posta.

Esempio:

>>legendaryservice@atlassian.com

[file:///c:/temp/foo.txt]
[file:///z:/file/on/network/share.txt]

Crea un collegamento a un file da scaricare sul tuo computer o su un percorso di rete condiviso che hai assegnato a un'unità. Per accedere al file, fai clic sul collegamento con il pulsante destro e scegli "Salva oggetto con nome".

Come impostazione predefinita, questa opzione funziona solo in Internet Explorer ma può essere abilitato in Firefox (vedi i documenti).

{anchor:anchorname}
Crea un ancoraggio di segnalibro nella pagina. Potrai quindi creare direttamente collegamenti all'ancoraggio. Ad esempio, il collegamento [La mia pagina#qua] condurrà nel punto di "La mia pagina" dove si trova la macro {anchor:qua}, mentre il collegamento [#là] condurrà nel punto della pagina corrente dove si trova la macro {anchor:là}.
[~username]
Crea un collegamento alla pagina del profilo di un particolare utente, con un'icona e il nome completo dell'utente.

Elenchi

Gli elenchi consentono di presentare le informazioni sotto forma di una serie di voci ordinate.

Notazione Commenta
* alcuni
* punto elenco
** rientrate
** punti elenco
* punti

Un elenco puntato (deve trovarsi nella prima colonna). Usa altri simboli (**) per aumentare il rientro.

Esempio:

  • alcuni
  • punto elenco
    • rientrate
    • punti elenco
  • punti
- diverso
- punto elenco
- tipi

Una voce di elenco (con -). Un elenco consiste di più righe.

Esempio:

  • diverso
  • punto elenco
  • tipi
# un
# numerati
# elenco

Un elenco numerato (deve trovarsi nella prima colonna). Usa altri simboli (##, ###) per aumentare il rientro.

Esempio:

  1. un
  2. numerati
  3. elenco
# un
# numerati
#* con
#* nidificati
#* punto elenco
# elenco
* un
* puntati
*# con
*# nidificati
*# numerati
* elenco

Potrai inoltre utilizzare elenchi annidati di vario tipo

Esempio:

  1. un
  2. numerati
    • con
    • nidificati
    • punto elenco
  3. elenco

Esempio:

  • un
  • puntati
    1. con
    2. nidificati
    3. numerati
  • elenco

Immagini

Le immagini possono essere incorporate in un campo wiki sul quale è possibile eseguire il rendering da file allegati o sorgenti remote.

Notazione Commenta
!http://www.host.com/image.gif!
o
!attached-image.gif!

Inserisce un'immagine nella pagina.

Se è stato fornito un URL completo, l'immagine sarà visualizzata dalla sorgente remota. In caso contrario sarà visualizzato un file di immagine allegato.

!image.jpg|thumbnail!

Inserisci un'anteprima dell'immagine nella pagina (funziona solo con le immagini allegate alla pagina).

!image.gif|align=right, vspace=4!

Per qualsiasi immagine, puoi specificare anche attributi del tag dell'immagine sotto forma di elenchi separati da virgole delle coppie di nome=valore, in questo modo.

Allegati

Alcuni allegati di un tipo specifico possono essere incorporati in un campo compatibile con il rendering wiki dai file allegati.

Notazione Commenta
!quicktime.mov!
!spaceKey:pageTitle^attachment.mov!
!quicktime.mov|width=300,height=400!
!media.wmv|id=media!

Incorpora un oggetto in una pagina, assumendo un elenco di proprietà separato da virgole.

Formati predefiniti supportati:

  • Flash (.swf)
  • Video QuickTime (.mov)
  • Windows Media (.wma, .wmv)
  • Real Media (.rm, .ram)
  • File MP3 (.mp3)

Possono essere utilizzati altri tipi di file, ma potrebbero richiedere l'indicazione delle proprietà "classid", "codebase" e "pluginspage" per essere riconosciuti dai browser web.

Le proprietà comuni sono:

  • larghezza - la larghezza del file multimediale
  • altezza - l'altezza del file multimediale
  • ID - l'ID assegnato all'oggetto incorporato

Per motivi di sicurezza, i file situati sui server remoti non sono consentiti. Lo stile
è l'impostazione predefinita, ciascun oggetto incorporato è circoscritto dal tag "div". Se vuoi applicare uno stile a div e al suo contenuto, ignora la classe CSS "embeddedObject". Specifica un ID come proprietà consente inoltre di applicare uno stile diverso a oggetti incorporati diversi. Sono usati i nomi della classe CSS nel formato "embeddedObject-ID".

Tabelle

Le tabelle ti consentono di organizzare i contenuti in righe e colonne, e comprendono all'occorrenza una riga di intestazione.

Notazione Commenta
||intestazione 1||intestazione 2||intestazione 3||
|col A1|col A2|col A3|
|col B1|col B2|col B3|

Produce una tabella. Usa le barre doppie per una riga d'intestazione di tabella.

Il codice indicato qui produce una tabella dal seguente aspetto:

intestazione 1 intestazione 2 intestazione 3
col A1 col A2 col A3
col B1 col B2 col B3

Formattazione avanzata

Altre opzioni di formattazione avanzata del testo.

Notazione Commenta
{noformat}
il brano di testo è stato preformattato
pertanto *non* sarà effettuata qui nessuna ulteriore _formattazione_. {noformat}

Crea un blocco di testo preformattato senza evidenziazione della sintassi. Tutti i parametri opzionali della macro {panel} sono validi anche per {noformat}.

  • nopanel: Incorpora un blocco di testo all'interno di un pannello interamente personalizzabile. I parametri opzionali che possono essere definiti sono i seguenti:

Esempio:

il brano di testo è stato preformattato pertanto *non* sarà effettuata qui nessuna ulteriore _formattazione_.
{panel}
Del testo
{panel}
{panel:title=Il mio titolo}
Del testo con un titolo
{panel}
{panel:title=Il mio titolo|borderStyle=dashed|borderColor=#ccc|titleBGColor=#F7D6C1|bgColor=#FFFFCE}
un blocco di testo circondato da un *pannello*
_un'altra_ riga ancora
{panel}

Incorpora un blocco di testo all'interno di un pannello interamente personalizzabile. I parametri opzionali che possono essere definiti sono i seguenti:

  • title: Titolo del pannello
  • borderStyle: Lo stile utilizzando dai bordi di questo pannello (continuo, tratteggiato o un altre stile di bordo CSS valido)
  • borderColor: Il colore del bordo utilizzato da questo pannello
  • borderWidth: La larghezza del bordo utilizzata da questo pannello
  • bgColor: Il colore dello sfondo di questo pannello
  • titleBGColor: Il colore di sfondo della sezione del titolo di questo pannello

Esempio:

Il mio titolo
un blocco di testo circondato da un pannello
un'altra riga ancora
{code:title=Bar.java|borderStyle=solid}
// Some comments here
public String getFoo()
{
    return foo;
}
{code}
{code:xml}
    <test>
        <another tag="attribute"/>
    </test>
{code}

Makes a preformatted block of code with syntax highlighting. All the optional parameters of {panel} macro are valid for {code} too. The default language is Java but you can specify JavaScript, ActionScript, XML and SQL too.

Esempio:

Bar.java
// Some comments here
public String getFoo()
{
    return foo;
}
<test>
    <another tag="attribute"/>
</test>

Misc

Varie altre funzionalità di evidenziazione della sintassi.

Notazione Commenta
\X
Carattere speciale di escape X (es. {)
:)
,
:(
etc

Emoticon grafici (faccine).

Notation :) :( :P :D ;) (y) (n) (i) (/) (x) (!)
Image
Notazione (+) (-) (?) (on) (off) (*) (*r) (*g) (*b) (*y) (flag)
Immagine
Notazione (flagoff)
Immagine