Добавление контента
Этот ресурс - это достояние сообщества. Сообщество управляет ресурсом, наполняет его контентом и помогает его развивать. Администраторы - это активные участники сообщества, которые помогают участникам создавать контент.
Поскольку этот ресурс общественный - напонять его может каждый участник. На этой странице расскажем как это сделать :)
Организация ресурса
Весь ресурс - это статический контент, который генерируется на основании содержимого репозитория. То есть, все содержимое данного ресурса есть в репозитории, в открытом доступе. Использование публичного репозитория - это еще один элемент для развития сообщества, вы можете учиться на этом ресурсе :)
Для генерации статического контента используется генератор Hugo. Hugo выполняет главную фукнкцию - преобразовывает контент репозитория, пропускает его через шаблонизаторы и на выходе получается статический веб-сайт.
Весь контент представлен в виде MarkDown-файлов. Это очень простой текстовый формат, с очень простыми правилами оформления.
Почему выбран репозиторий для хранения?
Нам важно, чтобы вся наша работа была открытой. Чтобы участники сообщества видели, как формируется сообщество, чтобы не испытывали преград для того, чтобы делиться знаниями. Для такого открытости - нужны соответствующие платформы, поэтому мы обратились к практике open-source решений:
- Весь контент публичен
- Авторы контента и правок - известны
- История изменений - доступна
- Обсуждения - открыты
- Доступность изменений - полная
Что нужно знать, чтобы настроить среду разработки у себя?
Обязательно - нужно быть знакомым с тем, как устроен git (распределенная система версионирования кода). Если вы из IT - вы наверняка знакомы с этим решением :)
Нужно установить себе локально Hugo. Обратите на версию, которую мы используем.
Отлично, если вы ознакомитесь с тем, как устроено управление контентом у Hugo.
Вам нужно будет знать, как писать статьи в стиле Markdown.
Любой удобный текстовый редактор :)
Если в чем-то не разбираетесь, спросите в нашем чате - найдутся неравнодушные участники, которые помогут :)
Если я нашел ошибку или добавляю страницу
Вносите изменения в ресурс (добавляйте контент, исправляйте ошибки). Отправляйте изменения (git push
) в репозиторий. Делайте Merge Request из вашей ветки в master и ждите Approve. Администраторы придут, внесут необходимые уточнения, если вы не сделали и подскажут. Например, можно исправить эту страницу :)
Мне не нравится дизайн!!
Мы рады приветствовать, если будут участники сообщества, которые внесут свой вклад в развитие сообщества - делайте Merge Request с вашими предложениями :)