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