Для начала, вам необходимо ознакомиться с такими технологиями, как:
А так же иметь аккаунт на GitHub.
Prose.io
Проект Prose.io предлагает Web-интерфейс для совместной работы над блогом. Для этого вам необходимо:
- Авторизироваться в сервисе с помощью вашего аккаунта на GitHub
- Открыть проект блога [Bashka.github.io][http://prose.io/#Bashka/bashka.github.io]
- Открыть интересующий вас файл статьи или создать собственный, согласно правилам, которые описанным ниже
- Сохранить изменения и ввести их описание для формирования Pull request
- Дождаться модерации ваших изменений
Редактирование и исправление ошибок
Если вы хотите исправить или дополнить статью, откройте ее в редакторе Prose.io и внесите изменения. После сохранения, редактор предложит вам указать комментарий, описывающий ваши правки. Обязательно указывайте в комментарии цель ваших правок.
Предложения по улучшению блога могут быть даны в GitHub Issues.
Написание собственных статей
Если вы хотите написать свою статью в блог, используйте черновики. Создайте в этом каталоге новый файл и творите! После того, как статья будет написана, откройте редактор метаданных (Meta Data) и внесите в него следующие данные:
Как и при редактировании, сохраните статью и укажите комментарий.
Правила оформления статьи
- Соблюдайте грамматику. По возможности проверяйте ваши правки на грамматические ошибки с помощью специальных инструментов
- Делите статью на семантические блоги с помощью абзацев и разделов (заголовков)
- Используйте блок
highlight
для подсветки синтаксиса. Пример использования этого блока вы можете найти в этой статье
Данные правила могут быть дополнены в будущем. Ознакомьтесь с ними перед внесением правок в блог.