Для начала, вам необходимо ознакомиться с такими технологиями, как:

  • Markdown - формат разметки
  • YAML - формат описания метаданных

А так же иметь аккаунт на GitHub.

Prose.io

Проект Prose.io предлагает Web-интерфейс для совместной работы над блогом. Для этого вам необходимо:

  1. Авторизироваться в сервисе с помощью вашего аккаунта на GitHub
  2. Открыть проект блога [Bashka.github.io][http://prose.io/#Bashka/bashka.github.io]
  3. Открыть интересующий вас файл статьи или создать собственный, согласно правилам, которые описанным ниже
  4. Сохранить изменения и ввести их описание для формирования Pull request
  5. Дождаться модерации ваших изменений

Редактирование и исправление ошибок

Если вы хотите исправить или дополнить статью, откройте ее в редакторе Prose.io и внесите изменения. После сохранения, редактор предложит вам указать комментарий, описывающий ваши правки. Обязательно указывайте в комментарии цель ваших правок.

Предложения по улучшению блога могут быть даны в GitHub Issues.

Написание собственных статей

Если вы хотите написать свою статью в блог, используйте черновики. Создайте в этом каталоге новый файл и творите! После того, как статья будет написана, откройте редактор метаданных (Meta Data) и внесите в него следующие данные:

title: "Название статьи"
author: "Ваше имя"
description: "Описание статьи"
categories: "категория статьи"
tags: ["теги", "статьи"]
comments: true

Как и при редактировании, сохраните статью и укажите комментарий.

Правила оформления статьи

  1. Соблюдайте грамматику. По возможности проверяйте ваши правки на грамматические ошибки с помощью специальных инструментов
  2. Делите статью на семантические блоги с помощью абзацев и разделов (заголовков)
  3. Используйте блок highlight для подсветки синтаксиса. Пример использования этого блока вы можете найти в этой статье

Данные правила могут быть дополнены в будущем. Ознакомьтесь с ними перед внесением правок в блог.