Revisione Wiki

Da Guide@Debianizzati.Org.
Vai alla navigazione Vai alla ricerca
Swirl-100-alpha.png Benvenuti sulla pagina dedicata al progetto di revisione di Guide@Debianizzati.Org




Introduzione

In questa pagina cercheremo di coordinare la revisione del wiki, sei libero di contribuire nel modo che preferisci:

  • puoi aderire al progetto aiutandoci a revisionare le guide (vedi la sezione Contribuire)
  • puoi adottare una guida (per informazioni sul progetto Adozioni visita la pagina Adozione Guide)
  • puoi inserire una proposta o un suggerimento per il miglioramento del Wiki: ne terremo conto nel processo di revisione (basta scriverlo nella sezione Proposte)
  • puoi lasciarci un messaggio: il feedback è più che gradito! (inseriscilo nella sezione Messaggi)


Se invece fai già parte del progetto, o semplicemente vuoi sapere in cosa consiste la revisione del Wiki queste sezioni ti possono interessare:

  • Roadmap: l'elenco delle migliorie e delle azioni da intraprendere (viene aggiornato man mano che ne scopriamo di nuove) e l'ordine in cui pensiamo sia meglio effettuarle
  • Bacheca: lo spazio attraverso cui i membri del progetto cercano di coordinarsi: lasciate qui le comunicazioni di servizio;
  • Progetti: i progetti collegati alla revisione.

Roadmap

In questa sezione vanno inserite le varie tappe da seguire nella revisione del Wiki, più o meno nell'ordine in cui abbiamo intenzione di metterle in atto. Ovviamente, l'ordine delle varie fasi è indicativo.

  1. Riordino delle guide esistenti: questa è la prima fase e comprende diversi interventi, tra cui
    • revisione stilistica e della formattazione: per effettuarla in maniera corretta e, soprattutto, omogenea abbiamo elaborato alcune linee guida che cercheremo di integrare, a revisione terminata, nelle pagine di aiuto alla stesura delle guide, così da metterle a disposizione di chiunque voglia scrivere una guida; → FATTO!
    • inserimento del template versioni compatibili; → FATTO!
    • inserimento delle guide non attuali e/o non valide e/o che necessitano di manutenzione in una delle seguenti categorie di gestione: Categoria:Old, Categoria:Da Cancellare e Categoria:Da Adottare → FATTO!
    • verifica dei link della sezione riguardante i libri online e ripristino dei deadlink → FATTO! Sarà ulteriormente aggiornata dal Progetto Free Culture
    • verifica delle voci di glossario → FATTO!
    • verifica delle guide ritenute obsolete (possono essere aggiornate? sono realmente obsolete?) → in atto: ma qualche volontario in più è ben accetto!
  2. Razionalizzazione dell'Indice → in atto
  3. Aggiornamento del materiale esistente:
  4. Avvio nuovi progetti

Bacheca

Spazio riservato all'inserimento di messaggi di coordinamento per chi lavora al progetto. Scrivete pure dopo la linea (ricordatevi di firmarvi!).


Mi mancano un'ottantina di guide da revisionare poi passo direttamente a cercare di inserire, dove posso, il template. @ s3v: sto modificando anche la gerarchia dei titoli, già che ci sono, in quelle che revisiono. Alle altre ci penserà lo script.:D Inserisco un promemoria qui:

  • dovremmo verificare se la Pagina di manuale di module-assistant è obsoleta (presumo di sì) e aggiornarla. Non dovrebbe essere troppa roba: non credo sia andato incontro a cambiamenti radicali in 5 anni, avranno aggiunto e/o tolto un paio di opzioni;
  • mi servirebbe qualcuno che sappia qualcosa di OpenVPN: una delle due guide presenti sul wiki (Openvpn_vediamo_come_installarlo_e_configurarlo) è stata svuotata completamente dall'autore: se è valida la potremmo ripristinare, ma l'altra (Openvpn) mi sembra estremamente completa e ben scritta solo che ripeto non me ne intendo;
  • ho il sospetto che Nokia_N70 (è uno stub) sia la stessa identica guida di Collegare_il_proprio_Nokia_via_USB direi di cancellare la prima, dopo aver verificato: ditemi voi.
