PHP/Inne/Dla twórców podręcznika: Różnice pomiędzy wersjami
Usunięta treść Dodana treść
Zdzichobot (dyskusja | edycje) zamiana prognav->subst:naw |
m aktualizacja wytycznych |
||
Linia 5:
=== Oprogramowanie ===
Wszystkie informacje powinny być w miarę aktualne i dotyczyć przynajmniej PHP 5.
Jeżeli chcesz opisać jakąś bibliotekę, zgłoś to w dyskusji i zaproponuj spis treści. Wykaz propozycji można znaleźć na podstronie [[PHP/Inne/Do zrobienia|Do zrobienia]].
Linia 28:
Przykładowe kody źródłowe muszą być napisane czytelnie, w oparciu o identyczne formatowanie.
#Nawiasy klamrowe otwieramy w nowej linijce
#Wcięcia trójznakowe
Linia 33 ⟶ 34:
#Poszczególne części algorytmu staramy się separować linijką przerwy
#Kod musi być skomentowany, najlepiej komentarzami jednolinijkowymi
#Na końcu skryptu '''nie wstawiamy''' znaku <code><nowiki>?></nowiki></code>
W kodach źródłowych staramy się unikać nieprawidłowych nawyków:
Linia 40 ⟶ 42:
#Nie stosujemy elementów składni typowych dla PHP 4 (np. ''var''), chyba że w opisach objaśniających różnice między wersjami.
#Konstrukcje używane niezgodnie z przeznaczeniem powinny być omijane. Zaliczają się do nich m.in. ''funkcja("$zmienna");''
Kod musi być zawarty w znacznikach <code><nowiki><source lang="php"> ... </source></nowiki></code>, np.
<source lang="php"><?php
echo 'Hello world';
</source>
{{Uwaga|Większość rozdziałów została napisana jeszcze przed wprowadzeniem znacznika SOURCE do oprogramowania MediaWiki, dlatego korzystają ze starszego stylu. Jeśli możesz, zaktualizuj formatowanie.}}
=== Neutralny punkt widzenia ===
| |||