Aiuto:Markup

Wikibooks, manuali e libri di testo liberi.

Indice

1 Introduzione a Wikibooks
2 Come modificare una pagina
3 Come scrivere un wikibook
4 Il markup di Wikibooks
- 4.1 Sezioni, paragrafi, liste e linee
5 Collegamenti, URL e immagini
6 Formattazione dei caratteri
7 Un esempio molto complesso
8 Nowiki e commenti
9 Tabelle
- 9.1 Tavola dei contenuti (TOC)
- 9.2 Tabelle HTML
10 Variabili

Trovi una primissima guida su "Aiuto:Guida essenziale".
Per spiegazioni sulla funzionalità "redirect" vai alla pagina "Creare e usare un redirect".

[modifica] Introduzione a Wikibooks

Wikibooks è basata su un software detto MediaWiki, che permette a chiunque di modificare facilmente qualunque articolo e pubblicare immediatamente questi cambiamenti. Questa pagina è il riferimento per il markup. Argomenti correlati:

Come iniziare una pagina
Suggerimenti su come contribuire
Informazioni generali sulla modifica degli articoli con le relative FAQ
Convenzioni sullo stile nel Wikibooks:Manuale di stile
Convenzioni sulla nomenclatura
Se si sta scrivendo un articolo su qualcosa che appartiene ad un gruppo di oggetti (una città, un oggetto astronomico, un carattere cinese...) controllare se esiste già un progetto per quel gruppo e cercare di seguire la sua direzione.

[modifica] Come modificare una pagina

Per approfondire, vedi la pagina Aiuto:Modifica.

È molto semplice modificare una pagina di Wikibooks. Si deve semplicemente cliccare sul collegamento "Modifica" all'inizio o alla fine (anche sul lato) di una pagina per cambiarla, oppure cliccare su "Discussione" e poi su "Modifica" per scrivere nella pagina di discussione corrispondente. Apparirà la pagina con il box di testo modificabile di quella pagina.

Quando si ha finito di scrivere, inserire un breve sommario nel piccolo campo sotto al box e al termine cliccare sul pulsante "Salva la pagina"!
Se si desidera si può visualizzare l'anteprima delle modifiche prima di salvare. A seconda del proprio sistema e del browser in uso, la pressione del tasto Enter mentre il box non è attivo (non c'è il cursore) potrebbe avere lo stesso effetto di un click sul tasto "Salva la pagina".

Si prega di usare un punto di vista neutrale e si prega di citare le fonti in modo che altri possano controllare ed estendere il proprio lavoro.

È spesso più conveniente copiare e incollare il testo prima nel proprio editor di testo preferito, modificare e controllare l'ortografia e in seguito incollare nel browser per fare un'anteprima. In questo modo si può mantenere una copia locale di backup delle proprie pagine in modo da effettuare cambiamenti offline. Alcuni editor di testo possono essere adattati per modificare le pagine di Wikibooks.

[modifica] Come scrivere un wikibook

Per approfondire, vedi la pagina Aiuto:Come scrivere un libro.

[modifica] Il markup di Wikibooks

Nella colonna a sinistra della tabella qui sotto si vedono gli effetti possibili. Nella colonna a destra si può vedere come si possono ottenere. In altre parole, per rendere il testo simile a quello della colonna a sinistra si deve scriverlo nel formato indicato nella colonna di destra.

Si potrebbe tenere questa pagina aperta in una finestra separata del browser per avere un riferimento. Se si vogliono provare il markup wiki senza il pericolo e il timore di fare danni si può usare la pagina delle prove (o sandbox).

[modifica] Sezioni, paragrafi, liste e linee

