+++
title = "Atom + markdown"
date = "2020-05-03"
description = "Описание как сделать из Atom удобный редактор Markdown файлов"
tags = [
    "ide",
    "markdown",
]
+++

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

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

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

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

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

1. Скачиваем пакет с сайта [Atom][75f0e641].
![Главная страница atom.io](images/2020/05/screenshot-atom.io-2020.05.03-15_33_48.png)      
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`

3. Для хранения файлов можно использовать репозиторий 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 без редактирования
файлов конфигурации.

4. Теперь для добства работы нужно добавить в 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-разметки отображаются в верхней части окна и при
необходимости можно их использовать.

  [75f0e641]: https://atom.io "Atom"