MadameZou 20:54, 30 gen 2010 (CET)

Segnalo l'esistenza di quest'ottimo plugin per Firefox/Iceweasel: Mozex. Permette di editare i contenuti del Wiki con il nostro editor di testi preferito.

S3v 00:06, 1 feb 2010 (CET)

Aggiornamento
Ho finito di revisionare le guide che mi mancavano, quindi in teoria la formattazione è a posto in tutte le guide. Le mie prossime mosse sono queste:

  1. sistemare la gerarchia titoli ovunque e contestualmente inserire, dove posso (mediante una ricerca nell'elenco dei pacchetti sul sito Debian), il template versioni compatibili; ----> FATTO!
  2. sistemare la sezione di aiuto all'editing delle guide in modo da rendere possibile la partenza del progetto adozioni;
  3. occuparmi della verifica di alcune guide che non sono state inserite (di proposito) nelle categorie da adottare e/o old ma che richiedono manutenzione.

Inoltre segnalo l'esistenza dell'ottimo WikiEd (utilizzabile su questo wiki solo via Greasemonkey).
E poi, per avere una panoramica rapida e generale dei tag utilizzabili (anche per simboli speciali: se gli strumenti ci sono, utilizziamoli e il wiki aumenterà di qualità!) date un'occhiata qui, io faccio spesso riferimento a questa pagina e la trovo davvero utile e chiara. Buon lavoro!:D

MadameZou 12:25, 7 feb 2010 (CET)

Proposta
Che ne dite di un nuovo template, una specie di Warningbox con testo predefinito da inserire nelle guide che trattano software e/o hardware closed-source (vedi guide su Skype, iPod, Opera, repository Google, etc)? Pensavo di crearne uno da mettere ad inizio guida, come una sorta di Disclaimer che recitasse una cosa più o meno del tipo "Attenzione!Questa guida tratta di software/hardware closed-source: questo significa che gli sviluppatori/produttori non aderiscono alle linee guida del progetto Debian." O una cosa del genere...Troppo talebana?:D Se vi piace mi metto a produrlo: coi template ci ho preso gusto!

MadameZou 19:40, 7 feb 2010 (CET)

FAQ
La pagina delle FAQ contiene materiale obsoleto (tipo le info su Java). Andrebbe rivista.
Privacy & friends
In fondo ad ogni pagina della guida vi sono tre link a pagine vuote:
Informazioni sulla privacy
Informazioni su Guide@Debianizzati.org
Avvertenze
bisogna riempirle decidendo cosa scriverci.
Software proprietario
Più che un banner per me sarebbe più pulito inserire questo software in una categoria a parte, ad esempio [Non-free].

S3v 13:30, 17 feb 2010 (CET)

Patch a WikEd
Una patch da applicare al file ~/.mozilla/firefox/qualcosa.default/gm_scripts/wiked/wiked.user.js per poter applicare i tag pre e code cliccando su due pulsanti. La patch funziona con la versione 0.9.90n di WikEd. La versione utilizzata si può leggere nello stesso file wiked.user.js.

--- wiked.user.js    2010-04-06 20:39:34.367421483 +0200
+++ wiked.user.js.orig    2010-04-06 20:41:00.103422325 +0200
@@ -165,6 +165,10 @@
             'wikEdTable title':            'Table',
             'wikEdReferences alt':         'References',
             'wikEdReferences title':       'References location (shift-click: References section)',
+            'wikEdCode alt':               'Code',
+            'wikEdCode title':             'Code',
+            'wikEdPre alt':                'Pre',
+            'wikEdPre title':              'Pre',
 
 // textify buttons
             'wikEdWikify alt':             'Wikify',
@@ -386,6 +390,7 @@
             'clearSummary':        '2/2c/WikEd_clear_summary.png',
             'close':               '9/97/WikEd_close.png',
             'closeToolbar':        '1/1d/WikEd_close_toolbar.png',
+            'code':                'b/b2/Page_white_code.png',
             'ctrl':                '1/10/WikEd_ctrl.png',
             'definitionList':      'f/f5/WikEd_definition_list.png',
             'diff':                'd/db/WikEd_diff.png',
@@ -430,6 +435,7 @@
             'nowiki':              '5/5a/WikEd_nowiki.png',
             'numberList':          '3/3b/WikEd_number_list.png',
             'jumpPrev':            'c/c7/WikEd_jump_prev.png',
+            'pre':                 '6/69/Application_osx_terminal.png',
             'preview':             '3/31/WikEd_preview.png',
             'redirect':            'f/fa/WikEd_redirect.png',
             'redo':                'd/d7/WikEd_redo.png',
@@ -820,6 +826,8 @@
             23: ['wikEdImage',            'wikEdButton',          wikEdText['wikEdImage title'],            wikEdImage['image'],               '16', '16', wikEdText['wikEdImage alt'],            'WikEdEditButton(obj, objId);' ],
             24: ['wikEdTable',            'wikEdButton',          wikEdText['wikEdTable title'],            wikEdImage['table'],               '16', '16', wikEdText['wikEdTable alt'],            'WikEdEditButton(obj, objId);' ],
             11: ['wikEdReferences',       'wikEdButton',          wikEdText['wikEdReferences title'],       wikEdImage['references'],          '16', '16', wikEdText['wikEdReferences alt'],       'if (!eventShiftKey) { WikEdEditButton(obj, objId); } else { WikEdEditButton(obj, \'wikEdReferencesSection\'); }' ],
+            100: ['wikEdCode', 'wikEdButton',     wikEdText['wikEdCode title'], wikEdImage['code'], '16', '16', wikEdText['wikEdCode alt'], 'WikEdEditButton(obj, objId);' ],
+            101: ['wikEdPre', 'wikEdButton',     wikEdText['wikEdPre title'], wikEdImage['pre'], '16', '16', wikEdText['wikEdPre alt'], 'WikEdEditButton(obj, objId);' ],
 
 // wikify, textify
             26: ['wikEdWikify',           'wikEdButton',          wikEdText['wikEdWikify title'],           wikEdImage['wikify'],              '16', '16', wikEdText['wikEdWikify alt'],           'WikEdEditButton(obj, objId);' ],
@@ -912,7 +920,7 @@
 // WikedInitButtonBar: define built-in button bars (id outer, class outer, id inner, class inner, height, grip title, button numbers)
     window.WikedInitButtonBar = function() {
         WikEdInitObject(wikEdButtonBar, {
-            'format':    ['wikEdButtonBarFormat',    'wikEdButtonBarFormat',    'wikEdButtonsFormat',    'wikEdButtonsFormat',    44, wikEdText['wikEdGripFormat title'],  [1,2,3,4,5,6,7,8,9,10,12,13,14,'br',15,16,17,19,20,21,22,23,24,11,80,25,76] ],
+            'format':    ['wikEdButtonBarFormat',    'wikEdButtonBarFormat',    'wikEdButtonsFormat',    'wikEdButtonsFormat',    44, wikEdText['wikEdGripFormat title'],  [1,2,3,4,5,6,7,8,9,10,12,13,14,23,'br',15,16,17,19,20,21,22,24,11,80,25,100,101] ],
             'textify':   ['wikEdButtonBarTextify',   'wikEdButtonBarTextify',   'wikEdButtonsTextify',   'wikEdButtonsTextify',   44, wikEdText['wikEdGripTextify title'], [26,'br',27] ],
             'custom1':   ['wikEdButtonBarCustom1',   'wikEdButtonBarCustom1',   'wikEdButtonsCustom1',   'wikEdButtonsCustom1',   44, wikEdText['wikEdGripCustom1 title'], [ ] ],
             'find':      ['wikEdButtonBarFind',      'wikEdButtonBarFind',      'wikEdButtonsFind',      'wikEdButtonsFind',      44, wikEdText['wikEdGripFind title'],    [39,40,'find',41,76,43,44,'br',46,47,'replace',48,49,50,51] ],
@@ -4987,6 +4995,8 @@
         case 'wikEdSubscript':
         case 'wikEdWikiLink':
         case 'wikEdWebLink':
+        case 'wikEdCode':
+        case 'wikEdPre':
             WikEdGetText(obj, 'selection, cursor');
             if (obj.selection.plain != '') {
                 obj.changed = obj.selection;
@@ -5398,6 +5408,30 @@
             }
             obj.changed.keepSel = true;
             break;
+
+// code
+        case 'wikEdCode':
+            if ( /<code>((.|\n)*?)<\/code>/i.test(obj.changed.plain) ) {
+                obj.changed.plain = obj.changed.plain.replace(/<code>((.|\n)*?)<\/code>/gi, '$1');
+            }
+            else {
+                obj.changed.plain = '<code>' + obj.changed.plain + '<\/code>';
+                obj.changed.plain = obj.changed.plain.replace(/(<code>)( *)((.|\n)*?)( *)(<\/code>)/, '$2$1$3$6$5');
+            }
+            obj.changed.keepSel = true;
+            break;
+
+// pre
+        case 'wikEdPre':
+            if ( /<pre>((.|\n)*?)<\/pre>/i.test(obj.changed.plain) ) {
+                obj.changed.plain = obj.changed.plain.replace(/<pre>((.|\n)*?)<\/pre>/gi, '$1');
+            }
+            else {
+                obj.changed.plain = '<pre>' + obj.changed.plain + '<\/pre>';
+                obj.changed.plain = obj.changed.plain.replace(/(<pre>)( *)((.|\n)*?)( *)(<\/pre>)/, '$2$1$3$6$5');
+            }
+            obj.changed.keepSel = true;
+            break;
 
 // superscript
         case 'wikEdSuperscript':

Linee Guida

Di seguito alcune indicazioni per rendere omogeneo il processo di revisione dello stile e della formattazione delle guide.

  1. La revisione si propone di mantenere lo stile di chi ha scritto la guida.
  2. Il revisore si propone il compito di correggere TUTTI gli errori grammaticali presenti nel testo, facendo particolare attenzione ad accenti, apostrofi, punteggiatura.
    A questo proposito:
    • Uso della punteggiatura

      Tutti i segni di interpunzione (virgola, punto, punto e virgola, punto esclamativo, ecc.) seguono direttamente la parola che li precede, senza spazi, e vanno separati dalla parola successiva con uno spazio. Non fanno eccezione i punti alla fine di un periodo. Es. "L'italiano, il francese e lo spagnolo sono lingue neo-latine."
      [...]
      Le parentesi di apertura hanno uno spazio che le precede mentre la parola successiva è attaccata ad esse. Il contrario è normalmente vero per le parentesi di chiusura, mentre non va messo alcuno spazio tra queste ed eventuali segni di punteggiatura. Es. "Esempio (dell'uso) di parentesi." In particolare, la punteggiatura del testo circostante non va inserita all'interno delle parentesi ma va posta dopo la parentesi di chiusura. Es. "Altro esempio (dell'uso di parentesi)." Regole per la buona traduzione, a cura di E.Aina

    • Uso delle maiuscole

      Mentre in inglese è convenzione porre tutte le lettere iniziali delle parole componenti un titolo in maiuscolo, in italiano ciò è considerato errore, in quanto solo la prima parola usa l'iniziale maiuscola. Regole per la buona traduzione, a cura di E.Aina

    • Accenti

      È da considerarsi errore l'uso di una vocale seguita da un apostrofo «'» o da un apice inverso «`» per simboleggiare una vocale accentata. Se la codifica lo consente, vanno sempre impiegati i simboli appositi, sia per le minuscole che per le maiuscole.
      Nell'ambiente X11 usato sui sistemi UNIX, le maiuscole accentate sono ottenibili usando il tasto BlocMaiusc insieme agli stessi tasti usati per le minuscole.
      Le vocali "a", "i" e "u" possiedono solo una possibile pronuncia e quindi vanno sempre poste con l'accento grave ("à", "ì", "ù"). La vocale "o", invece, può essere sia aperta che chiusa ma, poiché non esistono parole tronche che terminano per "o" chiusa, l'accento alla fine della parola è sempre grave ("ò"). In generale, è convenzione comune in editoria utilizzare esclusivamente l'accento grave sulle vocali "a", "i", "o" e "u".
      Per la vocale "e" la situazione è più complicata: normalmente va usato l'accento grave ("è") ma in alcuni casi va usato quello acuto ("é"): "perché", "affinché", "poiché" (in generale tutti i vocaboli che terminano in "ché"), "né", "sé".
      Regole per la buona traduzione, a cura di E.Aina

  3. La correzione grammaticale riguarda, nei limiti del possibile, anche eventuali parole scritte senza la lettera maiuscola iniziale (linux, debian, lenny etc) o acronimi non scritti in maiuscolo (usb, cd-rom, bios, etc).
  4. Nel limite del possibile integrare la guida con l'aggiunta di link ad altre guide per migliorare l'integrazione e l'articolazione interna della struttura del Wiki.

Progetti

Alcuni progetti nati nell'ambito del processo di revisione del Wiki.

  • Progetto Adozioni: per informazioni si veda alla pagina Adozione Guide
  • Progetto Bash
  • Progetto Free Culture

Proposte

Avete dei suggerimenti, delle proposte, delle indicazioni da darci sul processo di revisione di Guide@Debianizzati.Org? Questa è la sezione in cui inserirle! Scrivetele dopo la linea, firmandovi con nome utente e data (per firmarsi con nome utente e data basta inserire il simbolo ":" seguito da "~~~~" in questo modo :~~~~). Per scrivere nel Wiki dovrete prima esservi registrati: ci vuole un attimo, basta andare su questa pagina.



  • Draft Page

Sarebbe utile avere una pagina draft all'interno dello spazio utente, tale pagina non dovrebbe venire pubblicata, ma verrebbe usata dall'utente per scrivere una brutta copia della futura guida, prendendo appunti e realizzando bozze.

  • Update CC v3

Si potrebbe aggiornare la Creative Commons alla versione 3. Propongo di scegliere la CC-by-sa 3.0 in quanto ritenuta compatibile con la DFSG [1]

fr4nc3sc0 00:46, 30 gen 2010 (CET)


||--Wtf 18:23, 11 ago 2011 (CEST)||

La pagina dell'indice generale sembra piuttosto lunga e dispersiva, in particolare perché vengono messe sullo stesso piano guide vaste, articolate e non strettamente legate ad un pacchetto con pagine magari brevi e specifiche ad un singolo pacchetto. Anche l'attuale suddivisione logica delle macrosezioni non mi sembra funzionale, personalmente rivedrei il tutto così:

  1. Mondo Debian
    • Introduzione
    • Debian Live
    • Ports
    • Varie
  2. Sistema
    • Installazione
    • APT
      • aptitude, apt-get, pacchetti in genere sia lato client che server
      • Repository
    • GRUB
    • Kernel
  3. Ambienti grafici
    • Gnome
    • KDE
    • ecc.
    • Applicativi validi per più ambienti
  4. Bash
  5. Directory, file e filesystem (compresa la condivisione delle risorse e la crittografia)
  6. Hardware
  7. Networking
    • Connettività
    • Configurazione reti
    • File sharing
    • Gestione remota/locale (ftp, ssh, ecc.)
    • Mail
    • Sistemi di autenticazione e sicurezza
    • Webserver
    • ecc.

Quindi nella pagina principale metterei il soprastante indice, dove ogni riga punta alla pagina generale di sezione e contestualmente escluderei qualunque collegamento a guide specifiche. Si potrebbe associare ad ogni voce una breve descrizione per aiutare il lettore a capire in quale sezione è più probabile che trovi quello che sta cercando. Nelle singole pagine di sezione andrei poi a mettere le sottosezioni e i relativi collegamenti alle guide specifiche ragruppandoli per argomento (es.: * samba ** guida1 ** guida2 ** ecc.), distinguendo magari tra guide generali (o comunque articolate) e guide legate esclusivamente (o per la maggior parte) ad un singolo pacchetto. Sarebbe poi carino fare sistematicamente quello che è stato fatto per questa guida e quest'altra, ovvere un indice che fornisca una seconda mini classificazione complementare a quella definita dall'indice generale. In tale ottica sarebbe poi utile codificare un sistema standard di nomenclatura per le guide.

Ciao Wtf, innanzitutto grazie dell'interessamento e della pazienza nel redigere uno schema di indice.
Come saprai è in corso da un bel po' un'opera abbastanza lunga che dovrebbe portare alla revisione dell'attuale pagina iniziale del Wiki. All'interno di questa dovrebbe (deve) comparire un nuovo indice basato sul concetto di categorie che va a sostituire l'attuale indice, inutilmente dispersivo e poco adatto alla ricerca della guida d'interesse.
A riguardo guarda anche:

S3v 15:06, 17 ago 2011 (CEST)

Ciao S3v, grazie per la risposta e complimenti per l'ottimo lavoro.
Della revisione avevo già letto qualcosa, inoltre ero già a conoscenza della pagina Lista_Categorie (di cui ad esser sinceri ho scoperto l'esistenza solo poco prima di aver scritto qui), mentre ignoravo completamente l'esistenza delle altre due.
Credo che l'attuale pagina delle categorie sarebbe una buona pagina di indice, mentre le altre due penso siano da mal di testa ;). Se si deve creare un elenco così lungo e articolato allora forse tanto vale fare un indice alfabetico delle guide, visto che la leggibilità dello stesso è inevitabilmente limitata a causa dell'enorme mole di righe.
A proposito della pagina delle categorie, trovo che graficamente sia ben fatta e soprattutto ben leggibile, si ha infatti un ottimo colpo d'occhio sulle righe e gli oggetti della pagina. È soprattutto per questo che prima ho detto che tale pagina sarebbe un buon indice. Vorrei però criticare (in termini costruttivi) la scelta delle parole chiave per alcune sezioni e la relativa catalogazione. Analizzo punto per punto:

  1. Conoscere Debian, nulla da dire;
  2. Configurare Debian e Usare Debian, mi sembrano diciture troppo generiche, anche perché in linux usare implica molto spesso anche configurare. Ho dato un occhiata rapida alle guide di entrambe le sezioni e mi pare che alcune guide di usare potrebbero stare bene in configurare. Tra l'altro la categoria bash figura in entrambe le sezioni.
  3. Debian in rete e Debian Server, sono categorie che potrebbero avere senso in windows, ma non in linux. Per esempio in windows per mettere in rete due pc desktop non devo fare nulla di particolarmente difficile, in linux sono costretto ad usare concetti e strumenti della sezione server come samba e nfs (anche se ovviamente il livello di padronanza richiesto sarà diverso nel caso di rete domestica e rete aziendale da piccolo-media in su). Per non parlare di ssh che è uno strumento fondamentale anche per una piccola rete domestica.
  4. Sulle rimanenti categorie non ho nulla da dire.

In sintesi al posto di "configurare debian" e "usare debian" adotterei i classici "sistema", "grafica", "internet", "multimedia" e "Ufficio" (che ora sono solo sotto categorie); è vero che così facendo aumento di tre il numero delle sezioni, ma guadagno tantissimo in chiarezza, oltre che per la consultazione anche per chi scrivendo una guida si trova a dover decidere come classificarla.
Per quanto riguarda "rete" e "server" unificherei senza pensarci due volte sotto il nome di "rete".
Infine alcune categorie a mio giudizio andrebbero ripensate, per esempio "Servizi di Sistema" e "Samba"; la prima è troppo generica, mentre la seconda è troppo specifica. Tra l'altro perché "FTP" dovrebbe essere alternativa a "condivisione risorse"? A tal proposito io lascerei proprio perdere "condivisione risorse" e mi limiterei a "reti linux-windows", "reti linux-linux", ecc. La categoria "SSH server e amministrazione remota" la farei diventare semplicemente "Amministrazione remota". infine introdurrei una categoria "Monitoraggio hardware", dove infilare le guide su sensori di temperatura, regolazione della frequenza della cpu ecc. (contestualmente trasformerei "monitoraggio" in "monitoraggio rete" o "monitoraggio sistema").

||Wtf 19:41, 23 ago 2011 (CEST)||

Contribuire

I volontari sono bene accetti! Qualunque cosa tu sappia - o non sappia - fare, sicuramente tornerà utile nella revisione del Wiki. Se vuoi aiutarci, controlla la Roadmap per farti un'idea di quello che stiamo facendo al momento, e poi inserisci un messaggio nella sezione messaggi.

Messaggi

Per i messaggi di incoraggiamento, e/o (soprattutto) di informazioni scrivete pure qua sotto: vale quanto detto al paragrafo Proposte cioè che per scrivere sul wiki dovete prima registrarvi! Inserite i vostri messaggi sotto la linea.