110421

2026-09-29 09:55:08 +00:00 · 2021-04-11 18:02:41 +03:00
parent 9a46eac382
commit e2db25138a
9 changed files with 72 additions and 3 deletions
@@ -0,0 +1,70 @@
+#Настройка редактора 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"
@@ -0,0 +1,26 @@
+---
+published: true
+date: '19:30 14.03.2019'
+taxonomy:
+    categories:
+        - articles
+    tags:
+        - GNU/Linux
+        - Debian
+url: /blog
+title: 'Первый пост'
+---
+
+#Переустановка Debian
+Мне ни разу не удавалось перейти на новуюверсию Debian  без усановки системы с нуля. Видимо как-то криво я ставил или удалял пакеты, что при смене версии ни разу зависимости у меня не разрешались. Поэтому приходиться разрабатывать схему покоторой я с минимальными затратами времени и сил смогу перейти на свежую версию.
+
+Для себя определил следующие этапы:
+1. Сбор инормации об установленных пакетах
+2. Резервное копирование настроек установленных пакетов на github
+3. Подготовка установочного носителя
+4. Установка новой системы
+5. Установка пакетов
+6. Применение настроек
+7. Разбор ошибок
+
+#1. Сбор информации об установленных пакетах
@@ -0,0 +1,54 @@
+# Быстрый старт
+
+Настоятельно рекомендуем прочитать полную версию документации, но для особо нетерпеливых ниже представлен ряд шагов, чтобы быстро начать работу.
+
+# Подготовка
+В системе GNU/Linux Debian Buster по-умолчанию уже устанолен Python 3.7 Установим утилиту для создния виртуального окружения venv.
+`$ sudo aptitude install python3-venv`
+Он включает в свой состав утилиты pip для установки пакетов
+
+Создаем каталог в котором будет работать Pelican:
+`$ mkdir pelican && cd pelican`.
+
+Создаем внутри каталога виртуальную среду Pytnon `$ python3 -m venv pelicanenv` и активируем её командой `$ source pelicanenv/bin/activate`
+
+# Установка
+Устанавливаем Pelican (и дополнительно Markdown) на Python 3.7+, выполнив следующую команду в терминале:
+`(pelicanenv) $ pip install pelican[Markdown]`
+
+
+# Создание проекта
+Выбираем имя для проекта и создаем каталог с соответствующим именем для сайта и переходим в этот каталог:
+`(pelicanenv) $ mkdir -p ./projects/yoursite.ru
+(pelicanenv) $ cd ./projects/yoursite.ru`
+
+Дальше создаем основу для проекта с помощью команды `pelican-quickstart`. Эта команда задаст несколько вопросов о создаваемом сайте. На вопрос о URL адресе сайта следует ответить в том же виде как будет отображено в примере http://yoursite.ru
+
+
+# Создаем статью
+Для того чтобы запустить Pelican потребуется создать хотя бы одну статью. Для этого в любом тектосовм редакторе создаем файл со следующим cодержимым:
+`Title: Мой Первый Отзыв
+Date: 2020-05-04 10:20
+Category: Обзор
+
+Ниже приведен обзор моей любимой механической клавиатуры.`
+
+Поскольку эта статья для примера рассматривает работу с данными в формате Markdown, то сохранить его нужно как `./projects/yoursite.ru/content/keyboard-review.md`.
+
+# Генерируем сайт
+В корневом каталоге проекта `./projects/yoursite.ru/`выполните pelican-команду для создания сайта:
+`(pelicanenv) $ pelican content`
+
+В результате выполенния команды сайт был создан внутри каталога `./projects/yoursite.ru/output`. В процесе работы могут отобразиться предупреждения, относящееся к RSS лентам, но это нормально при локальном развертывании и можно пока не обращать на них внимание.
+
+# Предварительный просмотр сайта
+Открываем сеанс терминала, перейдим в корневой каталог проекта `./projects/yoursite.ru/`и выполняем команду для запуска веб-сервера Pelican:
+`(pelicanenv) pelican --listen`
+
+Теперь просмотреть сгенерированный сайт можно перейдя на http://localhost:8000/ в браузере.
+
+Более подробная информация содержится вдокументации, продолжайте изучать её. Так же на странице [Tutorials](https://github.com/getpelican/pelican/wiki/Tutorials) wiki Pelican приведены ссылки на опубликованные сообществом руководства.
+
+# Источники
+https://python-scripts.com/virtualenv
+https://docs.getpelican.com/en/stable/quickstart.html