Come viene visualizzato	Cosa si scrive
Iniziare le sezioni con le intestazioni: Intestazione Nuova sezione sottosezione sotto-sottosezione	= Intestazione = == Nuova sezione == === sottosezione === ==== sotto-sottosezione ====
Andare a capo non ha effetto sulla formattazione. Si può usare per separare le frasi all'interno di un paragrafo. Alcuni pensano che questo aiuti a fare le modifiche e migliori la funzione diff. Ma una linea vuota fa iniziare un nuovo paragrafo.	Andare a capo non ha effetto sulla formattazione. Si può usare per separare le frasi all'interno di un paragrafo. Alcuni pensano che questo aiuti a fare le modifiche e migliori la funzione ''diff''. Ma una linea vuota fa iniziare un nuovo paragrafo.
Si possono interrompere le linee senza iniziare un nuovo paragrafo.	Si possono interrompere le linee<br/> senza iniziare un nuovo paragrafo.
Le liste sono facili da fare: iniziare ogni linea con un asterisco altri asterischi fanno iniziare altri livelli	* Le liste sono facili da fare: iniziare ogni linea con un asterisco * altri asterischi fanno iniziare altri livelli
Le liste numerate sono belle molto organizzate facili da seguire	# Le liste numerate sono belle ## molto organizzate ## facili da seguire
Si possono anche mescolare le liste e annidarle così	* Si possono anche mescolare le liste # e annidarle #* così
Lista di definizioni definizioni voci la definizione della voce	; Lista di definizioni : definizioni ; voci : la definizione della voce
I due punti indentano una linea o un paragrafo. Andando a capo si inizia un nuovo paragrafo.	: I due punti indentano una linea o un paragrafo. Andando a capo si inizia un nuovo paragrafo.
Se una linea inizia con uno spazio allora sarà formattata esattamente come è stata scritto; con un carattere a larghezza fissa; le linee non andranno a capo automaticamente. questo è utile per: * incollare del testo preformattato; * la descrizione degli algoritmi; * il codice sorgente di un programma; * ascii art e strutture chimiche;	se una linea inizia con uno spazio THEN sarà formattata allora come è stata scritto; con un carattere a larghezza fissa; le linee non andranno a capo automaticamente. questo è utile per: * incollare del testo preformattato; * la descrizione degli algoritmi; * il codice sorgente di un programma; * ascii art e strutture chimiche;
Testo centrato.	<center>Testo centrato.</center>
Testo allineato a destra.	<div style="text-align:right;">Testo allineato a destra. </div>
Una linea di divisione orizzontale: qui è sopra e qui è sotto. Principalmente utile per la separazione dei thread nelle pagine di discussione.	Una linea di divisione orizzontale: qui è sopra ---- e qui è sotto.

[modifica] Collegamenti, URL e immagini

