|
|
| Linia 95: |
Linia 95: |
| == Convenții de codare == | | == Convenții de codare == |
|
| |
|
| * Asigurați-vă că sistemul dumneavoastră permite citirea și tastarea diacriticelor românești ĂÂÎȘȚ. În particular, asigurați-vă că puteți folosi diacriticele Ș și Ț cu virgulă (nu Ş și Ţ cu sedilă). Editorul dumneavoastră trebuie să poată deschide și salva fișiere fără a corupe semnele diacritice din ele. Orice sistem GNU/Linux modern se descurcă perfect cu aceste simboluri. Sub Gnome, singura operație necesară este adăugarea unei mapări românești de tastatură ''(System / Preferences / Keyboard / Layouts / Add / Country:Romania).'' Cătălin folosește varianta simplă (Romania), care practic lasă tastatura originală nemodificată și adaugă diacriticele românești folosind talta AltGr (Alt din dreapta).
| | Folosim [https://google.github.io/styleguide/javaguide.html stilul Google pentru Java]. În principiu, dacă urmați stilul existent în cod, va fi cum trebuie. |
| * Fișierele sunt scrise cu indentare de două spații, fără taburi. Aceasta este doar o convenție. Dacă preferați un alt stil, putem să îl adoptăm, dar trebuie să scrieți un script care să modifice toată baza de cod. Dacă ne oferiți și un fișier .emacs care să formateze codul în stilul dumneavoastră, este și mai bine. :-)
| |
| * Majoritatea identificatorilor sunt „camelCased”, fără underscores: <tt>$numeVariabilă</tt>, <tt>NumeClasă</tt>, <tt>$this->numeCâmp</tt>.
| |
| * Constantele sunt scrise cu litere mari și cu underscore: <tt>NUME_CONSTANTĂ</tt>.
| |
| * Lățimea ecranului nu este bătută în cuie; credem că până la 160 de caractere nu se va supăra nimeni.
| |
| * Pentru cuvintele-cheie (<tt>for, foreach, if, while, case</tt> etc.) se lasă spațiu în afara parantezelor, nu și înăuntrul lor.
| |
| * Pentru apeluri de funcții, nu se lasă loc între numele funcției și paranteza deschisă.
| |
| * Se lasă spațiu în afara acoladelor.
| |
| * Se lasă spațiu după virgule.
| |
| * Orice acoladă deschisă stă pe aceeași linie cu instrucțiunea if / else etc. precedentă și este urmată de o linie nouă.
| |
| * Orice acoladă închisă este singură pe linia ei.
| |
| * Folosim acolade și dacă blocul if / else / while etc. constă dintr-o singură instrucțiune.
| |
|
| |
|
| <syntaxhighlight lang="php">
| | În plus, referitor la limba română, veți avea nevoie să: |
| if (($y > 3) && ($y < 10)) {
| | |
| while ($z < 10) {
| | * vedeți corect diacriticele ĂÂÎȘȚ și alte câteva simboluri Unicode; |
| $z++;
| | * tastați corect diacriticele românești; în particular, Ș și Ț cu virgulă, nu Ş și Ţ cu sedilă; |
| callMyFunction($y, $z);
| | * folosiți diacritice în orice mesaje către utilizator. |
| }
| |
| }
| |
| </syntaxhighlight>
| |
|
| |
|
| == Configurări opționale == | | == Configurări opționale == |