Guida alla pubblicazione di un articolo

Da Mandriva Italian.

Prima di cominciare...

Contribuire, si ma come ? e da dove comincio ? e cosa scrivo ? Questi e altri quesiti intimoriscono il potenziale scrittore. Questa guida cercherà di darvi le linee guida per la stesura di un articolo, nella speranza che possiate contribuire serenamente e a lungo. Questa è una guida per la mente, per i dettagli tecnici sul come scrivere vi rimandiamo a: Come scrivere in questo Wiki e Come usare questo Wiki

Idee chiare

Prima di scrivere un articolo fate in modo che l'articolo sia almeno nella vostra testa, cioè che abbiate ben presente cosa volete scrivere, su che argomento, le varie sezioni dell'argomento e tutte le complessità legate alla scrittura di un tema. Il Wiki è strutturato per poter revisionare con facilità gli articoli, tuttavia sarebbe una bella cosa se prima prendeste un bel foglio ( elettronico o di carta .. la cara vecchia carta ) e ci scriveste una brutta copia di ciò che avete in mente. Solo successivamente e dopo una prima revisione, trascriverete il vostro tema nel Wiki, avendo cura di dare un primo layout di base che sia semplice e leggibile. Semplicità, essenzialità ed esaustività, sono i dogmi che dovrebbero guidare l'autore di un articolo nella scrittura.

Mantenere l'impegno

Scrivere è impegnativo e richiede tempo. Contribuire al Wiki dovrebbe essere fatto in un ottica "Roddenberriana", dovrebbe, cioè, coinvolgervi sul piano umano e darvi la soddisfazione di condividere le vostre conoscenze. Se prendete l'impegno di scrivere un articolo dovreste avere la forza di volontà di portarlo avanti fino in fondo. Chiunque contribuisce lavora, studia, ha famiglia e impegni, però si dovrebbe sforzare di dare il suo contributo, piccolo o grande che sia, fino in fondo.

Prima di tutto leggete

A meno che non possediate la bacchetta magica, difficilmente potrete riuscire a far bene da subito, prima di scrivere fatevi un giro panoramico per il Wiki, leggete gli altri articoli, guardate come sono impaginati, le piccole convenzioni non scritte, i layout. Cercate di capire l'uso dei template, il significato delle categorie. Guardatevi attorno come fareste se foste in una grande città senza la mappa: girereste per rendervi conto di dove siete e cosa offre l'ambiente. Le idee giuste verranno da sole e capirete l'importanza di titoli e categorie.

Scegliere il giusto titolo

Se avete letto Come scrivere in questo Wiki avrete di sicuro capito l'importanza del titolo dell'articolo, perché, lo ricordiamo per comodità, non solo rappresenta l'intestazione della pagina, ma diventa anche il link con cui l'articolo viene indirizzato (.. e ricercato ). Vi ricordiamo anche che prima di convalidare il titolo di una pagina, meglio ancora prima di scriverla, è necessario cercare se esiste già un articolo con le stesse tematiche o addirittura lo stesso titolo. Una pagina convalidata non è più cancellabile e diventa un piccolo problema. Immaginate un Wiki con centinaia di "piccoli problemi"...

Corto o lungo ?

Giusto, ovviamente no ? Il fatto che sia corto o lungo poco importa, l'importante è che sia mirato: pertinente col contenuto e grammaticamente ineccepibile. Un titolo deve dare subito l'indicazione di cosa stiamo per leggere. "Installare driver proprietari per schede video" è lungo ma da l'idea precisa di cosa andremo a leggere, se qualcuno cerca informazioni su una scheda audio di sicuro non leggerà mai il relativo articolo. "Templates" è corto ma è inequivocabile: sono gli schemi di base per la formattazione del testo nel Wiki.

Il titolo come indice

