Репозиторий содержит исходный код для официального сайта Samara IT Community. Если вы заметили ошибку или неточность, можете создать issue или прислать pull request.
Дорогой друг - если ты решил помочь проекту и поработать над сайтом, то для начала стоит настроить окружение. SITC.community является статическим сайтом, для генерации используется Gutenberg SSG. Почему именно этот генератор статических сайтов? -Потому что у @humb1t Rust головного мозга- Потому что так надо.
- Для установки Гутенберга потребуется: скачать бинарник или воспользоваться пакетным менеджером тут всё написано.
- Далее качай наш репозиторий к себе на машину: git clone https://github.com/SamaraITCommunity/site.git
- Ну и проверь что всё работает: gutenberg build
Чтобы лучше понять структуру нашего проекта - прочитай немного документации по Gutenberg структуре директорий. Затем походи по разделам - что это за файлики типа md? Не надо стесняться - иди с markdown ознакомляться. Все наши странички пишутся не на html, а на markdown - это нужно, чтобы не загромождать содержательную часть структурными элементами, не рассориться из-за стиля написания и дать возможность contribute всем участникам сообщества (даже -глупым- не знающим разметки бэкендщикам) ;-) Окей - как всё это работает? Для начала небольшая магия - наш проект использует готовую тему Hyde и чтобы собрать проект требуется:
- перейти в папку themes (например cd themes)
- сделать git clone https://github.com/Keats/hyde.git
- вернуть в корневую директорию (cd ../)
Запускаем команду gutenberg serve и идём в браузер по адресу 127.0.0.1:1111 - вуаля, сайт должен быть тут. Если что-то пошло не так - обращайся в наш ламповый телеграм чатик - там -тебя вылечат- тебе помогут.
Всю работу веди в отдельной веточке с говорящим названием - например new-grindconf-info или grammatic-fixes, старайся делать законченные, но небольшие изменения, которые логически связанны между собой в отдельных ветках. После того как ты сделаешь изменения - пожалуйста запусти gutenberg build и проверь что все они собираются, а ещё лучше запусть gutenberg serve и посмотри что результат тот, который ты ожидал увидеть. Только после этого ты можешь сделать git push своих изменений в наш репозиторий и после этого создать pull request - и жди слова благодарности от менйтейнеров проекта.
Ничего сложного тут нет, просто стоит попробовать и привыкнуть - trust me, I'm engineer.