Come viene visualizzato	Cosa si scrive
Cos'è l'intelligenza artificiale?. La prima lettera del link diventa automaticamente maiuscola. Gli spazi interni vengono automaticamente rappresentati come caratteri underscore (digitare un underscore ha lo stesso effetto della digitazione di uno spazio, ma non è raccomandato). Quindi il collegamento sopra è http://it.wikibooks.org/wiki/Intelligenza_artificiale, che è un libro con il nome "Intelligenza artificiale".	Cos'è l'[[intelligenza artificiale]]?.
Collegamenti ad una sezione su una pagina, ad es. HTML#Introduzione (i collegamenti a sezioni non esistenti non sono considerati interrotti, ma sono trattati come collegamenti alla pagina, cioé all'inizio della pagina)	[[Linguaggio HTML#Introduzione]] .
Stesso link, nomi diversi: risposte. (Questo è un piped link)	Stesso link, nomi diversi: [[Aiuto:FAQ\|risposte]].
I suffissi possono essere fusi nel collegamento: Italiano	I suffissi possono essere fusi nel collegamento: [[Italia]]no
I namespace non vengono automaticamente nascosti: invece di Wikibooks:Bar usa Bar.	I namespace non vengono automaticamente nascosti: invece di [[Wikibooks:Bar]] usa [[Wikibooks:Bar\|Bar]].
Quando si aggiunge un commento ad una pagina di discussione, lo si dovrebbe firmare. Si può farlo aggiungendo tre tilde per il proprio nome utente: Montrealais o quattro per il nome utente più l'ora e la data: Montrealais 08:10 Oct 5, 2002 (UTC)	Quando si aggiunge un commento ad una pagina di discussione, lo si dovrebbe firmare. Si può farlo aggiungendo tre tilde per il proprio nome utente: : ~~~ o quattro per il nome utente più l'ora e la data: : ~~~~
ABC è una pagina che non esiste ancora. La si può creare cliccando sul collegamento Per creare una nuova pagina: Creare un collegamento ad essa su qualche altra pagina Visualizzare l'anteprima o salvare la pagina Cliccare sul link che è stato creato. La nuova pagina verrà aperta per la modifica. Consultare la guida come iniziare un libro e le convenzioni di nomenclatura di Wikibooks.	[[ABC]] è una pagina che non esiste ancora.
Reindirizzare il titolo di una pagina verso un'altra inserendo del testo tipo il seguente nella sua prima linea.	#REDIRECT [[pagina a cui si rimandati]]
I wikibooks possono essere collegati ad altri libri che trattano lo stesso soggetto in un'altra lingua usando un collegamento tipo [[codice lingua:Titolo]] detto interlink. Non importa dove viene inserito questo collegamento mentre si modifica la pagina, poiché verrà mostrato sempre nello stesso posto quando si salva la pagina, ma viene raccomandato di posizionarlo in fondo al box. Tuttavia, vi consigliamo di inserirli sempre a fine pagina.	[[fr:Aide]]
Collegamento esterno: Nupedia	Collegamento esterno: [http://www.nupedia.com Nupedia]
O fornire semplicemente l'URL: http://www.nupedia.com. Nell'URL tutti i simboli devono essere compresi tra: A-Z a-z 0-9 ._\/~%-+&#?!=()@ \x80-\xFF. Se un URL contiene dei caratteri diversi dovrebbe essere convertita; ad esempio, ^ deve essere scritto così %5E.	O fornire semplicemente l'URL: http://www.nupedia.com.
Un'immagine: Possono essere usate solo le immagini che sono state caricate (upload) su Wikibooks. Per caricare un'immagine usare la pagina upload. Si può trovare l'immagine caricata nella pagine elenco immagini. Vedere policy uso delle immagini e Aiuto:Markup immagini per ulteriori suggerimenti. Il testo alternativo, usato quando un'immagine non viene visualizzata da un browser testuale, è caldamente raccomandato. Vedere Wikibooks:Testo alternativo per la immagini per sapere come sceglierlo.	Un'immagine: [[Immagine:Wikibooks-logo.svg]] o, con testo alternativo [[Immagine:Wikibooks-logo.svg\|Wikibooks logo]] Ulteriori informazioni qui.
Cliccare su una immagine caricata mostra una pagina con la descrizione, che può essere collegata direttamente così Immagine:Wikipedia-logo.png	[[:Immagine:Wikipedia-logo.png]]
Per fare collegamenti a libri, si può usare i collegamenti agli Aiuto:ISBN. ISBN 0123456789X	ISBN 0123456789X
"Pagine che linkano questa" e "Modifiche correlate" possono essere collegate come: Speciale:Whatlinkshere/Wikibooks:Come modificare una pagina e Speciale:Recentchangeslinked/Wikibooks:Come modificare una pagina	[[Speciale:Whatlinkshere/Wikibooks:Come modificare una pagina]] e [[Speciale:Recentchangeslinked/Wikibooks:Come modificare una pagina]]

[modifica] Formattazione dei caratteri

Come viene visualizzato	Cosa si scrive
enfatizzato, maggiormente enfatizzato, molto enfatizzato. Sono doppi e tripli apostrofi, non virgolette. Notare che su quasi tutti i browser, queste hanno la stessa funzione del corsivo e del grassetto.	''enfatizzato'', '''maggiormente enfatizzato''', '''''molto enfatizzato'''''.
Un font typewriter per i `termini tecnici`. per motivi semantici, <code> dovrebbe essere usato quando si scrivono programmi per computer	Un font typewriter per i <tt>termini tecnici</tt>.
Si può usare del testo piccolo per le didascalie.	Si può usare del <small>testo piccolo</small> per le didascalie.
Si può ~~barrare del materiale cancellato~~ e sottolineare nuovo materiale.	Si può <strike>barrare del materiale cancellato</strike> e <u>sottolineare nuovo materiale</u>.
Accenti: è é ê ë ì í À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ñ Ò Ó Ô Õ Ö Ø Ù Ú Û Ü ß à á â ã ä å æ ç è é ê ë ì í î ï ñ ò ó ô œ õ ö ø ù ú û ü ÿ	è é ê ë ì í À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ñ Ò Ó Ô Õ Ö Ø Ù Ú Û Ü ß à á â ã ä å æ ç è é ê ë ì í î ï ñ ò ó ô &oelig; õ ö ø ù ú û ü ÿ
Punteggiatura: ¿ ¡ « » § ¶ † ‡ • —	¿ ¡ « » § ¶ &dagger; &Dagger; • —
Simboli commerciali: ™ © ® ¢ € ¥ £ ¤	™ © ® ¢ € ¥ £ ¤
Pedice: x₂ Apice: x² or x² ε₀ = 8.85 × 10⁻¹² C² / J m. 1 ettaro = 1 E4 m²	Pedice: x<sub>2</sub><br/> Apice: x<sup>2</sup> or x² ε<sub>0</sub> = 8.85 × 10<sup>−12</sup> C² / J m. 1 [[ettaro]] = [[1 E4 m²]]
Caratteri greci: α β γ δ ε ζ η θ ι κ λ μ ν ξ ο π ρ σ ς τ υ φ χ ψ ω Γ Δ Θ Λ Ξ Π Σ Φ Ψ Ω	α β γ δ ε ζ η θ ι κ λ μ ν ξ ο π ρ σ &sigmaf; τ υ φ χ ψ ω Γ Δ Θ Λ Ξ Π Σ Φ Ψ Ω
caratteri matematici: ∫ ∑ ∏ √ − ± ∞ ≈ ∝ ≡ ≠ ≤ ≥ → × · ÷ ∂ ′ ″ ∇ ‰ ° ∴ ℵ ø ∈ ∉ ∩ ∪ ⊂ ⊃ ⊆ ⊇ ¬ ∧ ∨ ∃ ∀ ⇒ ⇔ → ↔	∫ ∑ ∏ √ − ± ∞ ≈ &prop; &equiv; ≠ ≤ ≥ → × · ÷ ∂ ′ ″ ∇ &permil; ° &there4; &alefsym; ø ∈ ∉ ∩ ∪ ⊂ ⊃ &sube; &supe; ¬ &and; &or; ∃ ∀ ⇒ ⇔ → ↔
x² ≥ 0 true. Per aggiungere spazi, usare i non-breaking spaces - ` `. ` ` evitano anche che la linea si interrompa in mezzo al testo, utile per le formule.	<i>x</i><sup>2</sup>  ≥  0 true.
Formule complicate: $\sum_{n=0}^\infty \frac{x^n}{n!}$ Vedere Aiuto:Formule_matematiche_TeX	<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>
Evitare l'interpretazione del markup: Collegamento → (<i>alla</i>) [[Aiuto:FAQ]] Usato per mostrare dati che altrimenti avrebbero significati speciali. Non interpreta il markup, anche quello che assomiglia ai tag HTML. Interpreta i riferimenti dei caratteri HTML.	<nowiki>Collegamento → (<i>alla</i>) [[Aiuto:FAQ]]</nowiki>
Commentare il sorgente della pagina: non mostrato nella pagina Usato per lasciare dei commenti per i futuri autori.	<!-- commento -->

[modifica] Un esempio molto complesso

Esempio e sintassi
$\mbox{uomo} = { { \left ( { { \prod_{i= \frac{ \omega }{ \lim_{n \to \infty } x_n } }^N \oint_{C} {x_i}^3\, dx_i + 4y^2\, dy } \over x^c } \right ) } \over { \int_{-N}^{N} e^x\, dx + \sum_{k=1}^N k^2 } } { \begin{bmatrix} \mbox{nutrizione} & \mbox{sopravvivenza} \\ \mbox{procreazione} & \mbox{contesto} \end{bmatrix} }$
<math> \mbox{uomo} = { { \left ( { { \prod_{i= \frac{ \omega } { \lim_{n \to \infty } x_n } }^N \oint_{C} {x_i}^3\, dx_i + 4y^2\, dy } \over x^c } \right ) } \over { \int_{-N}^{N} e^x\, dx + \sum_{k=1}^N k^2 } } { \begin{bmatrix} \mbox{nutrizione} & \mbox{sopravvivenza} \\ \mbox{procreazione} & \mbox{contesto} \end{bmatrix} } </math>

[modifica] Nowiki e commenti

Come viene visualizzato

Come si scrive

Evitare l'interpretazione del markup:
Collegamento → (<i>alla</i>) [[Aiuto:FAQ]]

Usato per mostrare dati che altrimenti avrebbero significati speciali.
Non interpreta il markup, anche quello che assomiglia ai tag HTML.
Interpreta i riferimenti dei caratteri HTML.

<nowiki>Collegamento &rarr; (<i>alla</i>)
[[Aiuto:FAQ]]</nowiki>

Commentare il sorgente della pagina:
non mostrato nella pagina

Usato per lasciare dei commenti per i futuri autori.

<!-- commento -->

[modifica] Tabelle

Per approfondire, vedi la pagina Aiuto:Tabelle.

[modifica] Tavola dei contenuti (TOC)

Per approfondire, vedi la pagina Aiuto:Indice.

Allo stato attuale del linguaggio di markup wiki, almeno quattro intestazioni provocano la comparsa del TOC davanti alla prima intestazione (o dopo la sezione introduttiva). L'inserimento di __NOTOC__ in qualunque posto forza la scomparsa del TOC, mentre l'inserimento di __FORCETOC__ forza la comparsa del TOC anche con meno di quattro intestazioni.

[modifica] Tabelle HTML

Le tabelle HTML possono essere molto utili. Per ulteriori dettagli su come usarle e le discussioni su quando esse sono appropriate, vedere Aiuto:Tabelle. Anche se è consigliabile usare la sintassi Wiki perché facilmente interpretata dal software.

[modifica] Variabili

Per approfondire, vedi la pagina Aiuto:Variabili.

Variabile	Effetto
{{CURRENTMONTH}}	07
{{CURRENTMONTHNAME}}	luglio
{{CURRENTMONTHNAMEGEN}}	luglio
{{CURRENTDAY}}	19
{{CURRENTDAYNAME}}	sabato
{{CURRENTYEAR}}	2008
{{CURRENTTIME}}	12:16
{{CURRENTWEEK}}	29
{{CURRENTDOW}}	6
{{NUMBEROFARTICLES}}	3.422

NUMBEROFARTICLES: numero delle pagine nel namespace principale che contengono un link e non sono un redirect, cioè numero dei moduli, stub contenenti un link, e pagine per le disambiguità.

Le spiegazioni da parte degli autori del software UseModWiki si trovano in:

http://www.usemod.com/cgi-bin/wiki.pl?TextFormattingRules