Il Wiki indicizza i titoli e ne pubblica il sommario in cima all'articolo, le sezioni di un articolo devono essere scelte e scritte con altrettanta cura, anche le sezioni vengono indicizzate dai motori di ricerca e sono linkabili come qualsiasi altro indirizzo internet, quindi, come i titoli, servono oltre che ad aiutare nella comprensione della lettura, anche come riferimento per le pagine. Cercate di organizzarli sempre in modo coerente e utilizzateli per suddividere i paragrafi

Crisi creativa

Se state disperando per cercare un titolo adatto, il trucco sta nel ricercare le giuste parole che riassumono il tema dell'articolo. Se avete creato una introduzione all'articolo probabilmente è li che queste parole vanno ricercate. Se avete perso l'orientamento fate mente locale sui motivi per cui avete scritto un articolo, vedrete che il titolo verrà da solo.

La grammatica

La guida l'avete letta ? no ? allora forse è il caso di ripassarla. Se ancora non vi è entrato in testa lo ripetiamo qui: i titoli non si possono rinominare ! Una volta che sono stati convalidati possono solo essere reindirizzati, quindi se per caso fate errori di grammatica, sarete frustati sulla pubblica piaz.... ehm... sarete obbligati a reindirizzare la pagina e poi ad avvisare l'amministratore del Wiki che c'è una pagina da cancellare, probabilmente vi invierà un pacco bomba a casa e voi saprete il perché ;) Rileggete sempre con attenzione, specie se gli articoli li scrivete a notte fonda dopo un numero considerevole di birre con gli amici.. e una lunga, lunghissima e pesante giornata di lavoro... doh !

Associare la giusta categoria

Un articolo non dovrebbe mai essere generico. Genericamente si può fare una introduzione o descrivere una categoria, ma l'articolo dovrà riguardare uno specifico argomento di una ben precisa categoria. Le categorie sono state create per mettere ordine in un mondo che non ha gerarchie: il Wiki. Le categorie le dovrete scegliere voi che scrivete gli articoli, un compito che può essere tutt'altro che facile.

In principio era il caos...

Tanto tempo fa il Wiki assomigliava ad un immenso scatolone con dentro migliaia di fogli alla rinfusa. Qualcuno un bel giorno ha deciso che il sistema non era molto comodo per cercar le cose, specie quando il foglio che serviva era l'ultimo in fondo al cartone. Il Wiki quindi è stato indicizzato per categorie, le categorie potevano essere associate gerarchicamente e il tutto ha cominciato ad assomigliare ad un albero: se seguite il tronco, poi un ramo, poi un rametto, prima o poi arrivate alle foglie. Le foglie sono gli articoli, tronco e rami le categorie. Alla base c'è il terreno, cioè il portale del Mandriva Wiki.

Scegliere la categoria

Il vostro articolo è pronto ed è una fantastica guida per: download dei sorgenti, compilazione, uso e risoluzione dei problemi di un bel editor non lineare per il video, ora dovete solo sceglierne la categoria. Sfogliando le pagine speciali del Wiki è possibile trovare le categorie che sono già state create. Come sempre è buona norma utilizzare ciò che è già stato creato, in modo da mantenere un certo ordine delle cose ed evitare i cloni. Il software è un .. programma ( doh ! ) e come tale va nella categoria software. Ovvio no ? però è anche un editor, e quindi va associato alla categoria editor, che diventa sotto-categoria dei software. Però ci accorgiamo anche che è un programma che fa elaborazioni audio e video.. e quindi andrà associato anche alla categoria audio, e pure a quella video. Altre due sotto categorie di una sotto categoria.... Facile no ?

Cambiare idea

A differenza dei titoli le categorie sono sempre facilmente editabili. Possono essere modificate, aggiunte o tolte nel corso del tempo. Se una notte vi dovesse capitare di svegliarvi con un sussulto e ricordarvi all'improvviso che forse, la categoria non era quella giusta.. beh potete tornare a dormire sonni tranquilli, la mattina dopo potrete tranquillamente editare il testo [[categoria:una_a_caso]] del vostro articolo scrivendo qualcosa di più sensato...

Creare i link

