Данный репозиторий - исходный код сайта ЦГ Коммьюнити Хаба
Задача сайта - хранить полезную информацию:
- линки на хорошие:
- статьи
- туторы
- чаты, форумы, коммьюнити.
- выдержки
- ответы на часто задаваемые вопрос
Чем этот сайт НЕ является:
- источником актуальных новостей
- площадкой для рекламы
- площадкой для какой-либо торговли
Этот портал развивается с помощью коммьюнити. Вы можете предлагать изменения любых элементов и контента этого сайта через:
- через форк репозитория сайта и последующий pull request с изменениями
- issues на гитхабе тут
Карточки коммьюнити строятся автоматически из конфигурации в _data/home.yml
Чтобы добавить новую карточку - просто добавьте новый элемент в список project_entries
title
- имя карточки (отображается сверху, вместе с иконкой).icon
(опционально) - иконка карточки. Хоть это поле и опционально - рекоммендуется всегда добавлять иконку. Иконки чатов должны храниться в/assets/images/icons/
и быть не шибко большимиpng
файлами.url
- линк на собственно коммьюнити.desc
- описание коммьюнити, что отображается в теле карточки. поддерживается markdown формат.tags
- список тэгов, отображающихся внизу карточки.
Полезные ресурсы живут в отдельных страницах, их список определяется конфигурацией в _data/home.yml
Список материалов на главной странице определяется списком resources_entries
в _data/home.yml
Каждый элемент может содержать
title
- собственно текст элементаicon
(опционально) - маленькая иконка слева от текста (иконки должны храниться в/assets/images/icons/
)url
(опционально) - линк на пост.entries
(опционально) - список вложенных элементов. См пример как отображается как пункт Houdini. Может иметь несколько уровней вложенности.
Старайтесь следовать уже существующим структурам и решениям. Если же вы предлагаете реорганизовать страницы лучше - пожалуйста заодно реорганизуйте и существующие материалы, чтобы всё выглядело более-менее единобразно, и добавьте информацию сюда.
- Посты по каждому софту или теме должны храниться в отдельной папке, посвященной этому софту или теме.
Например, списки инструментов и туторов по гудини хранятся в/houdini/tutorials
и/houdini/tools
- Собирательные посты (как faq) удобно строить из коллекций, где каждый подэлемент хранится в отдельном файле.
Смотри пример/houdini/faq
, использующий коллекциюhoudini_faq
, определенную в спискеcollections
в_config.yml
.
Дополнительную информацию по коллекциям в Jekyll см в документации
Тема и прототип сайта был взят из этого комита темы moonwalk, спасибо автору abhinavs