Це - україномовна документація мови програмування PHP із доповненнями й прикладами щодо найкращіх практик програмування. Зважаючи на те, що офіційна документація інколи не повна, часом не актуальна і наразі немає української версії, було прийнято рішення створити цей проєкт. Веб-версія сайту доступна за адресою https://php.org.ua.
PHP (англ. PHP: Hypertext Preprocessor — PHP: гіпертекстовий препроцесор) — скриптова мова програмування, була створена для генерації HTML-сторінок на стороні вебсервера. PHP є однією з найпоширеніших мов, що використовуються у сфері веброзробок. PHP проєкт відкритого програмного забезпечення i підтримується переважною більшістю хостинг-провайдерів.
Файли документаціі зберігаються у вигляді md файлів у форматі Markdown із доповненням Frontmatter за адресою https://github.com/ukrainesoft/php.org.ua-docs
git clone https://github.com/ukrainesoft/php.org.ua
cd php.org.ua
git submodule init
git submodule update
cd frontend
yarn dev # or `npm run dev`
Веб-сервер буде доступний за адресою http://localhost:3000/
На даний час більшість файлів парекладено автоматично.
- Обрати один з перекладів у форматі "Many HTML files" з офиційного сайту документації
- Перекласти за допомогою онлайн сервісу перекладу
- Внести додаткові зміни
- 👌 Перевести документацію із формату xml до md (це допоможе упростити подальший переклад).
- 👌 Перекласти усі сторінки документації на українську мову за допомогою машинного перекладу.
- 👌 Пофіксити markdown таблиць markdown-table-formatter буде доречним.
- 👌 Підготувати домен для хостінгу GitHub Pages.
- 👌 Розробити фронтенд (Jekyll / VueJS / ReactJS). Вибір пав на Next.js
- 👌 Розділити фронтенд від мануалу на рівні репозиторія.
- 👌 Додати можливість запускати приклади PHP коду клієнтом.
- Оновити розділи із листінгом скриптів (php-cs-fixer настане у пригоді).
- Оновити приклади документації для нових версій PHP.
- Додати новини PHP.
- Оновити документацію, зробити її більш натуральною.
- Розробити та впровадити курс PHP, який можна буде пройти на сайті