I link sono importanti quasi quanto il testo che scriverete. Si usano per riferimento e integrazione ai propri testi. I collegamenti dovrebbero sempre puntare a pagine esistenti o comunque a pagine che si pensa che prima o poi verranno scritte. I link fanno la forza del Wiki.

Link Esterni ed interni

All'interno di un articolo potrete linkare qualsiasi pagina del Wiki. I templates sono pagine, le categorie sono pagine, le discussioni pure e perfino gli utenti hanno la loro pagina di riferimento.Usateli ogni volta che lo ritenete opportuno. Allo stesso modo potete linkare qualsiasi pagina web esterna che abbia rilevanza con quello che state scrivendo.

Cose da evitare nei link

Link errati, link che portano a pagine vuote, link sgrammaticati. Link complessi senza testo alternativo, ad esempio
http://www.dominio.sottodominio.it/directory/sottodirectory/file_binario_chilometrico_fatto_da_decine_di_caratteri_alfanumerici_tipo-jhhahfuh93858hif98h4978.php
che rompono la linearità del testo. Il testo alternativo è stato inventato apposta: Link al sito è decisamente meglio.

Cose da sapere sui link

Il link interni che portano a pagine vuote entrano nella categoria "Pagine richieste". Questa cosa accade anche quando un link interno punta ad una pagina sbagliata per un errore di ortografia o per aver utilizzato un link simile a quello giusto. La proliferazione delle pagine richieste sarebbe da limitare. Cercate di creare sempre link validi. Se scrivete un articolo o lo traducete, abbiate cura di editare i link in modo che coincidano con le eventuali pagine esistenti. Fate sempre una ricerca di un titolo per vedere se un articolo può corrispondere ad un vostro link interno. Consultate preventivamente le Pagine richieste quando state per scrivere un articolo nuovo: è possibile che in un altro articolo qualcuno abbia creato un link ad una pagina ancora da scrivere, quindi una pagina richieste.. e quella pagina sia esattamente quello che voi state scrivendo.

Usare le immagini

Le immagini sono un altro aspetto importante del Wiki, quando le parole non riescono a spiegare, le immagini vengono in soccorso del lettore ( e soprattutto di chi scrive ). Immaginate tutte quelle situazioni in cui è necessario spiegare l'uso di opzioni, pulsanti, check box, o mostrare, ad esempio, gli effetti di un filtro di The Gimp, o una sequenza di operazioni da fare durante una installazione. Nel testo le immagini alleggeriscono la lettura e completano l'articolo, creano dinamicità e danno colore. Usatele quando è possibile.

Le dimensioni contano

Immaginate di inserire uno screenshot di un bel monitor full HD 1080p la cui risoluzione è 1920x1080 pixel. Prendete questa immagine e caricatela nel Wiki e poi inseritela in un testo. Il risultato sarà una specie di lenzuolo colorato che invaderà lo schermo di qualunque povero lettore con un monitor 1024x768. Cercate di non superare i 1280x800 pixel.. e ricordatevi sempre che le immagini possono sempre essere mostrate come thumbnail linkati all'immagine ad alta risoluzione con tanto di didascalia.

La qualità conta

Sempre in un ottica di leggibilità pensate ad una immagine dimensione francobollo. Immaginatela su quel famoso schermo 1920x1080 pixel di cui sopra, e ora chiedetevi come si possa leggere un francobollo su quella specie di schermo da cinema. Anche zoomando compare una scacchiera policroma illeggibile. La qualità di ciò che viene caricato è molto importante. La dimensione massima è 2Mbyte, che permettono di poter salvare sul server Wiki file jpeg di ottima qualità. Come riferimento sappiate che mediamente la dimensione di un file jpeg 1024x768 di ottima qualità è 300 kbyte. Il Wiki supporta anche il formato png che oltre ad avere livelli di compressione e qualità paragonabili al jpeg, supporta le trasparenze e semi-trasparenze, permettendo di ottenere splendidi effetti grafici.

Il layout conta

