🚀 Быстрая шпаргалка по использованию

Исправление ошибок MDX

# 1. Переходим в директорию проекта
cd /home/admin/wiki-az-doc

# 2. Делаем скрипт исполняемым (первый раз)
chmod +x fix-mdx-errors.sh

# 3. Проверяем файлы без изменений
./fix-mdx-errors.sh docs/ --dry-run

# 4. Исправляем все ошибки
./fix-mdx-errors.sh docs/

# 5. Подробный отчет
./fix-mdx-errors.sh docs/ --verbose

Сборка и запуск

# Локальная сборка
npm run clear
npm run build

# Запуск через Docker
sudo docker compose -f docker-compose.production.yml up -d --build

# Проверка
curl -I http://localhost:3000

Если ошибка при сборке

# 1. Исправляем MDX ошибки
./fix-mdx-errors.sh docs/ --verbose

# 2. Очищаем кэш
npm run clear
rm -rf node_modules/.cache

# 3. Пересобираем
npm run build

# 4. Перезапускаем Docker
sudo docker compose -f docker-compose.production.yml down
sudo docker compose -f docker-compose.production.yml up -d --build

Что исправляет скрипт

✅ CRLF → LF (окончания строк)
✅ <текст> → `<текст>` (угловые скобки)
✅ **<текст>** → `<текст>` (жирный текст в скобках)
✅ Удаляет дубли frontmatter
✅ ** Заголовок ** → ## Заголовок

Примеры использования

# Проверить один файл
./fix-mdx-errors.sh docs/file.md --dry-run

# Проверить директорию
./fix-mdx-errors.sh docs/1c-ut/ --dry-run

# Исправить все файлы
./fix-mdx-errors.sh docs/

# Подробный отчет
./fix-mdx-errors.sh docs/ --verbose

# Проверить текущую директорию
./fix-mdx-errors.sh .

Автоматическая сборка

# Запустить автоматическую сборку
chmod +x auto-build.sh
./auto-build.sh

Полезные команды Docker

# Статус контейнеров
sudo docker ps

# Логи
sudo docker logs -f wiki-az-doc-app-1

# Перезапуск
sudo docker compose restart

# Остановка
sudo docker compose down

# Запуск
sudo docker compose up -d