Тестирование сниппетов

1. Добавить информацию из файла целиком. Например, git.md.
2. Добавить кусочек текста между заголовками.
3. Добавить отдельный абзац.

Файл целиком

Работа с Git

Создание ветки

1. Откройте терминал и выполните команду: git branch. Появится список веток, выделена текущая ветка.
2. Если текущая ветка – master, создайте ветку: git checkout -b имя-новой-ветки. Если текущая ветка – не master, переключитесь в основную ветку: git checkout master и создайте новую.

Отправка изменений в Github

1. Сохраните изменения всех файлов:

   git add -A
   

2. Зафиксируйте изменения:

   git commit -m "ваше сообщение"
   

3. Отправьте изменения в репозиторий:

   git push origin название-текущей-ветки
   

4. Откройте репозиторий в Github.

5. Перейдите на закладку Pull requests и нажмите на кнопку New pull request.
6. Чтобы принять пулл реквест, нажмите на кнопку Create Pull Request.
7. Чтобы слить изменения в ветку master, нажмите на кнопку Merge pull request.
8. Нажмите на кнопку Confirm merge.

Актуализация локального репозитория

1. В локальном репозитории перейдите в ветку master:

   git checkout master
   

2. Загрузите изменения из ветки master мастер-репозитория:

   git pull my-project master
   

3. Отправьте изменения из своей ветки master в ваш форк на GitHub:

   git push origin master
   

Теперь форк и оригинальный репозиторий находятся в актуальном состоянии.

Текст между заголовками

Создание проекта Foliant

1. В командной строке перейдите в папку, в которой будет создан проект Foliant.

2. Создайте проект:

   foliant init
   

3. Укажите имя проекта, например, "Hello Foliant". Появится сообщение:

   Project "Hello Foliant" created in hello-foliant
   

Чтобы посмотреть содержимое проекта, выполните команды:

$ cd hello-foliant
$ tree
.
├── docker-compose.yml
├── Dockerfile
├── foliant.yml
├── README.md
├── requirements.txt
└── src
    └── index.md
1 directory, 6 files

Проект содержит файлы и папки:

• docker-compose.yml и Dockerfile – файлы, необходимые для создания проекта в Docker;
• foliant.yml – конфигурационный файл проекта;
• README.md – файл с информацией о проекте;
• requirements.txt – список пакетов Python, необходимых для проекта: бэкенды и препроцессоры, темы для MkDocs и т.д.;
• src – папка с исходными файлами проекта. По умолчанию в папке создается файл index.xml.

Абзац

Для работы с Markdown можно использовать любой текстовый редактор.