Le immagini nel Wiki possono essere posizionate con estrema cura e completate con didascalie e cornici. Non a caso sono uno degli elementi più completi in termini di opzioni, proprio perché gli viene riconosciuta una estrema importanza nel descrivere ciò che per le parole è un limite. Abbiate cura nel disporle nel testo, non mettetele a casaccio, cercate di fare in modo che il testo le incornici valorizzandole e fate in modo che siano sempre accompagnate da una didascalia. Quando avete più immagini in sequenza potete creare una galleria.

Regole generali per la stesura

Pensate ad un incubo, un unico immenso foglio gigantesco di testo, scritto ignorando punteggiatura, sgrammaticato, con i periodi messi a casaccio. Frasi che perdono i soggetti, tempi verbali incongruenti, immaginate che dobbiate trovare: UNA SINGOLA INFORMAZIONE in questo marasma di lettere. Pensatevi davanti al vostro pc e con quel foglio immenso sullo schermo, da leggere per trovare la singola informazione che vi serve. Uno scenario alquanto inquietante che dovrete cercare di evitare a tutti costi.

Magro è sempre meglio

Dopo aver scritto la bozza cercate di riassumere i concetti, l'ideale sarebbe arrivare ad avere un testo lungo la metà di ciò che avevate prospettato. Piuttosto che riempirlo di ridondanze nel testo, una caratteristica tipica dei testi in inglese, cercate di completare il layout suddividendo i vari paragrfi e completando con immagini. Cercate di evidenziare i concetti principali usando sottolineature e grassetti. Fate in modo che a colpo d'occhio si possa trovare subito le cose più importanti.

Gioia e dolori delle traduzioni

Tradurre dall'inglese presenta delle caratteristiche peculiari: I testi inglesi sono ricchi di ridondanze, i concetti vengono ripresi più volte per fissarli bene in mente. Le particelle pronominali sono sconosciute e potete trovare, ad esempio, la ripetizione del soggetto 50 volte in un paragrafo di 50 righe. La costruzione della frase spesso porta a forme implicite che poco si adattano alla nostra lingua. Quel che dovete curare è la resa del testo in italiano senza perdere il senso generale della frase. Non è un esercizio scolastico di traduzione. Quello che importa è che il testo in italiano sia fluido e comprensibile. In internet si trovano strumenti rapidi e veloci per cercare le parole sconosciute. E' possibile utilizzare i traduttori on line per trovare il senso delle frasi più complesse. Se avete una discreta padronanza della lingua inglese, ricordatevi che il Wiki italiano è sempre alla ricerca di traduttori per dare una mano. Se avete del tempo da dedicare alla comunità Mandriva siete i benvenuti.

Voto 4: in italiano

Ecco l'elenco delle cose da fare e gli errori da doppia sottolineatura rossa, che inevitabilmente vi portano a prendere un bel 4 in pagella :P . Vi raccomandiamo di porre attenzione a link e ortografia, alle ripetizioni e a tutte quelle piccole regole di sintassi che rendono l'articolo leggero e facilmente leggibile:

• La punteggiatura: punti, virgole, due punti, punto a capo e lettera maiuscola !
• La semplicità: frasi corte, pensieri chiari, frasi esplicite.
• La precisione: rileggete sempre i testi a fine scrittura.
• Il buon senso: rileggere i testi dopo qualche giorno, aiuta a rivedere il senso generale dello scritto e a migliorare la sintassi.
• La chiarezza: Ricordatevi che chi legge non ha la sfera di cristallo e non è nella vostra testa.

COSE ASSOLUTAMENTE DA EVITARE

• Evitare i puntini di sospensione al posto delle virgole: state scrivendo e non parlando
• Vietatissime: le frasi gergali, il linguaggio da sms (xè, xò, k al posto del ch, j al posto del gl, gg al posto di giorni, cmq al posto di comunque, numeri al posto delle parole: c6 etc...)
• Essere ermetici: niente forme contorte o parole rare o eccessivamente tecniche, se non supportate da ADEGUATA spiegazione.

Scritto rielaborando la versione inglese da --Dom-X 19:36, 9 ago 2009 (UTC)