Help:Editing/it

From FreeCAD Documentation
Jump to navigation Jump to search

Questa pagina è un riferimento veloce per i testi Wiki. La versione originale di questa pagina si trova su Wikipedia.


Questa panoramica sulla editazione contiene alcuni esempi di Wikitext.
Si può tenere questa pagina aperta in una finestra separata del browser e utilizzarla come riferimento durante le operazioni di modifica.
Per modificare le pagine Wiki è necessario registrarsi e poi richiedere l'autorizzazione tramite il forum !

_

_

Editazione di base

Iniziare a modificare
Per iniziare a modificare una pagina di MediaWiki, fare clic sul link Edit this page (o solo edit) presente in uno dei suoi bordi.
In questo modo si apre la Pagina di editazione: una pagina con un blocco di testo contenente il testo del wiki, ovvero il codice sorgente modificabile dal quale il server produce la pagina web.
Sopra alla finestra di modifica si trova una barra degli strumenti, come in un word processor convenzionale.
Se la pagina è occupata, è possibile creare la pagina e poi salvarla come un normale testo.
Se si desidera fare solo un esperimento, si prega di farlo nel sandbox, non qui.
Digitare le modifiche
Si può digitare semplicemente il testo.
Oppure si possono anche utlizzare i markup (marcatori) di base dei wiki (descritti nella sezione successiva) per creare dei collegamenti e produrre una formattazione che aggiunge valore al proprio contributo.
Riassumere le modifiche
Scrivere un breve riassunto delle modifiche nel campo piccolo di sotto del box di compilazione.
È possibile sintetizzare la descrizione delle modifiche utilizzando, ad esempio, le voci della legenda.
Visualizzare l'anteprima delle modifiche
Al termine, fare clic su Show preview (Mostra anteprima) per vedere come si presenta la pagina dopo le modifiche e prima di renderle permanenti.
Ripetere il processo di modifica e di anteprima finché non si è soddisfatti del risultato, quindi fare clic su Save page. Le modifiche verranno immediatamente applicate all'articolo.
Nell'editazione delle pagine di documentazione di FreeCAD, è inoltre possibile dare ai collegamenti agli strumenti e agli ambienti la forma di Pulsanti, oppure la forma di Icone.
Caricare le immagini
È anche possibile importare delle immagini, delle schermate, . . . con gli strumenti della pagina disponibili in basso a sinistra. Viene richiesto un nome per il file e una breve descrizione del file importato.
Scarica immagini in formati libero .png (esempio con Gimp) e .svg (esempio con Inkscape)



Formattazione dei caratteri

Come viene visualizzato Cosa si scrive

Si può enfatizzare il testo inserendolo tra doppi apostrofi.

3 apostrofi producono un testo in grassetto.

5 apostrofi creano un testo in grassetto enfatizzato.

4 apostrofi non producono effetti particolari, aggiungono solo un 'apostrofo per parte'.

Si può ''enfatizzare il testo'' inserendolo 
tra doppi apostrofi.  

3 apostrofi producono un testo in '''grassetto'''. 

5 apostrofi creano un testo in 
'''''grassetto enfatizzato'''''.

4 apostrofi non sono producono effetti particolari,
aggiungono solo un ''''apostrofo per parte''''.

Andare a capo non ha alcun effetto sulla formattazione. Lasciando una linea vuota invece si inizia

un nuovo paragrafo.

Andare a capo non ha 
alcun effetto
sulla formattazione.
Lasciando una riga vuota invece si inizia

un nuovo paragrafo.

Si può andare a capo
senza iniziare un nuovo paragrafo.
utilizzando il tag HTML
.

Si può andare a capo<br />
senza iniziare un nuovo paragrafo.<br />
utilizzando il tag HTML <br>.

Si dovrebbe "firmare" ogni commento aggiunto ad una pagina di discussione:
- tre tilde per il proprio nome utente: Dr. Schorsch
- quattro per il nome utente più l'ora e la data: Dr. Schorsch 20:55, 1 November 2006 (CET)
- cinque tilde per indicare solo l'ora e la data: 21:01, 1 November 2006 (CET)

