Git Blog

Что такое Git Blog?

Git Blog — мобильное Markdown-приложение для iPhone и iPad, которое позволяет создавать черновики, редактировать и публиковать посты блога прямо в ваш репозиторий GitHub. Оно предназначено для писателей, которые хотят создавать контент на мобильных устройствах, работая со статическими сайтами, включая Jekyll, Hugo, Astro и другие генераторы статических сайтов.

Приложение подключается к вашему репозиторию, чтобы вы могли управлять новыми постами и правками существующих Markdown-файлов, а затем публиковать изменения с использованием рабочих процессов, соответствующих ветвлению или pull request в Git.

Ключевые возможности

• Блочный Markdown-редактор с функцией drag-to-reorder для упорядочивания заголовков, списков, цитат и блоков кода во время написания
• Интеграция с камерой и галереей фото: приложение обрабатывает и загружает изображения как часть поста
• Варианты макетов изображений (на всю ширину, половина, бок о бок и дополнительные классы макетов) для контроля отображения изображений в постах
• Гибкие шаблоны frontmatter с пользовательскими полями (текст, выпадающие списки, выбор изображений) и поддержка импорта frontmatter из существующих постов репозитория
• Несколько режимов публикации: push прямо в основную ветку, создание новой ветки или открытие pull request
• Просмотрщик репозитория для просмотра структуры файлов, открытия существующих Markdown-файлов, редактирования и повторной публикации
• Режимы светлой, тёмной и системной тем
• Безопасное хранение токенов с использованием keychain устройства

Как использовать Git Blog

1. Откройте Git Blog на iPhone или iPad и подключите его к репозиторию GitHub.
2. Создайте новый Markdown-пост с помощью блочного редактора, добавляя контент и вставляя изображения по необходимости.
3. Используйте шаблоны frontmatter для заполнения обязательных полей (или импортируйте frontmatter из существующего поста), чтобы пост соответствовал структуре вашего сайта.
4. Опубликуйте с помощью предпочитаемого рабочего процесса — push в main, создание ветки или открытие pull request — и позвольте приложению обработать коммит (включая изображения).
5. Для правки существующего контента используйте просмотрщик репозитория, чтобы открыть Markdown-файл, отредактировать его и переопубликовать.

Сценарии использования

• Создание черновика нового поста блога вдали от ноутбука, затем публикация на сайт на базе GitHub в одном мобильном рабочем процессе
• Редактирование ранее опубликованных Markdown-постов: просмотр структуры репозитория, открытие файла, внесение обновлений и повторная публикация
• Управление постами для генератора статических сайтов, зависящего от полей frontmatter (выбор значений из выпадающих списков или указание изображений)
• Создание и форматирование технических постов с блоками кода и一致ной структурой с помощью блочного редактора и перестановки блоков во время написания
• Публикация изменений в командо-ориентированном Git-процессе: push прямо в main при необходимости или создание ветки / pull request для ревью

FAQ

• Поддерживает ли Git Blog генераторы статических сайтов?
  Да. Оно работает с Jekyll, Hugo, Astro и любыми генераторами статических сайтов.

• Можно ли публиковать изменения как pull request вместо push в main?
  Да. Приложение поддерживает публикацию через открытие pull request, а также push прямо в основную ветку или создание новой ветки.

• Как работает загрузка изображений?
  Вы можете сделать фото или выбрать из галереи, а Git Blog обработает и загрузит изображения вместе с постом. Приложение включает изображения в коммит при публикации.

• Можно ли редактировать существующие Markdown-файлы в репозитории?
  Да. Git Blog включает просмотрщик репозитория для открытия существующих Markdown-файлов, редактирования и повторной публикации.

• Какие устройства и версии ОС требуются?
  В App Store указано: iOS 17.0 или новее для iPhone, iPadOS 17.0 или новее для iPad, macOS 14.0 или новее с чипом Apple M1 или новее для Mac, visionOS 1.0 или новее для Apple Vision.

Альтернативы

• Markdown-редакторы с поддержкой GitHub (десктоп/мобильные): Они тоже генерируют Markdown и синхронизируют с GitHub, но могут полагаться на ручные Git-операции или предлагать иной опыт редактирования, отличный от блочного.
• Инструменты CMS для статических сайтов (веб-редакторы контента): Они фокусируются на создании без прямой работы с ветвлением/pull request в Git, что упрощает публикацию, но может не соответствовать Git-ориентированному процессу.
• Локальные рабочие процессы для статических сайтов (редактирование Markdown и сборка локально): Это даёт полный контроль над рендерингом и превью, но обычно требует компьютера, а не прямого создания и публикации с телефона или планшета.
• Веб-редактирование в GitHub: Всё остаётся в интерфейсе GitHub для быстрых правок, но без мобильного блочного Markdown-редактора и шаблонов frontmatter, описанных для Git Blog.