3.4 KiB
Come posso collaborare a questo libro?
Grazie per voler collaborare! Ci sono vari modi per poterlo fare:
- Tradurre i contenuti
- Migliorare la sezione
glossario/
- Modificare i contenuti
- Condividere i vostri esempi di shaders attraversol'editor on-line
Tradurre i contenuti
Questo libro è scritto nel linguaggio Markdown quindi è molto facile da modificare e lavorare su di esso.
-
Iniziate andando alla repository di GitHub
github.com/patriciogonzalezvivo/thebookofshaders
. Date un'occhiata ai file e alle cartelle al suo interno. Si noti che il contenuto è presente nei fileREADME.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. -
Biforcare ("Fork") la repository e clonatela ("Clone") sul vostro computer.
-
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.
-
Traducete linea per linea i contenuti (vedi Note di traduzione).
-
Testate le pagine tradotte (vedi Test).
-
Inviate ("Push") i vostri commit alla biforcazione ("Fork") della vostra repository su GitHub, per poi fare un Pull Request
Note di traduzione
Non cancellate o modificate gli esempi integrati alla pagina, che assomigliano a questo codice:
<div class="codeAndCanvas" data="grid-making.frag"></div>
oppure
<div class="simpleFunction" data="y = mod(x,2.0);"></div>
Testare
Iniziate l'esecuzione di un server locale PHP all'interno della cartella locale:
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 file03/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.
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 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 o a @kyndinfo. Non vediamo l'ora di vederlo e aggiungerlo alla sezione galleria di esempi.