OSINT mindset — Сайт сообщества

Официальный сайт русскоязычного сообщества OSINT специалистов.

🌐 Сайт: https://osint-mindset.com
📱 Telegram: https://t.me/osint_mindset
🎥 YouTube: https://youtube.com/@osint_mindset

Быстрый старт

Установка зависимостей

# Активировать виртуальную среду
source .venv/bin/activate

# Установить зависимости (если нужно)
pip install -r requirements.txt

Локальная разработка

# Запустить локальный сервер
mkdocs serve

# Сайт будет доступен по адресу:
# http://127.0.0.1:8000/

Сборка для продакшена

# Собрать статический сайт
mkdocs build

# Результат будет в папке site/

Структура проекта

osint-mindset-org-ru/
├── docs/                   # Исходники контента
│   ├── ru/                # Русская версия
│   │   ├── README.md      # Главная страница
│   │   ├── community/     # Материалы сообщества
│   │   ├── guides/        # Руководства
│   │   └── ...
│   ├── en/                # Английская версия
│   │   ├── README.md      # Главная страница
│   │   ├── community/     # Материалы сообщества
│   │   ├── guides/        # Руководства
│   │   └── ...
│   ├── assets/            # Изображения и медиа (общие)
│   └── stylesheets/       # Стили (общие)
├── site/                  # Собранный сайт (генерируется)
├── mkdocs.yml             # Конфигурация MkDocs
└── requirements.txt       # Python зависимости

Двуязычность

Сайт поддерживает два языка: русский (по умолчанию) и английский.

Как это работает

• Используется плагин mkdocs-static-i18n
• Русская версия: / (корень сайта)
• Английская версия: /en/
• Переключатель языка в правом верхнем углу

Добавление нового контента

Русская версия

1. Создайте файл в docs/ru/
2. Добавьте его в навигацию в mkdocs.yml (секция nav)
3. Готово!

Английская версия

1. Создайте файл в docs/en/ с тем же путём, что и русская версия
2. Переведите контент
3. Плагин автоматически свяжет обе версии

Пример:

• Русская: docs/ru/guides/new-guide.md
• Английская: docs/en/guides/new-guide.md

Результат:

• /guides/new-guide/ — русская страница
• /en/guides/new-guide/ — английская страница

Fallback на русский

Если для страницы нет английского перевода, автоматически показывается русская версия.

Технологии

• MkDocs — генератор статических сайтов
• Material for MkDocs — тема оформления
• mkdocs-static-i18n — плагин для многоязычности

Деплой

Автоматический деплой (GitHub Pages)

Проект настроен на автоматический деплой через GitHub Actions.

Что происходит автоматически:

• При пуше в ветку main или master
• GitHub Actions собирает сайт (mkdocs build)
• Публикует результат на GitHub Pages

Настройка (один раз):

1. Зайдите в Settings → Pages вашего репозитория
2. Source: выберите "GitHub Actions"
3. Готово! При следующем пуше сайт обновится автоматически

Файл конфигурации: .github/workflows/ci.yml

Ручной деплой

Если нужно собрать и задеплоить вручную:

# Собрать сайт
mkdocs build

# Загрузить содержимое папки site/ на ваш хостинг

Другие платформы

Для Cloudflare Pages, Netlify, Vercel:

• Команда сборки: mkdocs build
• Папка публикации: site
• Python версия: 3.x

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

# Запустить локальный сервер с автоперезагрузкой
mkdocs serve

# Собрать сайт
mkdocs build

# Собрать сайт с очисткой старых файлов
mkdocs build --clean

# Собрать с подробным выводом (для отладки)
mkdocs build --verbose

# Проверить конфигурацию
mkdocs build --strict

Контрибьюция

Хотите помочь с развитием сайта?

1. Форкните репозиторий
2. Создайте ветку для ваших изменений
3. Внесите изменения
4. Создайте Pull Request

Что можно улучшить

• Перевести больше материалов на английский
• Добавить новые гайды и статьи
• Улучшить дизайн и UX
• Исправить опечатки и ошибки

Лицензия

Контент распространяется под лицензией, указанной в репозитории.

Контакты

• Telegram: https://t.me/osint_mindset
• YouTube: https://youtube.com/@osint_mindset
• GitHub: https://github.com/osint-mindset

---

Сделано с ❤️ сообществом OSINT mindset