Italian appendix
riibiax
8 years ago
parent
e49c03863a
commit
4362f2586f
@ -0,0 +1,33 @@
|
||||
## Come posso consultare questo libro offline?
|
||||
|
||||
Diciamo che si dispone di un lungo viaggio e si desidera usarlo per imparare da soli alcuni shaders. In questo caso è possibile effettuare una copia locale di questo libro sul computer ed eseguire un server locale.
|
||||
|
||||
Per questo è necessario solo Python 2.6 e un client git. Sui computer MacOS e Raspberry Pi, Python è installato di default, ma è comunque necessario installare un client git. Per fare ciò:
|
||||
|
||||
Su **MacOSX** siate sicuri di avere installato [homebrew](http://brew.sh/) e quindi sul terminale fate:
|
||||
|
||||
```bash
|
||||
brew update
|
||||
brew upgrade
|
||||
brew install git
|
||||
```
|
||||
|
||||
Su **RaspberryPi** è necessario fare:
|
||||
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get upgrade
|
||||
sudo apt-get install git-core
|
||||
```
|
||||
|
||||
Una volta che avete installato tutto, non vi resta che fare:
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
git clone --recursive https://github.com/patriciogonzalezvivo/thebookofshaders.git
|
||||
cd thebookofshaders
|
||||
git submodule foreach git pull
|
||||
php -S localhost:8000
|
||||
```
|
||||
|
||||
Quindi aprite il browser e inserite [```http://localhost:8000/```](http://localhost:8000/)
|
||||
@ -0,0 +1,23 @@
|
||||
## Come posso eseguire gli esempi su un Raspberry Pi?
|
||||
|
||||
Alcuni anni fa, non era del tutto ovvio che tutti disponessero di un computer con una GPU. Ora, nonostante la maggior parte dei computer abbia una carta grafica, non tutti i corsi o classi possono permettersene uno.
|
||||
|
||||
Grazie al [progetto Raspberry Pi](http://www.raspberrypi.org/) una nuova generazione di computer piccoli ed economici (circa 35euro ciascuno) ha cominciato a diffondersi nelle aule scolastiche. Ancora più importante ai fini di questo libro, il [Raspberry Pi](http://www.raspberrypi.org/) viene fornito con una scheda GPU Bradcom decente a cui si può accedere direttamente dalla console. Ho creato uno [strumento flessibile per programmare GLSL live chiamato **glslViewer**](https://github.com/patriciogonzalezvivo/glslViewer) capace di far funzionare tutti gli esempi di questo libro. Questo programma è anche capace di aggiornare automaticamente le modifiche che l'utente fa quando le salva. Cosa significa? è possibile modificare lo shader e ogni volta che lo si salva, lo shader sarà ricompilato e visualizzato per voi.
|
||||
|
||||
Facendo una copia locale del repository di questo libro (vedi paragrafo precedente) e con [```glslViewer``` installato](https://github.com/patriciogonzalezvivo/glslViewer), gli utenti possono eseguire gli esempi con ```glslviewer```. Inoltre usando il flag ```-l``` si può visualiizare l'esempio in un angolo dello schermo mentre lo si modifica con un qualsiasi editor di testo (come ```nano```, ```pico```, ```vi```, ```vim``` or ```emacs```). Questo funziona anche quando l'utente è collegato tramite ssh/sftp.
|
||||
|
||||
Per installare e configurare tutto ciò sul Raspberry Pi, dopo l'installazione del sistema operativo e il login, digitate i seguenti comandi:
|
||||
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get upgrade
|
||||
sudo apt-get install git-core
|
||||
cd ~
|
||||
git clone http://github.com/patriciogonzalezvivo/glslViewer.git
|
||||
cd glslViewer
|
||||
make
|
||||
make install
|
||||
cd ~
|
||||
git clone https://github.com/patriciogonzalezvivo/thebookofshaders.git
|
||||
cd thebookofshaders
|
||||
```
|
||||
@ -0,0 +1,66 @@
|
||||
## Come posso stampare questo libro?
|
||||
|
||||
Diciamo che non si vuole navigare o interagire con gli esempi e si desidera solo un buon vecchio libro di testo che si può leggere sulla spiaggia o sul vostro tragitto verso la città. In questo caso è possibile stampare questo libro.
|
||||
|
||||
#### Installare glslViewer
|
||||
|
||||
Per la stampa di questo libro è necessario in primo luogo trasformarlo. Per questo è necessario [```glslViewer```](https://github.com/patriciogonzalezvivo/glslViewer) uno strumento console per gli shader che compilerà e trasformare gli esempi in immagini.
|
||||
|
||||
Su **MacOSX** siate sicuri di avere installato [homebrew](http://brew.sh/) e quindi sul terminale digitate:
|
||||
|
||||
```bash
|
||||
brew update
|
||||
brew upgrade
|
||||
brew tap homebrew/versions
|
||||
brew install glfw3
|
||||
cd ~
|
||||
git clone http://github.com/patriciogonzalezvivo/glslViewer.git
|
||||
cd glslViewer
|
||||
make
|
||||
make install
|
||||
```
|
||||
|
||||
Su **RaspberryPi** è necessario fare:
|
||||
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get upgrade
|
||||
sudo apt-get install git-core
|
||||
cd ~
|
||||
git clone http://github.com/patriciogonzalezvivo/glslViewer.git
|
||||
cd glslViewer
|
||||
make
|
||||
make install
|
||||
```
|
||||
|
||||
#### Installare Latex Engine e Pandoc
|
||||
|
||||
Per trasformare i capitoli Markdown in Latex e poi in un file PDF useremo Xetex Latex Engine e Pandoc.
|
||||
|
||||
Su **MacOSX**:
|
||||
|
||||
Scarica e Installa [basictex & MacTeX-Additions](http://www.tug.org/mactex/morepackages.html) e poi installa [Pandoc](http://johnmacfarlane.net/pandoc/) facendo:
|
||||
|
||||
```bash
|
||||
brew install pandoc
|
||||
```
|
||||
|
||||
Su **RaspberryPi**:
|
||||
|
||||
```bash
|
||||
sudo apt-get install texlive-xetex pandoc
|
||||
```
|
||||
|
||||
#### Trasforma il libro in un pdf e stampalo
|
||||
|
||||
Ora che avete tutto ciò che serve, è il momento di clonare la [repository di questo libro](https://github.com/patriciogonzalezvivo/thebookofshaders) e compilare il libro.
|
||||
|
||||
A tale scopo aprite il terminale e digitate:
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
git clone https://github.com/patriciogonzalezvivo/thebookofshaders.git
|
||||
cd thebookofshaders
|
||||
make
|
||||
```
|
||||
Se tutto va bene, si vedrà un file ```book.pdf``` che potete leggere sul vostro dispositivo preferito o stampare.
|
||||
@ -0,0 +1,63 @@
|
||||
## Come posso collaborare a questo libro?
|
||||
|
||||
Grazie per voler collaborare! Ci sono vari modi per poterlo fare:
|
||||
|
||||
- Tradurre i contenuti
|
||||
- Migliorare la [sezione ```glossario/```](https://github.com/patriciogonzalezvivo/thebookofshaders/tree/master/glossary)
|
||||
- Modificare i contenuti
|
||||
- Condividere i vostri esempi di shaders attraverso[l'editor on-line](http://editor.thebookofshaders.com/)
|
||||
|
||||
### Tradurre i contenuti
|
||||
|
||||
Questo libro è scritto nel [linguaggio Markdown](https://daringfireball.net/projects/markdown/syntax) quindi è molto facile da modificare e lavorare su di esso.
|
||||
|
||||
1. Iniziate andando alla [repository di GitHub ```github.com/patriciogonzalezvivo/thebookofshaders```](https://github.com/patriciogonzalezvivo/thebookofshaders). Date un'occhiata ai file e alle cartelle al suo interno. Si noti che il contenuto è presente nei file ```README.md``` e negli altri con lettere maiuscole come:```TITLE.md```, ```SUMMARY.md```, ecc. Si noti inoltre che le traduzioni sono contenute in file che terminano con due lettere che fanno riferimento alla lingua che sono tradotte, es .: ```README-jp.md```, ```README-es.md```, ecc.
|
||||
|
||||
2. Biforcare ("Fork") la repository e clonatela ("Clone") sul vostro computer.
|
||||
|
||||
3. Duplicate il contenuto dei file da tradurre. Ricordatevi di aggiungere ai file su cui si sta lavorando le due lettere che fanno riferimento alla lingua che si sta traducendo.
|
||||
|
||||
4. Traducete linea per linea i contenuti (vedi **Note di traduzione**).
|
||||
|
||||
5. Testate le pagine tradotte (vedi **Test**).
|
||||
|
||||
6. Inviate ("Push") i vostri commit alla biforcazione ("Fork") della vostra repository su GitHub, per poi fare un [Pull Request](https://help.github.com/articles/about-pull-requests/)
|
||||
|
||||
#### Note di traduzione
|
||||
|
||||
Non cancellate o modificate gli esempi integrati alla pagina, che assomigliano a questo codice:
|
||||
|
||||
```html
|
||||
<div class="codeAndCanvas" data="grid-making.frag"></div>
|
||||
```
|
||||
|
||||
oppure
|
||||
|
||||
```html
|
||||
<div class="simpleFunction" data="y = mod(x,2.0);"></div>
|
||||
```
|
||||
|
||||
#### Testare
|
||||
|
||||
Iniziate l'esecuzione di un server locale PHP all'interno della cartella locale:
|
||||
|
||||
```bash
|
||||
php -S localhost:8000
|
||||
```
|
||||
|
||||
Poi, nel tuo browser aprite la pagina ```localhost:8000```, andate al capitolo che state traducendo e aggiungete ```?lan=``` seguito dal codice della lingua in cui state traducendo.
|
||||
|
||||
Per esempio se si sta traducendo il capitolo ```03``` in francese, starete lavorando sul file```03/README-fr.md``` e lo si può testare andando alla pagina: ```http://localhost:8000/03/?lan=fr```
|
||||
|
||||
### Migliorare la sezione glossario
|
||||
|
||||
Questa sezione è in fase di sviluppo. Siamo lieti di ascoltare le vostre idee su come rendere uno strumento intuitivo per tutti. Inviaci un messaggio a [@bookofshaders](https://twitter.com/bookofshaders).
|
||||
|
||||
### Modifica il contenuto
|
||||
|
||||
Siamo tutti esseri umani. Se vedete qualcosa, ditelo e fate un Pull Request oppure aprite un problema su GitHub. Grazie!
|
||||
|
||||
### Condividete i vostri esempi di shaders
|
||||
|
||||
Vedrete un sacco di link verso [l'editor on-line](http://editor.thebookofshaders.com/) e verso delle sue istanze integrate alla pagina.
|
||||
Una volta che si scrive un codice che vi rende orgoglioso, fate clic su "Esporta" (o sull' icona ```⇪```) e quindi copiate l' "URL verso il codice..." ("URL to code..."). Inviatelo a [@bookofshaders](https://twitter.com/bookofshaders) o a [@kyndinfo](https://twitter.com/kyndinfo). Non vediamo l'ora di vederlo e aggiungerlo alla [sezione galleria di esempi](https://thebookofshaders.com/examples/).
|
||||
Loading…
Reference in New Issue