Журнал Стороженко Евгения

Atom + markdown

Настройка редактора Atom для работы с Markdown

Для работы над статическим сайтом нужно:

  • Редактировать файлы Markdown
  • Хранить файлы в “безопасном” месте. Чтобы случайно их не потерять
  • Облегчить себе работу по формирофанию необходимой сужебной информации внутри файлов (Front Matter)

GitHub поможет решить вопрос хранения файлов со статьями и новостямии, а вот удобного редактирования и наполнения файлов можно решить практически любым редактором кода. Для себя я выбрал редактор от авторов GitHub - Atom.

Это современные кросс платформенный редактор кода, с множеством удобным плагинов и, что самое важное, встроенной интеграцией с Github. Что позволяет собрать функионально рабочее место для работы над блогом буквально за 15 минут. И не беспокоиться о том, что с таким трудом созданные данные будут утеряны из-за аппаратного или программного сбоя.

Поскольку работаю я на GNU/Linux Debian, то и процесс настройки буду описывать для этой операционной системы.

  1. Скачиваем пакет с сайта Atom.
    Главная страница atom.io
  2. Устанавливаем зависимости:

$ sudo aptitude install git, libgconf-2-4, libgtk-3-0, libgcrypt20, libnotify4, libxtst6, libnss3, python, gvfs-bin, xdg-utils, libx11-xcb1, libxss1, libasound2, libxkbfile1, libcurl4, policykit-1, lsb-release Первое, что следует сделать после установки Git — указать своё имя и адрес электронной почты. Это важно, потому что каждый коммит в Git содержит эту информацию, и она включена в коммиты, передаваемые вами, и не может быть далее изменена:

$ git config --global user.name "kpa39l" $ git config --global user.email kpa39l@yandex.ru

Если указана опция –global, то эти настройки достаточно сделать только один раз, поскольку в этом случае Git будет использовать эти данные для всего, что вы делаете в этой системе. Если для каких-то отдельных проектов вы хотите указать другое имя или электронную почту, можно выполнить эту же команду без параметра –global в каталоге с нужным проектом.

Теперь устанавливаем сам редактор:

$ sudo dpkg -i ~/Загрузки/atom-amd64.deb

После установки ярлык для запуска добавиться в раздел “Разработка” системного меню. ![Расположения ярлыка в системном меню](images/2020/05/Снимок экрана_2020-05-03_15-47-43.png) Или можно его запустить используя команду в консоли от текущего пользователя:

$ atom

  1. Для хранения файлов можно использовать репозиторий GitHub. Ведь именно для этого как раз и выбирался редактор Atom,как имеющий встроенную интеграцию c GitHub. Для этого нужно получить ссылку для клонирования репозитория ![Копируем ссылку для клонирования репозитория](images/2020/05/Снимок экрана_2020-05-03_16-06-03.png)

https://github.com/kpa39l/gelonet.git

Теперь при открытии панели с интеграцией с GitHUb (Ctrl + Shift + 8) и нажав кнопку “Clone existing repository” мы можем ввести в поле ввода эту ссылку. Чтобы не мучаться с авторизацией в ссылку можно добавить данные о логине и пароле, приведя её к виду:

https://login:password@github.com/kpa39l/gelonet.git

Эти действия настроят интеграцию локальной папки с репозиторием на GitHub без редактирования файлов конфигурации.

  1. Теперь для добства работы нужно добавить в Atom несколько плагинов для увеличения удобства работы со статическими блогами на Markdown. Для себя я определил следующий список:
  • markdown-scroll-sync
  • markdown-writer и зависящий от него
  • tool-bar-markdown-writer

Чтобы не искать их в списке пакетов достаточно выполнить в консоли команду: $ apm install markdown-scroll-sync tool-bar markdown-writer tool-bar-markdown-writer

В итоге при работе с Markdown файлами в интерфейсе редактора появится вот такая панель: ![](images/2020/05/Снимок экрана_2020-05-03_16-36-21.png) Часто используемые инструменты Markdown-разметки отображаются в верхней части окна и при необходимости можно их использовать.