|
|
| Riga 1: |
Riga 1: |
| Intro | | ===Intro=== |
|
| |
|
| Questo sito � un wiki, ci� vuol dire che puoi editare ogni pagina semplicemente iscrivendoti e cliccando sul tasto modifica presente (in alto) su ongi pagina. Il motore usato per questo wiki si chiama MediaWiki, ed � lo stesso usato da Wikipedia
| | In questa guida è spiegato come far girare l'accoppiata XGL+Beryl su di un debian Testing, utilizzando schede ATI. |
|
| |
|
| Quelle di seguito sono delle semplici linee guida che abbiamo scritto per sfruttare al meglio le potenzialit� di MediaWiki e per rendere pi� facilmente gestibile il wiki in maniera collettiva.
| | <u> AVVISO: può darsi che il sistema risulti instabile. FATE TUTTO A VOSTRO RISCHIO E PERICOLO.</u> |
| Modificare una pagina
| |
|
| |
|
| Cliccando sul tasto modifica di una pagina (provate su questa pagina di prova: Sandbox) vederete un box con del testo. Modificando quel testo modificherete la pagina, cliccando sul tasto salva.
| | ==Passo 0: il mio computer== |
| Sintassi
| |
|
| |
|
| La sintassi usata � molto semplice e per certi versi � simile al testo semplice non formattato. Puoi trovare uno specchietto con i principali elementi di formattazione qui:
| | Ecco dove ho ottenuto il desktop 3D: |
|
| |
|
| * Help:Editing
| | * Macchina assemblata pentium IV 3.2 Hz 1 Gb RAM; |
| | * Sistema Operativo Debian/Testing Etch aggiornato, Kernel 2.6.17; |
| | * Ambiente Desktop KDE 3.5.5 (ho comunque anche Gnome); |
| | * Scheda Video ATI Radeon X1300; |
|
| |
|
| Altre Regole
| | ==Passo 1: installare i driver ATI e ottenere l'accelerazione 3D== |
|
| |
|
| Alcune regole che rendono pi� facile la gestione del wiki:
| | Si può tranquillamente seguire la guida [[Installazione driver proprietari Ati]] |
|
| |
|
| * Quando modificate una pagina scrivete sempre un sommario prima di salvare. Basta inserire una piccola descrizione delle modifiche nella casella "Oggetto" (in basso sotto il riquadro che contiene l'articolo). L'oggetto della modifica apparir� nella history e render� pi� facile seguire come � stata modificata la pagina nel corso del tempo. Per banali correzioni ortografiche o di battitura spuntare la casella Questa � una modifica minore. Nella history della pagina le modifiche minori possono essere nascoste.
| | Solo un consiglio; prima di installare i driver controlliamo di non avere moduli del driver vecchi: |
|
| |
|
| * Usate sempre il tasto Anteprima prima di salvare le modifiche in modo da vedere il risultato ed effettuare eventuali correzioni subito. In tal modo si evita anche di allungare inutilmente la history della pagina.
| | <pre># module-assistant search fglrx</pre> |
|
| |
|
| * Le pagine in genere non dovrebbero mai essere rinominate. Se avete dato un titolo errato, potete rinominare la pagina ma ricordatevi di aggiornare anche tutti i link alla pagina stessa (guardate l'apposito link nella toolbox a sinistra). Quando una pagina viene rinominata la vecchia pagina conterr� un redirect alla nuova pagina. Tuttavia la nuova pagina non conterr� la storia delle modifiche precedenti allo spostamento e questo rende molto pi� difficile controllare le modifiche.
| | Se otteniamo un risultato del tipo: |
|
| |
|
| * Scegliete accuratamente il titolo, in modo che si capisca subito di cosa tratta la guida, ma evitate titoli troppo lunghi.
| | <pre>fglrx-kernel-source (source package not installed): |
| | – Binary package(s) for kernel(s): |
| | + (2.6.17.3): fglrx-kernel-2.6.17.3_8.27.10-1+10.00.Custom_i386.deb</pre> |
|
| |
|
| Creare una pagina
| | Diamo un bel |
|
| |
|
| Il modo pi� comodo per creare una pagina � quella di creare un link (che sarebbe il titolo racchiuso tra [[ ]]) alla pagina che si vuole creare. Potete usare a questo scopo la vostra pagina personale. Ad esempio se scriviamo:
| | <pre># module-assistant purge fglrx --force</pre> |
|
| |
|
| [[Condivisioni di stampanti in reti miste Linux - Windows]]
| | Una volta installato e configurato il driver disabilitiamo Composite perché fglrx non lo supporta con Dri: |
| | editiamo il file ''/etc/X11/xorg.conf'' con un qualsiasi editor (ad esempio Kate) e alla fine aggiungiamo le righe: |
|
| |
|
| comparir� un link ad una pagina inesistente:
| | <pre>Section "Extensions" |
| | Option "Composite" "0" |
| | EndSection</pre> |
|
| |
|
| Condivisioni di stampanti in reti miste Linux - Windows
| | Se l’installazione è andata a buon fine e se abbiamo l’accelerazione 3D possiamo passare a Xgl e Beryl. |
|
| |
|
| (i link a pagine inesistenti hanno colore rosso), cliccando su questo link non compari� una pagina vuota bens� un pagina in cui potrete inserire il testo dell'articolo.
| | ==Passo 2: installazione di XGL e beryl== |
|
| |
|
| Per approfondimenti su come creare link:
| | Possiamo trovare Xorg nei repository Debian Testing mentre Xgl e Beryl sono reperibili da repository per Ubuntu. |
|
| |
|
| * Help:Editing#Creazione_Link
| | Aggiungiamo quindi i repository nel file ''/etc/apt/spurces.list'' |
| | copiando queste righe (come si può notare ho utilizzato Ubuntu Dapper, forse si può usare anche Edgy, magari si può provare): |
|
| |
|
| Convenzioni
| | <pre>###Beryl repositories |
| | deb http://www.beerorkid.com/compiz dapper main |
| | deb http://xgl.compiz.info/ dapper main |
| | deb-src http://xgl.compiz.info/ dapper main</pre> |
|
| |
|
| Ci sono delle semplici convenzioni da rispettare in modo che il contenuto del wiki cresca in maniera omogenea e quindi pi� facile da leggere, per tutti.
| | apriamo una console testuale e digitiamo |
|
| |
|
| * Tutte le volte che riportate un comando, un pezzo di un file di configurazione, od in genere dei dati ascii racchiudeteli in un riquadro (racchiudendo tra <pre> e </ pre>). | | <pre># wget http://www.beerorkid.com/compiz/quinn.key.asc -O - | sudo apt-key add -</pre> |
| * Se riportate un comando usate come primo carattere $ se il comando deve essere lanciato da utente normale e # se il comando deve essere lanciato da root. Lasciate anche uno spazio dopo questo carattere, in modo che il comando non risulti attaccato al $ o # e quindi poco leggibile.
| |
| * Dividete in maniera logica la guida in sezioni, sottosezioni (e, se necessario sotto-sottosezioni). In questo modo si sfrutter� meglio la potenza di MediaWiki che creer� automaticamente una tavola dei contenuti iniziale che render� molto pi� facile la navigazione nella vostra guida.
| |
| * Usate, quando necessario, i vari elementi di formattazione (descrizioni, riquadro di warning, esempio ecc...): la guida risulter� pi� leggibile.
| |
| * Cercate di rendere leggibile e pulito il codice della pagina, evitando ad esempio di lasciare tante righe vuote consecutive.
| |
| * Cercate il pi� possibile di fare link ad altre pagine del wiki, in modo da aumentare le interconnessioni e rendere pi� facile la ricerca delle informazioni.
| |
|
| |
|
| Firmare una guida
| | aggiorniamo la lista dei pacchetti con il comando |
|
| |
|
| L'autore di una guida pu�, se vuole, firmarla, preferibilmente alla fine. Per inserire la firma basta scrivere:
| | <pre># apt-get update</pre> |
|
| |
|
| : [[Utente:Pliniux|Pliniux]] | | e installiamo i pacchetti necessari: |
|
| |
|
| ottenendo questo (c'� il mio nome perch� l'ho scritto io):
| | <pre># apt-get install xserver-xgl libglitz-glx1 libgl1-mesa beryl beryl-manager emerald emerald-themes</pre> |
|
| |
|
| TheNoise
| | ==Passo 3: configurare il tutto== |
|
| |
|
| se si vuole inserire anche il nome reale e la data basta usare quattro tilde (~) al posto di tre. Cliccando sul nome si accede alla pagina personale di ogni iscritto nella quale potrete scrivere, se volete, informazioni su di voi. | | Completata l'installazione è molto comodo creare uno script per poter scegliere se avviare X normalmente o se avviare Xgl con Beryl. |
|
| |
|
| Per separare la firma dal corpo della guida � consigliabile inserire una linea con quattro trattini (segno meno):
| | Creiamo, sempre utilizzando un editor qualsiasi, il file ''xgl.desktop'' nella cartella |
| | ''/usr/share/xsessions/'' e incolliamo: |
|
| |
|
| ---- | | <pre>[Desktop Entry] |
| | Encoding=UTF-8 |
| | Name=XGL |
| | Exec=/usr/bin/startxgl.sh |
| | Icon= |
| | Type=Application</pre> |
|
| |
|
| che nell'output diventano una linea continua come questa: | | Ora dobbiamo creare uno script che faccia partire Xgl, creando il file ''startxgl.sh'' nella cartella ''/usr/bin/'' |
| Evoluzione delle guide
| |
|
| |
|
| Le guide su Guide @ Debianizzati.org seguono un percorso (idealmente) simile a quello seguito dai pacchetti debian nelle tre distribuzioni. Si distinguono infatti tre fasi per una guida:
| | Copiamo e incolliamo (vale per SCHEDE ATI CON KDE): |
|
| |
|
| * Stub: una guida � in questo stato se � ancora incompleta. Queste guide sono caratterizzate dal seguente box iniziale:
| | <pre>#!/bin/sh |
| | Xgl :1 -fullscreen -ac -accel xv:pbuffer -accel glx:pbuffer & |
| | sleep 4 |
| | export DISPLAY=:1 |
| | exec startkde</pre> |
|
| |
|
| Attenzione questo articolo � ancora incompleto.
| | Salviamo, chiudiamo l'editor e rendiamo lo script avviabile con |
| Sentiti libero di contribuire cliccando sul tasto edit.
| |
|
| |
|
| inseribile semplicemente aggiungendo all'inizio della guida il seguente testo:
| | <pre># chmod a+x /usr/bin/startxgl.sh</pre> |
|
| |
|
| {{stub}}
| | Riavviamo e nel login manager ora possiamo scegliere una sessione XGL (spero funzioni il tutto!). |
|
| |
|
| * Guida completa: la guida � ragionevolmente completa e pu� essere usata per conoscere nuovi argomenti. Le guide di questo tipo non hanno nessun segno particolare. Le guide complete sono state terminate dall'autore iniziale e cercano una sorta di testing da parte della cominit�.
| | ==Passo 4: testare il tutto== |
|
| |
|
| * Guida Debianized: � il terzo � ultimo livello raggiungibile da una guida sul wiki. Una guida di questo tipo ha raggiunto la sua piena maturit� essendo stata verificata e corretta anche da pi� di una persona nella community. Le guide Debianized si distinguono con un apposito Template posto al loro inizio dallo staff di debianizzati. Nell'indice le guide Debianized sono facilmente individuabili da uno swirl: swirl.png. Tutte le guide sul wiki possono diventare debianized una volta ricevuto un sufficiente feedback dalla comunit�.
| | Siamo quasi alla fine: è tempo di testare l'installazione Beryl!. |
| | Apriamo un terminale e diamo il comando: |
| | |
| | <pre># beryl-manager</pre> |
|
| |
|
| Se leggi una guida e verifichi la sua correttezza, perfavore, inserisci alla fine della guida, dopo il nome dell'autore una nota come questa:
| | (andrebbe dato da utente comune ma a me non funzionava, da root invece era tutto ok, in ogni caso se funziona metteremo a posto la cosa in seguito). |
|
| |
|
| Esempio firme in calce ad un articolo
| | Se tutto funziona, si dovrebbe vedere il Beryl splash screen e le finestre diventeranno gommose! |
| | Il system tray dovrebbe mostrare l'icona Beryl – una gemma rossa - che si può usare per regolare Beryl ed Emerald, il theme manager. |
| | Inoltre fornisce la possibilità di ritorno ad un altro window manager (kwin oppure metacity, per esempio), nel caso Beryl si arresti. |
| | Se tutto funziona si può fare in modo che Beryl parta automaticamente per ogni sessione di XGL. |
| | Apriamo un terminale e creiamo il seguente symlink: |
| | |
| | <pre>$ ln -s /usr/bin/beryl-manager ~/.kde/Autostart/beryl-manager</pre> |
|
| |
|
| Autore: The_Noise
| | Facendo così Beryl partirà automaticamente senza dover usare il comando beryl-manager. |
| Verificato: Keltik
| |
|
| |
|
| In tal modo si pu tenere tracci della maturit della guida. Analogamente per correzioni od estensioni di un certo rilievo (non certo per una correzione ortografica) consigliabile inserire una nota come nell'esempio:
| |
|
| |
|
| Esempio firme in calce ad un articolo
| | Se tutto ha funzionato abbiamo un fantastico cubo 3D con il quale stupire noi stessi e gli amici!!! |
|
| |
|
| Autore: The_Noise
| | ---- |
| Verificato da Keltik
| |
| Esteso da Hanska
| |
| Verificato da MaXeR
| |
| | |
| Con questi piccoli accorgimenti che richiedono un piccolo aiuto da parte della community, speriamo di poter tracciare e mantere lo "stato di salute" delle guide, sperando che un numero sempre maggiore di esse diventi Debianized ;-).
| |
| Ripristinare versioni precedenti di una pagina
| |
|
| |
|
| Il wiki tiene traccia completa della storia di tutte le modifiche effettuate su ogni pagina. � possibile accedere allo storico delle modifiche cliccando sul link revisioni in alto. Dalle revisioni di una pagina � possibile ripristinare una qualsiasi versione precedente se il suo contenuto � stato danneggiato o cancellato. Ecco perch� � importante loggarsi sempre e scrivere un chiaro sommario per ogni modifica.
| | Autore : [[Utente:Pliniux|Pliniux]] |
| Monitorare una pagina
| |
|
| |
|
| Se hai scritto una guida probabilmente vorrai controllare anche le modifiche successive che vengono fatte da altri. Questo � molto facile, basta premere su link watch in alto in ogni pagina e quella pagina verr� aggiunta alla tua lista di Osservati Speciali (anche questo link � in alto).
| | ===Materiale consultato=== |
| Discussioni
| |
|
| |
|
| Ad ogni pagina del wiki � associata una pagina di discussione nella quale si pu� parlare di come estendere o modificare un particolare articolo. Per accedere alla pagina delle discussioni basta cliccare su link discussion, in alto. Nella pagina di discussione devono essere discussi e risolti eventuali disaccordi su come modificare una pagina.
| | http://aldolat.wordpress.com/2006/11/01/driver-ati-xgl-beryl-su-ubuntu-edgy/ |
|
| |
|
| La pagina di discussione � anche un utile strumento per chiedere chiarimenti o estensioni su un articolo, ed in genere per parlare di tutto ci� che riguarda una particolare pagina.
| | http://www.debianitalia.org/modules/wfsection/article.php?articleid=139 |
| Pagine protette
| |
|
| |
|
| Alcune pagine del wiki sono protette, cio� un normale utente non pu� modificarle anche se registrato. Le pagine protette sono pagine di presentazione del progetto, pagine di licenza, o pagine tecniche del wiki (come ad es. i template). In nessun caso un articolo di documentazione riguardate Debian GNU/Linux verr� resa protetta. Se trovate una pagina di documentazione protetta, per favore, segnalatelo agli amministratori.
| | http://wiki.beryl-project.org/index.php/Install/Ubuntu/Edgy/XGL |
| Licenze
| |
|
| |
|
| Ogni articolo pubblicato � da considerarsi rilasciato secondo una licenza Creative Commons. Ti preghiamo di non inserire nel wiki contenuti coperti da diritti d'autore. Qualora si scoprano violazioni di copyright gli articoli interessati verranno rimossi.
| | http://www.debianizzati.org/component/option,com_joomlaboard/Itemid,29/func,view/id,23011/catid,18/limit,6/limitstart,0/ |
|
| |
|
| Alcuni articoli saranno firmati da Utente:Guide @ Debianizzati.org. Questi l'articoli possono nascere da una discussione sul forum, in chat o in genere dallo sforzo collaborativo di pi� persone della community.
| | [[Categoria:Desktop]] |