Help:Editing
From UIC
Prima di tutto: per fare le vostre prove, utilizzate soltanto la Sandbox e non tutto il wiki :).
Contents |
Link e Nomenclatura
- I link sono semplici da fare:
- Un link tra pagine del sito si fa cosi': [[Pagina sito|Nome del Link]] -> Nome del Link
- Se dovete linkare una categoria, fate così: [[:Category:Reversing]] Nota bene: i ":" prima della parola category non sono un errore!!!
Titoli
- Quando create il link ad un tutorial, il nome deve avere questa forma: [[Titolo breve|Titolo Normale]], ad esempio il mio tutorial "Che cos'è il cracking?" nella sezione Reversing, va linkato così: [[Introduzione al cracking|Che cos'è il cracking?]] -> Che cos'è il cracking?
- Il titolo breve deve essere corto perché farà parte dell'url, quindi fatelo corto ma esplicativo, evitate i caratteri non alfanumerici, tipo lettere accentate e simboli vari: !@#$%^&*. Parentesi, trattini ed underscore sono concessi, se un utente fa due tutorial con lo stesso titolo, ad esempio: Cracking, potete linkarli cosi':
[[Cracking (prima parte)|Cracking - prima parte]]
[[Cracking (seconda parte)|Cracking - seconda parte]] - Come regolarsi con le maiuscole? I nomi delle pagine (ed anche i titoli) dovrebbero avere la prima lettera sempre maiuscola, le congiunzioni/preposizioni minuscole ed i nomi maiuscoli, ecco qualche esempio:
- [[Crackiamo il Programma Tal dei Tali]] -> Giusto
- [[Crackiamo Il Programma Tal Dei Tali]] -> Sbagliato
Formattazione del testo
- Evitate i tag html quando possibile, ricordate che:
- Il corsivo si fa cosi': ''Testo corsivo'' -> Testo corsivo.
- Il grassetto si fa cosi': '''Testo grassetto''' -> Testo grassetto.
- Il grassetto corsivo si fa cosi': '''''Testo grassetto e corsivo''''' -> Testo grassetto e corsivo.
- Per la creazione delle tabelle, introduzione e gestione delle immagini, leggete:
- Il codice va racchiuso SEMPRE nei tag: <code></code>, dal momento che il wiki e' in grado di auto-evidenziare il codice, percio' guardate la pagina relativa al syntax highlighting.
- Il testo viene automaticamente giustificato, però se dovete andare a capo utilizzate questo tag: <br />
- Per iniziare un nuovo paragrafo è sufficiente lasciare una riga vuota.
- Se iniziate la riga con uno spazio, il browser renderizzerà l'articolo ESATTAMENTE come lo state scrivendo, quindi gli a capo saranno visibili senza dover utilizzare il tag <br />, tuttavia utilizzate questa funzionalità solo quando dovete incollare del testo formattato, altrimenti gli utenti con risoluzioni video inferiori alla vostra potrebbero vedere la pagina mal formattata se le righe sono troppo lunghe.
- Si può indentare il testo con dei due-punti:
: Testo indentato
:: Testo più indentato - Testo centrato <center>Testo centrato</center>:
- Una funzione carina che va usata (e non abusata) sono i tooltipciao sono un tooltip! che possono essere utilizzati per spiegare le sigle più o meno comuni, azioni etc che si incontrano in un tutorial. La sintassi è semplice: <tooltip popup="testo del tooltip">parola da evidenziare</tooltip>: parola da evidenziaretesto del tooltip. Attenti che tutti i tag html non vengono tollerati dal tooltip, quindi evitateli.
Collegamenti al glossario
All'interno delle pagine (specialmente i tutorial) si possono inserire, quando opportuno, i link ai lemmi presenti nel glossario (se manca qualche lemma, potete sempre aggiungerlo). Ad esempio, per aggiungere un link al lemma CRC del glossario, basta fare:
- [[Glossary#CRC|CRC]]
che diventa: CRC.
Attenzione: anche i link alle sono case-sensitive, perciò, per esempio [[Glossary|crc]] non funziona (linka la pagina, ma non la sezione giusta).
Quanti link mettere? Quanti ne volete, ma in generale è buona regola mettere il link solo se pertinente. Se la parola debugger compare più volte all'interno di un tutorial, inutile mettere collegamenti ridondanti: linkate solo la prima. Inoltre tenete conto del livello del tutorial. Se il tutorial che scrivete/editate è per utenti già più smaliziati, inutile mettere un link a "debugger", mentre in un tutorial per newbies può essere un modo per non dare troppo per scontate determinate conoscenze.
Raccomandazioni
- Le introduzioni alle pagine del wiki (esclusi i singoli tutorial) e tutto il resto scrivetelo in inglese!
- Una pagina può contenere anche più categorie, i tutorial devono contenere almeno due categorie, la prima è quella riguardante il nome dell'autore, la seconda è quella riguardante il tipo di tutorial, un sommario dei nomi delle categorie è questo:
- Non scrivete una pagina per poi editarla 100 volte, usate la funzione di anteprima (pulsante: Show preview), eviterete così di floddare il database e di dossare il server riempiendo la lista dei "diff"
- Linkate linkate linkate, la forza dei wiki è nei link, quindi USATELI!!!
Varie
- Se volete inserire il category tree, ovvero quell'alberello dinamico che vedete qualche riga sopra, usate questa sintassi: <categorytree>nome categoria</categorytree>, i parametri accettati sono tre:
- hideroot
- set this to "on" to hide the "root" node of the tree, i.e. the mention of category Foo from the example.
- mode
- can be "categories" (the default), "pages" or "all". "categories" only lists subcategories; "pages" lists all pages in the category except images; "all" shows all pages in the category.
- style
- can be used to specify any CSS styles you would like for the tree.
- es. <categorytree mode=all>nome categoria</categorytree>
- Per inserire il livello di difficoltà utilizzate il tag <level>numero</level>:
| <level>0</level> | 
|
| <level>0.5</level> | 
|
| <level>1</level> | 
|
| <level>1.5</level> | 
|
| <level>2</level> | 
|
| <level>2.5</level> | 
|
| <level>3</level> | 
|
| <level>3.5</level> | 
|
| <level>4</level> | 
|
| <level>4.5</level> | 
|
| <level>5</level> | 
|
Sezione Crackme
- I file vanno uppati soltanto in formato .zip, quindi (ri)zippateli.
- Se conoscete il livello di difficolta' usate anche il tag <level> </level>
I crackme vanno elencati usando questa sintassi:
*[[media:CMxx.zip|'''CMxx''']]<br />'''Language:''' <br />'''OS:''' <br />'''Protection:''' Serial<br />'''Difficult:''' <br />'''Notes:''' <br /><br />
Inoltre, se il crackme ha soluzione si dovrebbe usare questa sintassi:
- se la soluzione è contenuta in un file:
*[[media:CMxx.zip|'''CMxx''']] - [[media:CMxxSLTN.zip|'''Solution''']]<br />'''Language:''' <br />'''OS:''' <br />'''Protection:''' Serial<br />'''Difficult:''' <br />'''Notes:''' <br /><br />
- se la soluzione è un tutorial all'interno del wiki:
*[[media:CMxx.zip|'''CMxx''']] - [[Pagina|'''Solution''']]<br />'''Language:''' <br />'''OS:''' <br />'''Protection:''' Serial<br />'''Difficult:''' <br />'''Notes:''' <br /><br />
