Note Generali Sulla Scrittura
Da Hacknowledge.
Salve a tutti, volevo darvi alcune note per la scrittura su questa bellissima wiki:
Indice |
[modifica] Creazione delle pagine del libro
Prima di tutto volevo informarvi che ho creato una pagina Indice che è la pagina principale di tutto il libro. Questa pagina ha una importanza essenziale, perchè riordina tutte le pagine disordinate della wiki e funziona in questo modo:
Esempio:
Voglio iniziare a scrivere la guida sul linguaggio Python:
- Vado nella guida e cerco l'argomento in cui andrà o, nel caso, lo aggiungo;
- Trovo sotto la parte "Programmazione" la scritta "Linguaggi interpretati" e controllo se linka a qualche pagina;
- Se non linka a nessuna pagina, aggiungo il link e creo una pagina "Linguaggi interpretati" in cui volendo scrivo 2 righe ma giusto per far capire agli altri che scrivono che la sto usando e ci metto dentro un link alla pagina Python;
- Se dovesse già esistere guardo se c'è già un link a Python e se non c'è lo creo;
- Successivamente creo la pagina Python e se voglio la inizio a dividere a sua volta in un indice: Cos'è e come funziona, comandi di base, librerie;
E poi per ognuna di queste parti indicate creo una pagina in cui inizierò finalmente a scrivere.
Vi sembrerà un modo stupido ma ci permette di avere un indice generale e allo stesso tempo uno più dettagliato e di navigare facilmente nel libro.
Con The Wanderer stiamo vedendo, poi, se aggiungere in alto un link che spieghi dove ci si trova, come in un forum, cioè nella pagina Python ci sarà scritto in alto: Indice -> Linguaggi interpretati -> Python.
[modifica] Scrivere nelle pagine
Un paio di cose: se dovete citare delle cose o scrivere del codice mettete uno spazio all' inizio della riga, facendo quindi una citazione.
Così.
Per mettere foto ho scritto una paginetta che spiega tutto passo passo quà: Aiuto:Immagini
Per mettere dei titoli di paragrafo e avere poi un indice riassuntivo è sufficiente scrivere
== Titolo paragrafo ==
Attenzione: non compare il menu riassuntivo con meno di 4 paragrafi.
Se dovete poi fare un sottoparagrafo è sufficiente aggiungere un =, e così via per aggiungere altri sottoparagrafi:
=== Titolo paragrafo ===
Per i collegamenti nelle pagine: Utilizzate SEMPRE i collegamenti interni per collegarvi a pagine interne della wiki, ovvero se devo linkare adesso la pagina degli autori non dirò mai a wiki di andare a http://hacknowledge.... eccc ma sempre usare i collegamenti interni, quindi fare
[[Nome Della Pagina Da Collegare]]
Può capitare che abbiate esigenze particolari e dobbiate linkare a una pagina interna usando però un altro nome, ovvero se io ora voglio mandarvi alla pagina Autori ma voglio che lo facciate premendo su una scritta differente come AutoriDelLibro purchè arriviate nella stessa pagina è possibile farlo utilizzando
[[Autori|AutoriDelLibro]]
A volte è necessario avere una pagina però proprio con diversi nomi, in modo che sia richiamabile in vari modi, e per farlo è sufficiente si può creare una pagina AutoriDelLibro in cui inserirete un redirect alla pagina Autori in questo modo:
#REDIRECT [[Autori]]
Un' altra cosa: se non volete che per errore, in un vostro codice wikipedia individui dei codici per gli articoli come
'''Grassetto'''
allora mettete prima e dopo quello che volete scrivere
<nowiki>'''Grassetto'''</nowiki>
Per inserire spezzoni di codice potete procedere così:
se volete anche il syntax highlighting
<source lang=nomelinguaggio>codice</source>
come ad esempio
print "hello world"
i linguaggi supportati sono:
abap, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, c, c_mac, caddcl, cadlisp, cfdg, cfm, cpp, cpp-qt, csharp, css, d, delphi, diff, div, dos, dot, eiffel, fortran, freebasic, genero, gml, groovy, haskell, html4strict, idl, ini, inno, io, java, java5, javascript, latex, lisp, lua, m68k, matlab, mirc, mpasm, mysql, nsis, objc, ocaml, ocaml-brief, oobas, oracle8, pascal, per, perl, php, php-brief, plsql, python, qbasic, rails, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vb, vbnet, vhdl, visualfoxpro, winbatch, xml, xpp, z80
In alcuni punti potrebbe essere necessario mettere una nota riguando a un termine, per farlo è sufficiente affiancare alla parola o alla frase di cui fare la nota
<ref>descrizione</ref>
e successivamente aggiungere al termine della pagina un paragrafo "Note" in cui inserire
<references/>
Verranno automaticamente generati dei numeri a fianco delle parole/frasi nel testo che saranno poi collegati alla parte nel paragrafo note in cui compaiono le descrizioni
+Gnix:Se avete dei dubbi sulla formattazione vi rimando al link seguente: http://www.mediawiki.org/wiki/Help:Formatting .
[modifica] Conflitto di edizione
Può capitare a volte di aver scritto una pagina e dopo aver fatto click su pubblica trovarsi un conflitto di edizione che costringe a riscrivere la pagina da capo. Ciò avviene perchè qualcun altro ha pubblicato una sua versione della voce mentre stavate scrivendo la vostra. Per evitare questo genere di disagi, quando si sta scrivendo una voce è bene scrivere all'inizio della voce e pubblicare subito queste due righe:
{{Modifica}}
--~~~~
[modifica] Gestione delle modifiche delle pagine
Qualche informazione che saprete usare bene:
Per vedere tutte le ultime modifiche fatte nella wiki andate nella pagina Speciale:UltimeModifiche
Per vedere le modifiche fatte a una pagina nel corso del tempo premete sulla linguetta "cronologia" in alto sopra la pagina, e potrete vedere tutte le aggiunte e le modifiche fatte a una pagina. Se volete criticare qualcosa o proporre una modifica senza modificare direttamente la pagina provocando magari rabbia nello scrittore, potete utilizzare la pagina di discussione, che tra breve sarà utilizzabile anche dagli utenti non scrittori, quindi chiunque potrà criticare o proporvi una correzione del vostro lavoro.
[modifica] Pagine personali
Se volete Create una vostra pagina personale in cui spiegate chi siete e che fate, possibilmente createla sotto il nome "Utente:VOSTRONICK" e poi fate una pagina "VOSTRONICK" che fa un redirect come spiegato sopra all'altra pagina, tutto questo per una questione di diffusione della pagina personale, così compare anche cercando altre cose, io ho già fatto la mia :P
se c'è qualche problema battete un colpo.
