Создание новой статьи

9 февраля 2026

Оглавление

1. Введение
2. Шаг 1: Подготовка
3. Шаг 2: Создание файла
4. Шаг 3: Заполнение шаблона
5. Шаг 4: Сохранение и публикация
6. Структура статьи
7. Пример готовой статьи
8. Проверка статьи

---

Введение

Создать новую статью на нашем сайте так же просто, как создать документ в Google Docs! Вам нужно только:

1. Зайти в нужную папку на GitHub
2. Нажать кнопку «Add file»
3. Заполнить шаблон
4. Сохранить изменения

Время создания: 5-15 минут

Что понадобится:

• Текст статьи (уже подготовленный)
• Картинки (если нужны)
• Понятное название для файла

---

Шаг 1: Подготовка

Выберите место для статьи:

Папка	Что сюда относится
docs/baza-znaniy/	Статьи о базах знаний
docs/github-redaktirovanie/	Инструкции по GitHub
docs/articles/	Блог-статьи

Придумайте название файла:

Хорошее название	Плохое название
kak-redaktirovat-statyu.md	Новая статья (1).md
vvedenie-v-ai.md	Article.doc
rabota-s-klientami.md	файл_для_клиентов.md

Правила названий:

✅ Можно:

• Английские буквы (a-z)
• Дефисы вместо пробелов (-)
• Цифры

❌ Нельзя:

• Пробелы
• Русские буквы
• Специальные символы (!@#$%^&*)
• Прописные буквы (A-Z)

---

Шаг 2: Создание файла

Перейдите в папку:

1. Откройте репозиторий: github.com/itcomgroup/owix-ai-division
2. Перейдите в папку docs/
3. Выберите нужную подпапку (например, github-redaktirovanie/)

Нажмите «Add file»:

┌─────────────────────────────────────────────────────┐
│  itcomgroup / owix-ai-division / docs / ...      │
├─────────────────────────────────────────────────────┤
│  📁 baza-znaniy/                                   │
│  📁 blog/                                          │
│  📁 github-redaktirovanie/                         │
│                                                    │
│  💡 Drag and drop files here to add them...       │
│                                                    │
│  [Add file ▼]  ←  Нажмите сюда                    │
└─────────────────────────────────────────────────────┘

Выберите «Create new file»:

[Add file ▼]
├── Create new file
└── Upload files

---

Шаг 3: Заполнение шаблона

Введите название файла:

┌─────────────────────────────────────────────────────┐
│  Name your file:                                    │
│  docs/github-redaktirovanie/                        │
│  moja-pervaya-statya.md    ← Введите название      │
│                                                    │
│  ┌─────────────────────────────────────────────┐   │
│  │ # Введение                                 │   │  ← Начните писать статью
│  │                                             │   │
│  │ 9 февраля 2026                            │   │
│  └─────────────────────────────────────────────┘   │
│                                                    │
│  [ Preview changes ]  [ Cancel ]                  │
└─────────────────────────────────────────────────────┘

Используйте наш шаблон:

---
sidebar_position: 10
---

# Название статьи

9 февраля 2026

## Оглавление

1. [Раздел 1](#razdel-1)
2. [Раздел 2](#razdel-2)

---

##  Раздел 1

Содержание раздела...

---

##  Раздел 2

Содержание раздела...

---

## Дополнительные материалы

- [Ссылка 1](URL)
- [Ссылка 2](URL)

---

Шаг 4: Сохранение и публикация

Заполните Commit Message:

┌─────────────────────────────────────────────────────┐
│  Commit new file                                  │
│  ┌─────────────────────────────────────────────┐   │
│  │ docs: Add new article "Название статьи"    │   │  ← Описание
│  └─────────────────────────────────────────────┘   │
│                                                    │
│  💡 Рекомендуемый формат:                         │
│  "docs: Добавить статью 'Название'"               │
│                                                    │
│  [✓] Create a new branch for this commit         │
│  └── Start a pull request →  [ Commit new file ] │
│                                                    │
└─────────────────────────────────────────────────────┘

Нажмите «Commit new file»

После сохранения:

1. GitHub автоматически пересоберёт сайт
2. Через 1-2 минуты статью можно будет найти на owix.net

---

Структура статьи

Обязательные элементы:

Элемент	Описание	Пример
Frontmatter	Метаданные в начале файла	---...---
Заголовок H1	Главный заголовок	# Название
Дата	Дата публикации	9 февраля 2026
Оглавление	Список разделов	## Оглавление

Frontmatter (обязательно в начале файла):

---
sidebar_position: 10  ← Порядок в сайдбаре (число)
---

Порядок в сайдбаре:

sidebar_position	Где появится
1	Первым в списке
2	Вторым
10	Десятым
100	В самом конце

---

Пример готовой статьи

Файл: moja-pervaya-statya.md

---
sidebar_position: 10
---

# Моя первая статья

9 февраля 2026

## Оглавление

1. [Введение](#vvedenie)
2. [Что я узнал](#chto-ya-uznal)
3. [Заключение](#zaklyuchenie)

---

##  Введение

Это моя первая статья на сайте owix.net! Я создал её самостоятельно через GitHub.

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

---

##  Что я узнал

В процессе создания статьи я научился:
- Работать с Markdown
- Создавать структурированные документы
- Публиковать контент на сайте

---

##  Заключение

Создание статей через GitHub — это просто и удобно!

---

## Дополнительные материалы

- [Как редактировать статью](./kak-redaktirovat-statyu-v-brauzere)
- [Форматирование Markdown](./formatirovanie-markdown)

---

Проверка статьи

После публикации проверьте:

✅ Проверьте на owix.net:

1. Откройте статью на сайте
2. Проверьте заголовки
3. Проверьте ссылки
4. Проверьте изображения

✅ Если что-то не так:

1. Вернитесь на GitHub
2. Исправьте ошибку
3. Сохраните снова (Commit)

Статья обновится автоматически через 1-2 минуты!

---

См. также:

• Как редактировать статью в браузере
• Форматирование Markdown
• Работа с изображениями