Як почати брати участь в Open Source
Якийсь час назад я вважав, що поріг входження в OpenSource-розробку дуже високий - адже треба використовувати git, відправляти пулл-реквести. Це було чимось незнайомим, далеким і зупиняло мене. Тим більше, що весь github.com англійською і багато слів і, відповідно, функції незрозумілі.
Однак зараз я розумію, як помилявся. Сподіваюся, що після цієї статті ви погодитеся зі мною і почнете вносити свій внесок до спільноти Open Source (і співтовариство MODX зокрема). Пропоную на прикладі розібрати, як допомогти розробникам радувати нас доповненнями і уроками.
Я давно вже бачив одне доповнення - modxSDK. але користуватися ним став недавно. Помітив, що не всі фрази і кнопки переведені. Мені особливо не заважає, а новим користувачам може бути незручно. Давайте, почнемо наш внесок з малого - просто переведемо поля і кнопки.
В першу чергу, заходимо на сторінку потрібного нам сховища та натискаємо кнопку Fork. Тепер у вас є своя версія цього доповнення)
Тепер нам потрібно вихідний код доповнення вивантажити на сайт, щоб ми могли його змінювати і тут же перевіряти. Відкриваємо термінал (підключаємося до нашого сервера по SSH) і переходимо в папку сайту:
І в цій папці виконуємо наступну команду:
(Замість ilyautkin пишемо свій логін, а замість modxSDK - назва сховища)
Після цього побіжать циферки, що вказують на прогрес «скачування» вихідного коду в вашу папку. Коли все скочується, можна відкрити админку нашого сайту і побачити в файлової системі нову директорію. У мене це modxSDK.
Найчастіше пакет генерується вже відразу в папку / core / packages /. так що йдемо в Управління пакетами → Шукати локально і встановлюємо додаток. Деякі розробники налаштовують автоматичну установку пакета після генерації. В такому випадку встановлювати вже нічого не треба буде)
Все, підготовка закінчена. Тепер ми можемо змінювати код, відкривати в браузері файл build.transport.php. перевстановлювати пакет і перевіряти, що ми все поміняли правильно. Для перекладу ми йдемо в папку / core / components / modxsdk / lexicon / і вносимо зміни в файл /core/components/modxsdk/lexicon/ru/default.inc.php
Не бійтеся вносити зміни в кілька файлів - потім ми разом відправимо всі файли.
Виправте версію доповнення в файлі /_build/build.transport.php і напишіть changelog в файл /core/components/modxsdk/docs/changelog.txt
Тут в першому рядку потрібно коротко описати, що за зміни ви внесли. Бажано, англійською. 5-7 слів)
Локально збереглися. Тепер відправимо всі зміни на github.com:
Не забуваємо міняти логін на свій і вказувати потрібний репозиторій.
Ось пулл-реквест. в якому можна побачити змінені файли. У вас скоро буде схожий, та не один))