Skip to content

haszi/doc-uk

 
 

Repository files navigation

Переклад документації

Для коректної роботи з перекладом необхідно докладно ознайомитися з Керівництвом з розробки посібника з PHP.

Загальні тези

  • Система контролю версій — Git, платформа — GitHub. Відповідно, щоб новачку якнайшвидше додати чи оновити файли, потрібно просто надіслати pull request. Після певної кількості підтверджених pull request-ів перекладач отримує право на редагування сховища. Для цього він має попросити про це команду документування.
  • Документація ведеться в науковому стилі, файли документації написані мовою розмітки XML за певними правилами форматування.

Додаткова інформація

Коли перекладач обрав файл, який необхідно перекласти, то на додаток до всіх приготувань, він змінює його статус на wip в тегові EN-Revision,

<!-- EN-Revision: XXXXX Maintainer: YYYYY Status: wip -->

вивантажує цей файл в сховище і вже потім починає перекладати. WIP означає "Work in progress", тобто файл взятий в роботу. Це робиться для того, щоб уникнути випадків, коли кілька перекладачів працюють над однаковим текстом.

Файл має містити тег Reviewed:

<!-- EN-Revision: XXXXX Maintainer: YYYYY Status: ready -->
<!-- Reviewed: no -->

Значення no ставлять, коли файл щойно перекладено. Значення yes ставить інший перекладач після вичитки. Вичитку здійснює перекладач, що має право на редагування сховища.

Коментарі в блоках коду необхідно перекладати.

Словник термінів

Important

Словник є неповним і недосконалим, тож вітається обговорення наявних та нових термінів. Українські відповідники, що вже викладені тут, є обов'язковими до застосування з метою спільного трактування.

Англійською Українською
argument параметр
backslash обернена коса риска
bootstrap file файл ініціалізації
bug вада
build збірка, збирати
callable назва виклику
conversion (про тип) перетворення
cookies куки
default стандартний, початковий
debugger зневаджувач/налагоджувач
directory директорія
engine рушій
FAQ ЧаПи (увага на регістри букв)
float десятковий дріб/число з рухомою крапкою
folder тека/каталог/папка
handl(-e, -er) дескриптор, обробник
hash геш
implement (про клас) реалізовувати
instance (про клас) примірник
(неіст.) name назва
named названий
to sort впорядковувати
source code початковий код
rollback відкочува(-ння/ти)
runtime середовище виконання/час виконання
whitespace пропуск

Обговорення можна проводити як тут, так і в списку розсилки [email protected]

About

Ukrainian translation of the PHP documentation

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • XML 98.8%
  • Ant Build System 1.2%