Si dovrebbe "firmare" ogni commento aggiunto 
ad una pagina di discussione: <br />
- tre tilde per il proprio nome utente: ~~~ <br />
- quattro per il nome utente più l'ora e la data: ~~~~ <br />
- cinque tilde per indicare solo l'ora e la data: ~~~~~ <br />

È anche possibile utilizzare i tag HTML.
Alcuni esempi su come usare i tag HTML:

Usare un font typewriter. Questo font è generalmente usato anche per le righe di codice.

Barrare oppure sottolineare un testo, o scrivere in maiuscoletto.

Apice e pedice: X2, H2O

Commenti nascosti (<!-- -->) visibili solo quando si edita la pagina.

I commenti pubblici, di solito si fanno nella talk page.

È anche possibile utilizzare i <b>tag HTML</b>.
Alcuni modi per usare i tag HTML:

Usare un <tt>font typewriter</tt>.
Questo font è generalmente usato anche
per le <code>righe di codice</code>.

<strike>Barrare</strike> oppure <u>sottolineare</u> un testo,
o scrivere in <span style="font-variant:small-caps">
maiuscoletto</span>.

Apice e pedice:
X<sup>2</sup>, H<sub>2</sub>O

Commenti nascosti (<!-- -->) 
visibili solo quando si edita la pagina.
<!-- Nota dell'autore: blah blah blah. -->

I commenti pubblici, di solito si fanno 
nella [[wikipedia:wikipedia:talk page|talk page]].

Per un elenco dei tag HTML consentiti, vedere HTML in wikitext.
Quando è possibile, si dovrebbe evitare di usare le etchette HTML e preferire i marcatori Wiki.

Organizzare i testi

Come viene visualizzato Cosa si scrive
Intestazione delle sezioni

Le Intestazioni organizzano i testi in sezioni.
Utilizzando le intestazioni il software Wiki può generare automaticamente una tabella dei contenuti.

Sottosezione

L'utilizzo del segno di uguale crea una sottosezione.

Una sotto-sottosezione

Non saltare i livelli, non passare da 2 a 4 segni di uguale.

Iniziare con 2 segni di uguale, non da 1, in quanto 1 segno crea il tag H1, che dovrebbe essere riservato per il titolo della pagina.

== Sottosezione ==
L'utilizzo del segno di uguale crea una sottosezione.

=== Una sotto-sottosezione ===

Collegamenti esterni

Spesso si desidera creare un link cliccabile ad altre pagine.

Ecco un link a una pagina denominata CompileOnUnix.
Non si può usare compileonunix, ma si deve scrivere correttamente CompileOnUnix.

Ecco un link a una pagina denominata [[CompileOnUnix]].<br>
Non si può usare [[compileonunix]], ma si deve scrivere
correttamente [[CompileOnUnix]].

Si può aggiungere una formattazione del link. Esempio: CompileOnUnix.

Si può aggiungere una formattazione del link. 
Esempio: ''[[CompileOnUnix]]''.

Il primo carattere del link diventa automaticamente maiuscolo.
Quindi compileOnUnix indirizza nello stesso posto di CompileOnUnix.

Il ''primo carattere'' del link diventa automaticamente
maiuscolo.<br>Quindi  [[compileOnUnix]] indirizza nello
stesso posto di [[CompileOnUnix]].  

The weather in Riga è una pagina che non esiste ancora. Si può crearla, cliccando sul link.

[[The weather in Riga]] è una pagina che non esiste
ancora. Si può crearla, cliccando sul link.

È possibile creare un link a una sezione della pagina in base al suo titolo:

Se più sezioni hanno lo stesso titolo, aggiungere un numero. #Sezione esempio 3 va alla terza sezione denominata "Sezione esempio".

È possibile creare un link a una sezione della pagina
in base al suo titolo:

*[[List of cities by country#Morocco]].

Se più sezioni hanno lo stesso titolo, aggiungere
un numero. [[#Sezione esempio 3]] va alla
terza sezione denominata "Sezione esempio".

È possibile fare un collegamento allo stesso luogo usando un nome diverso con un piped link (link conduttore).
Mettere prima il link obiettivo, poi il carattere pipe "|", quindi il testo del link.

È possibile fare un collegamento allo stesso luogo usando 
un nome diverso con un piped link (link conduttore).<br>
Mettere prima il link obiettivo, poi il carattere pipe "|",
quindi il testo del link.

*[[CompileOnUnix/it|Compilare in Unix]]

È possibile creare un link a Wikipedia digitando: wikipedia:Python (programming language)

Si può creare un link esterno digitando un URL: http://www.nupedia.com

Si può assegnare un titolo: Nupedia

Oppure, lasciare vuoto il titolo: [1]

È possibile creare un link a Wikipedia digitando:
[[wikipedia:Python (programming language)]]

Si può creare un link esterno digitando un URL:
http://www.nupedia.com

Si può assegnare un titolo:
[http://www.nupedia.com Nupedia]

Oppure, lasciare vuoto il titolo:
[http://www.nupedia.com]

Il link a un indirizzo e-mail funziona allo stesso modo: mailto:someone@domain.com oppure someone

Il link a un indirizzo e-mail funziona allo stesso modo:
mailto:someone@domain.com oppure 
[mailto:someone@domain.com someone]

È possibile reindirizzare l'utente a un'altra pagina.

#REDIRECT [[Posizione ufficiale]]

I link Categoria non appaiono in linea, ma a fondo pagina e inseriscono la pagina nella categoria.

Aggiungere un " : " a un link Categoria per mostrare il collegamento in linea senza che la pagina stessa venga
inclusa nella categoria: Category:Help/it

I link ''Categoria'' non appaiono in linea, ma a fondo
pagina e inseriscono ''la pagina nella categoria''.
[[Category:Help/it]]

Aggiungere un " : " a un ''link'' Categoria per mostrare
il collegamento in linea senza che la pagina stessa venga<br>
inclusa nella categoria:
[[:Category:Help/it]]

Elementi espandibili

Elemento espandibile pagina completa

Clicca per vedere il codice

<div class="mw-collapsible mw-collapsed toccolours">

===Vostro Titolo===

<div class="mw-collapsible-content">

Vostro testo è immagine Base ExampleCommandModel.png FreeCAD.

</div>

</div>


Elemento espandibile 500 pixels

Clicca per vedere il codice

<div class="mw-collapsible mw-collapsed toccolours" style="width:500px">

===Vostro Titolo===

<div class="mw-collapsible-content">

Vostro testo è immagine Base ExampleCommandModel.png FreeCAD.

</div>

</div>

Sintassi colorata e delimitazione del codice

Per delimitare il codice (creazione di un quadro) una macro o una routine abbiamo diverse soluzioni :

1: Uno spazio tra il bordo della pagina e la prima colonna del codice.

Esempio :

Uno spazio è stato aggiunto a tutte le linee

import math
from pivy import coin
cam = Gui.ActiveDocument.ActiveView.getCameraNode()
rot.setValue(coin.SbVec3f(0,0,1),math.pi/2)
       self.lineEdit_1 = QtGui.QLineEdit(self.centralWidget)
       self.lineEdit_1.setGeometry(QtCore.QRect(320, 30, 151, 22))

Per le macro, questo metodo è deprecato ! l'utente che vuole copiare il codice per testare la macro è obbligato a rimuovere questo spazio con il rischio di creare errori di indentation per l'esecuzione del codice.


2: I Tag <pre> è </pre>

Esempio :

<pre>

import math
from pivy import coin
cam = Gui.ActiveDocument.ActiveView.getCameraNode()
rot.setValue(coin.SbVec3f(0,0,1),math.pi/2)
       self.lineEdit_1 = QtGui.QLineEdit(self.centralWidget)
       self.lineEdit_1.setGeometry(QtCore.QRect(320, 30, 151, 22))

</pre>


3: I Tag <syntaxhighlight> è </syntaxhighlight>

Questi Tag sono usati per delimitare le macro e 'colorare le sintassi del codice.

Esempio :

<syntaxhighlight>

import math
from pivy import coin
cam = Gui.ActiveDocument.ActiveView.getCameraNode()
rot.setValue(coin.SbVec3f(0,0,1),math.pi/2)
       self.lineEdit_1 = QtGui.QLineEdit(self.centralWidget)
       self.lineEdit_1.setGeometry(QtCore.QRect(320, 30, 151, 22))

</syntaxhighlight>


4: I Tag <source lang=python> è </source>

Questo tag dà un risultato colorato lo stesso che <syntaxhighlight>, ma la particolarità di questa sintassi è che si può avere una colorazione diversa a seconda del linguaggio di programmazione usato.

Optiones:

  • <source lang=python>
  • <source lang=pascal>
  • <source lang=java>
  • <source lang= ..........


5: Tags {{Code|code= and }} questo tag e usato dentro il wiki FreeCAD

Esempio :

{{Code|code=

import math
from pivy import coin
cam = Gui.ActiveDocument.ActiveView.getCameraNode()
rot.setValue(coin.SbVec3f(0,0,1),math.pi/2)
       self.lineEdit_1 = QtGui.QLineEdit(self.centralWidget)
       self.lineEdit_1.setGeometry(QtCore.QRect(320, 30, 151, 22))

}}

I modelli e le pagine inserite automaticamente

Le Templates (i modelli) sono porzioni del wiki destinate ad essere copiate automaticamente e inserite (transcluse) in una pagina. Vengono transcluse inserendo il nome del modello tra le {{doppie parentesi graffe}}. Per impostazione predefinita, le pagine sono inserite con il namespace Template. Il namespace è la parte del nome della pagina prima dei due punti, per esempio, in Help:Editing, Help è il namespace in cui si trova la pagina Editing.

È anche possibile transcludere altre pagine nel namespace di default utilizzando {{:doppie parentesi graffe e due punti}}.

Ci sono tre coppie di marcatori di inclusione che possono essere utilizzati per controllare una inclusione di parti di un modello o di un articolo nel wikitesto. Essi stabiliscono se il wikitesto viene restituito o meno, sia nel suo proprio articolo, che chiameremo "qui", sia in un altro articolo in cui è transcluso, che chiameremo "".

  • <noinclude> contenuto </noinclude>: il contenuto non viene reso là. Questi tag non hanno alcun effetto qui.
  • <includeonly> contenuto </includeonly>: il contenuto viene reso solo là, e non viene reso qui (come inchiostro invisibile reso visibile per mezzo della inclusione).
  • <onlyinclude> contenuto </onlyinclude>: il contenuto viene reso qui e viene reso là, ma là viene reso solo che è compreso tra questi tag..

Ci possono essere diverse sezioni. Inoltre, possono essere nidificate.

Notare: se una pagina è transclusa senza nessun marcatore di inclusione, può causare un errore involontario di categorizzazione. Ogni pagina transclusa conterrà la stessa categoria della pagina originale. Inglobare i marcatori della cotegoria con i tag <noinclude> e </noinclude> per prevenire un errore di categorizzazione.

Come appare Come si scrive

This text comes from the page named Template:Transclusion demo. It has been transcluded into this page.

{{Transclusion demo}}

This transclusion demo is a little bit of text from the page Help:Transclusion demo to be included into any file.

{{Help:Transclusion demo}}

Pagine Speciali

Le Pagine Speciali sono pagine che non possono essere modificate, ma che sono generate dal motore del wiki. Esse forniscono funzioni molto utili, e si trovano nel namespace Special. Una sommario di tutte le pagine speciali è disponibile in Special:SpecialPages.

Link diretti a pagine speciali di uso frequente sono:


Modifiche minori

Un utente connesso in modalità di editazione può contrassegnare una modifica come "minore".
Le modifiche minori sono generalmente correzioni di ortografia, formattazione e riarrangiamento minore del testo.
Gli utenti possono scegliere di nascondere le modifiche minori durante la visualizzazione delle Modifiche recenti.

Contrassegnare un cambiamento significativo come modifica minore non è conforme alle regole Wikiquette.
Se succede di segnare accidentalmente una modifica come minore, fare una modifica fittizia, verificare che la casella "[ ] This is a minor edit" sia deselezionata, e spiegare nel sommario della modifica che la modifica precedente non era minore.

Altro

Altre informazioni e idee sull'editazione del wiki si trovano in WikiPages


Altre lingue: Flag-en.jpg Flag-fr.jpg