10 Commits
Author SHA1 Message Date
erjemin 4604f6923a mod: улучшено SEO 2026-10-07 00:43:48 +03:00
erjeminandJunie 73b9ae4dd6 Обновление версии для релиза v0.2.8
Build ETPGRF-site / build (push) Successful in 2m10s
Co-authored-by: Junie <junie@jetbrains.com>
2026-10-04 23:18:29 +03:00
erjeminandJunie 06a4ea6870 build(static): add compiled CodeMirror bundle and local vendor assets
Co-authored-by: Junie <junie@jetbrains.com>
2026-10-04 23:04:57 +03:00
erjeminandJunie 1cc070b7c0 feat(frontend): configure vendor build scripts and fallback templates
Co-authored-by: Junie <junie@jetbrains.com>
2026-10-04 23:04:45 +03:00
erjemin 73f68e9a2f mod: переработан .gitignore 2026-10-04 22:53:27 +03:00
erjemin 21144eb825 add: немного описания 2026-10-04 22:32:48 +03:00
erjemin d0e8ca2e8d fix: хелфчек глючил 2026-07-05 19:48:56 +03:00
erjemin 39fbfd2193 add: линк для llms.txt 2026-04-11 14:08:32 +03:00
erjemin 8379d734dd add: Healthcheck b лимиты 2026-04-11 14:07:40 +03:00
erjemin 10c99fc216 ---. minor 2026-03-22 15:28:42 +03:00
33 changed files with 1349 additions and 692 deletions
+105 -467
View File
@@ -1,279 +1,70 @@
### PyCharm+iml template
# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
# ==============================================================================
# .gitignore для проекта ETPGRF Site (Django + Node.js/Frontend + Docker)
# ==============================================================================
# User-specific stuff
.idea/**/workspace.xml
.idea/**/tasks.xml
.idea/**/usage.statistics.xml
.idea/**/dictionaries
.idea/**/shelf
# AWS User-specific
.idea/**/aws.xml
# Generated files
.idea/**/contentModel.xml
# Sensitive or high-churn files
.idea/**/dataSources/
.idea/**/dataSources.ids
.idea/**/dataSources.local.xml
.idea/**/sqlDataSources.xml
.idea/**/dynamic.xml
.idea/**/uiDesigner.xml
.idea/**/dbnavigator.xml
# Gradle
.idea/**/gradle.xml
.idea/**/libraries
# Gradle and Maven with auto-import
# When using Gradle or Maven with auto-import, you should exclude module files,
# since they will be recreated, and may cause churn. Uncomment if using
# auto-import.
# .idea/artifacts
# .idea/compiler.xml
# .idea/jarRepositories.xml
# .idea/modules.xml
# .idea/*.iml
# .idea/modules
# *.iml
# *.ipr
# CMake
cmake-build-*/
# Mongo Explorer plugin
.idea/**/mongoSettings.xml
# File-based project format
# ------------------------------------------------------------------------------
# 1. Среды разработки и редакторы кода (IDE & Editors)
# ------------------------------------------------------------------------------
# JetBrains IDEs (PyCharm, WebStorm, IntelliJ IDEA и др.):
# Игнорируем полностью конфигурационную директорию .idea, чтобы локальные настройки,
# списки задач, кэши индексации и конфигурации раннеров не попадали в репозиторий.
.idea/
*.iml
*.iws
*.ipr
# IntelliJ
out/
# Visual Studio Code:
# Локальные настройки редактора, конфигурации отладки и расширений
.vscode/
*.code-workspace
# mpeltonen/sbt-idea plugin
.idea_modules/
# Временные файлы текстовых редакторов (Vim, Emacs, Nano):
*~
*.swp
*.swo
*.swn
.#*
\#*#
# JIRA plugin
atlassian-ide-plugin.xml
# Cursive Clojure plugin
.idea/replstate.xml
# SonarLint plugin
.idea/sonarlint/
# Crashlytics plugin (for Android Studio and IntelliJ)
com_crashlytics_export_strings.xml
crashlytics.properties
crashlytics-build.properties
fabric.properties
# Editor-based Rest Client
.idea/httpRequests
# Android studio 3.1+ serialized cache file
.idea/caches/build_file_checksums.ser
### JetBrains template
# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
# User-specific stuff
.idea/**/workspace.xml
.idea/**/tasks.xml
.idea/**/usage.statistics.xml
.idea/**/dictionaries
.idea/**/shelf
# AWS User-specific
.idea/**/aws.xml
# Generated files
.idea/**/contentModel.xml
# Sensitive or high-churn files
.idea/**/dataSources/
.idea/**/dataSources.ids
.idea/**/dataSources.local.xml
.idea/**/sqlDataSources.xml
.idea/**/dynamic.xml
.idea/**/uiDesigner.xml
.idea/**/dbnavigator.xml
# Gradle
.idea/**/gradle.xml
.idea/**/libraries
# Gradle and Maven with auto-import
# When using Gradle or Maven with auto-import, you should exclude module files,
# since they will be recreated, and may cause churn. Uncomment if using
# auto-import.
# .idea/artifacts
# .idea/compiler.xml
# .idea/jarRepositories.xml
# .idea/modules.xml
# .idea/*.iml
# .idea/modules
# *.iml
# *.ipr
# CMake
cmake-build-*/
# Mongo Explorer plugin
.idea/**/mongoSettings.xml
# File-based project format
*.iws
# IntelliJ
out/
# mpeltonen/sbt-idea plugin
.idea_modules/
# JIRA plugin
atlassian-ide-plugin.xml
# Cursive Clojure plugin
.idea/replstate.xml
# SonarLint plugin
.idea/sonarlint/
# Crashlytics plugin (for Android Studio and IntelliJ)
com_crashlytics_export_strings.xml
crashlytics.properties
crashlytics-build.properties
fabric.properties
# Editor-based Rest Client
.idea/httpRequests
# Android studio 3.1+ serialized cache file
.idea/caches/build_file_checksums.ser
### PyCharm template
# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
# User-specific stuff
.idea/**/workspace.xml
.idea/**/tasks.xml
.idea/**/usage.statistics.xml
.idea/**/dictionaries
.idea/**/shelf
# AWS User-specific
.idea/**/aws.xml
# Generated files
.idea/**/contentModel.xml
# Sensitive or high-churn files
.idea/**/dataSources/
.idea/**/dataSources.ids
.idea/**/dataSources.local.xml
.idea/**/sqlDataSources.xml
.idea/**/dynamic.xml
.idea/**/uiDesigner.xml
.idea/**/dbnavigator.xml
# Gradle
.idea/**/gradle.xml
.idea/**/libraries
# Gradle and Maven with auto-import
# When using Gradle or Maven with auto-import, you should exclude module files,
# since they will be recreated, and may cause churn. Uncomment if using
# auto-import.
# .idea/artifacts
# .idea/compiler.xml
# .idea/jarRepositories.xml
# .idea/modules.xml
# .idea/*.iml
# .idea/modules
# *.iml
# *.ipr
# CMake
cmake-build-*/
# Mongo Explorer plugin
.idea/**/mongoSettings.xml
# File-based project format
*.iws
# IntelliJ
out/
# mpeltonen/sbt-idea plugin
.idea_modules/
# JIRA plugin
atlassian-ide-plugin.xml
# Cursive Clojure plugin
.idea/replstate.xml
# SonarLint plugin
.idea/sonarlint/
# Crashlytics plugin (for Android Studio and IntelliJ)
com_crashlytics_export_strings.xml
crashlytics.properties
crashlytics-build.properties
fabric.properties
# Editor-based Rest Client
.idea/httpRequests
# Android studio 3.1+ serialized cache file
.idea/caches/build_file_checksums.ser
### macOS template
# General
# ------------------------------------------------------------------------------
# 2. Файлы операционных систем (OS metadata)
# ------------------------------------------------------------------------------
# macOS: файлы кэша структуры папок и метаданных Finder
.DS_Store
.AppleDouble
.LSOverride
# Icon must end with two \r
Icon
# Thumbnails
.DS_Store?
._*
# Files that might appear in the root of a volume
.DocumentRevisions-V100
.fseventsd
.Spotlight-V100
.TemporaryItems
.Trashes
.VolumeIcon.icns
.com.apple.timemachine.donotpresent
# Directories potentially created on remote AFP share
.AppleDB
.AppleDesktop
Network Trash Folder
Temporary Items
.apdisk
# Windows: кэши миниатюр и настройки отображения папок
Thumbs.db
Thumbs.db:encryptable
ehthumbs.db
ehthumbs_vista.db
Desktop.ini
$RECYCLE.BIN/
### Python template
# Byte-compiled / optimized / DLL files
# Linux: служебные файлы
*~
# ------------------------------------------------------------------------------
# 3. Python и виртуальные окружения (Python & Virtual Environments)
# ------------------------------------------------------------------------------
# Байткод Python и кэши скомпилированных файлов:
__pycache__/
*.py[cod]
*$py.class
# C extensions
*.so
# Distribution / packaging
.Python
# Виртуальные окружения (локальные папки с установленными зависимостями):
.venv/
env/
venv/
ENV/
env.bak/
venv.bak/
# Артефакты сборки, дистрибутивы и метаданные пакетов:
build/
develop-eggs/
dist/
@@ -286,228 +77,75 @@ parts/
sdist/
var/
wheels/
share/python-wheels/
*.egg-info/
.installed.cfg
*.egg
MANIFEST
# PyInstaller
# Usually these files are written by a python script from a template
# before PyInstaller builds the exe, so as to inject date/other infos into it.
*.manifest
*.spec
# Installer logs
pip-log.txt
pip-delete-this-directory.txt
# Unit test / coverage reports
htmlcov/
.tox/
.nox/
# Кэши инструментов статического анализа, тестирования и типизации:
.pytest_cache/
.coverage
.coverage.*
.cache
nosetests.xml
coverage.xml
*.cover
*.py,cover
.hypothesis/
.pytest_cache/
cover/
# Translations
*.mo
*.pot
# Django stuff:
*.log
local_settings.py
*.sqlite3
*.sqlite3-journal
# Flask stuff:
instance/
.webassets-cache
# Scrapy stuff:
.scrapy
# Sphinx documentation
docs/_build/
# PyBuilder
.pybuilder/
target/
# Jupyter Notebook
.ipynb_checkpoints
# IPython
profile_default/
ipython_config.py
# pyenv
# For a library or package, you might want to ignore these files since the code is
# intended to run in multiple environments; otherwise, check them in:
# .python-version
# pipenv
# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
# However, in case of collaboration, if having platform-specific dependencies or dependencies
# having no cross-platform support, pipenv may install dependencies that don't work, or not
# install all needed dependencies.
#Pipfile.lock
# poetry
# Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
# This is especially recommended for binary packages to ensure reproducibility, and is more
# commonly ignored for libraries.
# https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
#poetry.lock
# pdm
# Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
#pdm.lock
# pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
# in version control.
# https://pdm.fming.dev/latest/usage/project/#working-with-version-control
.pdm.toml
.pdm-python
.pdm-build/
# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
__pypackages__/
# Celery stuff
celerybeat-schedule
celerybeat.pid
# SageMath parsed files
*.sage.py
# Environments
.env
.venv
env/
venv/
ENV/
env.bak/
venv.bak/
# Spyder project settings
.spyderproject
.spyproject
# Rope project settings
.ropeproject
# mkdocs documentation
/site
# mypy
htmlcov/
.mypy_cache/
.dmypy.json
dmypy.json
# Pyre type checker
.pyre/
# pytype static type analyzer
.pytype/
.ruff_cache/
.tox/
.nox/
# Cython debug symbols
cython_debug/
# ------------------------------------------------------------------------------
# 4. Django, базы данных, медиа-файлы и секреты (Django, DB & Secrets)
# ------------------------------------------------------------------------------
# Конфигурационные файлы с секретами и локальными переменными окружения:
.env
.env.*
!.env.example
# PyCharm
# JetBrains specific template is maintained in a separate JetBrains.gitignore that can
# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
# and can be added to the global gitignore or merged into this file. For a more nuclear
# option (not recommended) you can uncomment the following to ignore the entire idea folder.
#.idea/
# Базы данных SQLite (локальные тестовые и рабочие БД):
*.sqlite3
*.sqlite3-journal
*.db
*.db-journal
db.sqlite3
data/*.sqlite3
data/*.db
data/*.sqlite3-journal
data/*.db-journal
!data/README.md
### PyCharm+all template
# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
# Локально загружаемые медиа-файлы (пользовательский контент: картинки блога и т.д.):
media/*
!media/README.md
!media/.gitkeep
# User-specific stuff
.idea/**/workspace.xml
.idea/**/tasks.xml
.idea/**/usage.statistics.xml
.idea/**/dictionaries
.idea/**/shelf
# Лог-файлы:
*.log
logs/
# AWS User-specific
.idea/**/aws.xml
# Generated files
.idea/**/contentModel.xml
# Sensitive or high-churn files
.idea/**/dataSources/
.idea/**/dataSources.ids
.idea/**/dataSources.local.xml
.idea/**/sqlDataSources.xml
.idea/**/dynamic.xml
.idea/**/uiDesigner.xml
.idea/**/dbnavigator.xml
# Gradle
.idea/**/gradle.xml
.idea/**/libraries
# Gradle and Maven with auto-import
# When using Gradle or Maven with auto-import, you should exclude module files,
# since they will be recreated, and may cause churn. Uncomment if using
# auto-import.
# .idea/artifacts
# .idea/compiler.xml
# .idea/jarRepositories.xml
# .idea/modules.xml
# .idea/*.iml
# .idea/modules
# *.iml
# *.ipr
# CMake
cmake-build-*/
# Mongo Explorer plugin
.idea/**/mongoSettings.xml
# File-based project format
*.iws
# IntelliJ
out/
# mpeltonen/sbt-idea plugin
.idea_modules/
# JIRA plugin
atlassian-ide-plugin.xml
# Cursive Clojure plugin
.idea/replstate.xml
# SonarLint plugin
.idea/sonarlint/
# Crashlytics plugin (for Android Studio and IntelliJ)
com_crashlytics_export_strings.xml
crashlytics.properties
crashlytics-build.properties
fabric.properties
# Editor-based Rest Client
.idea/httpRequests
# Android studio 3.1+ serialized cache file
.idea/caches/build_file_checksums.ser
# --- ETPGRF Custom ---
# Generated frontend assets
public/static/codemirror/editor.js
frontend-assembly/dist/
# ------------------------------------------------------------------------------
# 5. Node.js, npm и фронтенд-сборка (Frontend Assembly)
# ------------------------------------------------------------------------------
# Зависимости npm (устанавливаются через npm install / assembly_via_npm.sh):
node_modules/
*/node_modules/
frontend-assembly/node_modules/
# Логи пакетных менеджеров:
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*
# Директории сборки и бандлов:
frontend-assembly/dist/
# ------------------------------------------------------------------------------
# 6. Временные файлы и артефакты отладки
# ------------------------------------------------------------------------------
*.tmp
*.temp
*.bak
.output.txt
+12 -1
View File
@@ -5,9 +5,20 @@
Формат основан на [Keep a Changelog](https://keepachangelog.com/ru/1.0.0/),
и этот проект придерживается [Semantic Versioning](https://semver.org/lang/ru/).
## [0.2.8] - 2026-10-04
### Добавлено
- Локальная статика для внешних фронтенд-библиотек (Bootstrap 5, Bootstrap Icons, HTMX, Alpine.js, CodeMirror 6) для работы интерфейса при недоступности CDN.
- Стратегия fallback-подключения в шаблонах: автоматическое переключение на локальную статику при сбое или блокировке CDN.
- Скрипт копирования production-ассетов `frontend-assembly/copy-vendor.js` и обновление сборки через `frontend-assembly/assembly_via_npm.sh`.
- Автоматические тесты проверки наличия статических вендорных ассетов и корректности рендеринга fallback-подключений в `typograph/tests.py`.
### Изменено
- Обновлен и структурирован `.gitignore` с подробными комментариями.
## [0.2.7] - 2025-03-22
### Изменено
- Обновлене всех пактов, включая `etpgrf` (v0.1.5 → v0.1.6.post1).
- Обновление всех пактов, включая `etpgrf` (v0.1.5 → v0.1.6.post1).
### Исправлено
- `canonical` для страниц учитывает https/http.
+32
View File
@@ -0,0 +1,32 @@
# Заметки по деплою проекту
В финальном комите перед новой версией (*ТОЛЬ ПОСЛЕ ТЕСТИРОВАНИЯ:) не забываем менять:
- `CHANGELOG.md` делать описание изменений.
- `typograph/templates/typograph/base.html` в шаблоне циферки в подвале
Затем, когда код готов к релизу, нужно обновить версию в `pyproject.toml`:
```shell
poetry version patch
```
Финальный коммит, таким образом, должен включать в себя:
- Обновление `CHANGELOG.md` с описанием изменений.
- Обновление версии в `pyproject.toml` (через `poetry version patch`).
- Обновление шаблона `base.html` (циферки в подвале).
— Обновление в `etpgrf_site/__init__.py`.
- И, конечно же, все изменения, которые были сделаны в коде.
После комита и пуша:
```shell
git add .
git commit -am "Обновление версии для релиза vX.Y.Z"
git push origin main
```
Для запуска деплоя CI/CD, через Gitea Actions, создаем `git tag` и пушим его в репозиторий:
```shell
git tag vX.Y.Z && git push origin vX.Y.Z
```
+57
View File
@@ -0,0 +1,57 @@
# Бэкенд: Архитектура и модули
## 1. Django Конфигурация (`etpgrf_site/etpgrf_site/`)
- **`settings.py`**:
- `DEBUG` и `SECRET_KEY` считываются из переменных окружения.
- `ADMIN_URL`: настраиваемый префикс панели администратора (по умолчанию `admin/`).
- База данных: SQLite в `data/db-etpgrf.sqlite3` с `timeout: 20` для надежности при конкурентных запросах.
- Статика: `STATICFILES_DIRS = [BASE_DIR.parent / 'public' / 'static']`, `STATIC_ROOT = BASE_DIR.parent / 'public' / 'static_collected'`.
- Медиа: `MEDIA_ROOT = BASE_DIR.parent / 'media'`, `MEDIA_URL = '/media/'`.
- Защита за прокси: в `not DEBUG` активированы `SECURE_PROXY_SSL_HEADER`, `SECURE_SSL_REDIRECT`, `SESSION_COOKIE_SECURE`, `CSRF_COOKIE_SECURE`, `USE_X_FORWARDED_HOST`, `USE_X_FORWARDED_PORT`.
- **`urls.py`**:
- `/{ADMIN_URL}` -> админка Django.
- `/` -> `typograph.urls` (главная страница типографа, API обработки и статистики).
- `/blog/` -> `blog.urls` (список постов, детальная страница поста).
- `/sitemap.xml` -> карта сайта (`PostSitemap`).
- `/<slug:slug>/` -> ловушка для статических страниц (например, `/about/`, `/privacy-policy/`, `/donate/`).
## 2. Приложение `typograph`
Отвечает за взаимодействие с библиотекой типографирования `etpgrf` и сбор агрегированной аналитики.
### Модели (`typograph/models.py`)
- **`DailyStat`**:
- Агрегированные посуточные показатели (`date` - уникальная дата).
- Метрики активности: `index_views`, `process_requests`, `copy_count`.
- Объемы данных: `chars_in`, `chars_out`, `chars_copied`.
- Производительность: `total_processing_time_ms`, вычисляемое свойство `avg_processing_time_ms`.
- `settings_stats`: JSONField со статистикой популярности опций (языки, кавычки, переносы, висячая пунктуация и т.д.).
### Представления и Эндпоинты (`typograph/views.py`)
- `index` (`/`): главная страница, инкрементирует просмотры `index_views`.
- `process_text` (`/process/`, POST):
- Принимает текст и параметры типографирования из формы.
- Инициализирует `LayoutProcessor`, `Hyphenator`, `Typographer` из пакета `etpgrf`.
- Производит замер времени обработки `time.perf_counter()`.
- Атомарно обновляет счетчики в `DailyStat`.
- Возвращает HTML-фрагмент `typograph/result_fragment.html` и заголовок `X-Processing-Time`.
- `track_copy` (`/track-copy/`, POST): фиксирует факт и длину скопированного в буфер текста.
- `get_stats_summary` (`/stats-summary/`, GET): возвращает компактный HTMX-фрагмент со статистикой для футера.
## 3. Приложение `blog`
Отвечает за публикации, статьи и произвольные статические страницы.
### Модели (`blog/models.py`)
- **`Post`**:
- `post_type`: `B` (Пост блога) или `P` (Страница).
- `title`, `slug` (автоматическая транслитерация через `pytils.translit.slugify` с обработкой коллизий).
- `is_published`, `published_at`, `updated_at`.
- `content` (HTML-разметка), `excerpt` (тизер).
- `image` (обложка для превью и Open Graph).
- SEO-поля: `seo_title`, `seo_description`, `seo_keywords`.
- Метод `get_absolute_url()`: возвращает `/blog/<slug>/` для постов или `/<slug>/` для страниц.
### Представления (`blog/views.py`)
- `post_list` (`/blog/`): список опубликованных статей блога с пагинацией.
- `post_detail` (`/blog/<slug>/`): детальная страница поста с Open Graph мета-тегами и разметкой.
- `page_detail` (`/<slug>/`): отображение статических страниц.
- `sitemaps.py`: генерация `sitemap.xml` по опубликованным записям.
+33
View File
@@ -0,0 +1,33 @@
# Деплой, окружение и регламент релизов
## 1. Конфигурация окружения (.env)
Обязательные переменные:
- `SECRET_KEY`: секретный ключ Django.
- `DEBUG`: `True` для локальной разработки, `False` для продакшена.
- `ALLOWED_HOSTS`: разрешенные хосты через запятую (например, `typograph.cube2.ru,localhost`).
- `CSRF_TRUSTED_ORIGINS`: доверенные URL (например, `https://typograph.cube2.ru,http://localhost:8000`).
- `ADMIN_URL`: путь к панели администратора (например, `mysecretadmin/`).
## 2. Docker и инфраструктура
- **`Dockerfile`**: базовый образ `python:3.13-slim`, установка Poetry, сборка зависимостей, запуск через Gunicorn.
- **`docker-compose.yml`**: конфигурация для разработки (монтирование исходного кода, базы данных и папок статики/медиа).
- **`docker-compose.prod.yml`**: конфигурация для продакшена со связанным сервисом Nginx (`config/nginx/`).
## 3. Чек-лист выпуска релиза (согласно NOTE.md)
Перед созданием релизного тега:
1. Протестировать функционал и миграции.
2. Внести описание изменений в `CHANGELOG.md`.
3. Обновить версии в:
- `pyproject.toml` (командой `poetry version patch` или вручную).
- `etpgrf_site/__init__.py` (при наличии `__version__`).
- `etpgrf_site/typograph/templates/typograph/base.html` (версия библиотеки и версия сайта в футере).
4. Закоммитить изменения:
```bash
git add .
git commit -am "Обновление версии для релиза vX.Y.Z"
git push origin main
```
5. Запустить пайплайн сборки и деплоя через Gitea Actions путем простановки тега:
```bash
git tag vX.Y.Z && git push origin vX.Y.Z
```
+34
View File
@@ -0,0 +1,34 @@
# Фронтенд: Структура и сборка
## 1. Стек и библиотеки
- **HTML / Django Templates:** шаблоны `base.html`, компоненты `typograph/` и `blog/`.
- **CSS:** Bootstrap 5, Bootstrap Icons, кастомные стили `public/static/css/etpgrf.css` с поддержкой темной/светлой темы.
- **Интерактивность:**
- **HTMX:** асинхронные запросы (отправка формы типографирования, динамическое обновление плашки со статистикой без перезагрузки).
- **Alpine.js:** управление состоянием клиентских виджетов и раскрывающихся списков опций.
- **Редактор текста:** CodeMirror 6.
## 2. Сборка фронтенда и вендорных библиотек (`frontend-assembly/`)
- Каталог `frontend-assembly/` управляет сборкой редактора и подготовкой локальных копий всех сторонних библиотек для автономной работы и CDN-fallback:
- `src/editor.js`: инициализация CodeMirror 6, подсветка спецсимволов (`&nbsp;`, `&shy;`, тире, кавычки), интеграция темной/светлой темы.
- `copy-vendor.js`: копирование дистрибутивов Bootstrap 5, Bootstrap Icons (включая шрифты), HTMX и Alpine.js из `node_modules` в `public/static/vendor/`.
- `package.json`: зависимости `@codemirror/*`, `bootstrap`, `bootstrap-icons`, `htmx.org`, `alpinejs`, `esbuild`.
- Команды сборки:
- `npm run build`: выполняет `build:codemirror` (сборка `editor.js`) и `build:vendor` (копирование всех библиотек в `static/vendor/`).
- `npm run build:codemirror`: компилирует бандл в `public/static/codemirror/editor.js`.
- `npm run build:vendor`: экспортирует вендорные CSS/JS/шрифты в `public/static/vendor/`.
- `npm run watch`: отслеживание изменений CodeMirror в реальном времени.
## 3. CDN Fallback стратегия (`base.html`)
- Основные библиотеки подключаются из публичных CDN (jsDelivr, unpkg) для быстрой доставки и кэширования в браузерах.
- При блокировке или недоступности CDN срабатывает автоматический fallback на локальные статические копии:
- **CSS (Bootstrap, Bootstrap Icons):** атрибут `onerror="this.onerror=null;this.href='{% static ... %}';"` на тегах `<link>`.
- **JS (HTMX, Bootstrap Bundle):** проверка глобального объекта (`window.htmx`, `window.bootstrap`) и подгрузка локальной копии через `document.write`.
- **JS (Alpine.js):** `onerror` динамически подключает локальный deferred-скрипт, а также предусмотрена резервная проверка в `DOMContentLoaded`.
## 4. Клиентская статика (`public/static/`)
- `css/etpgrf.css` — основные стили сайта, оформление типографа и блога.
- `js/base.js` — вспомогательные клиентские скрипты (обработка куки-баннера, копирование текста, переключение тем).
- `codemirror/` — собранный esm-бандл редактора.
- `vendor/` — локальные копии сторонних библиотек (`bootstrap`, `bootstrap-icons`, `htmx`, `alpinejs`).
- `svg/` и `img/` — векторные и растровые логотипы для светлой/темной темы и мета-тегов Open Graph.
+51
View File
@@ -0,0 +1,51 @@
# Архитектурный обзор проекта ETPGRF Site
## 1. Назначение проекта
**ETPGRF Site** — веб-сервис и интерфейс для онлайн-типографирования текстов на базе библиотеки `etpgrf`, а также контентная платформа (блог, справочные и статические страницы, статистика использования).
## 2. Технологический стек
- **Backend:** Python 3.13+, Django 6.0+, Poetry.
- **База данных:** SQLite 3 (файл `data/db-etpgrf.sqlite3` с увеличенным таймаутом блокировки).
- **Frontend:**
- Bootstrap 5 (CSS, сетка, компоненты, иконки bootstrap-icons).
- Alpine.js (декларативное состояние на клиенте).
- HTMX (динамическая подгрузка фрагментов, отправка форм типографирования, статистика).
- CodeMirror 6 (продвинутый редактор текста с подсветкой спецсимволов/сущностей).
- Сборщик фронтенда: `esbuild` в каталоге `frontend-assembly/`.
- **Инфраструктура & Деплой:**
- Docker & Docker Compose (`docker-compose.yml` для разработки, `docker-compose.prod.yml` для продакшена).
- Nginx (раздача статики `/static/` и медиа `/media/`, SSL-терминация, обратное проксирование к Gunicorn).
- Gunicorn (WSGI-сервер Django).
- CI/CD: Gitea Actions (автосборка Docker-образов по тегам `v*` и деплой).
## 3. Структура директорий
```
2026-etpgrf-site/
├── .github/ # Инструкции для AI и CI
│ └── copilot-instructions.md
├── _prj_blueprint/ # Быстрый контекст и документация архитектуры
├── config/ # Конфигурационные файлы Nginx
│ └── nginx/
├── data/ # Хранилище базы данных SQLite (db-etpgrf.sqlite3)
├── etpgrf_site/ # Исходный код Django
│ ├── manage.py
│ ├── etpgrf_site/ # Корневой модуль конфигурации (settings, urls, wsgi)
│ ├── typograph/ # Приложение типографа (обработка, DailyStat, UI)
│ └── blog/ # Приложение блога и статических страниц
├── frontend-assembly/ # Node.js окружение сборки CodeMirror 6 (esbuild)
├── media/ # Загружаемые медиа-файлы (обложки постов)
├── public/ # Статика проекта
│ ├── static/ # Исходная статика (css, js, img, svg, codemirror)
│ └── static_collected/ # Собранная статика collectstatic
├── Dockerfile # Сборка продакшн-образа
├── docker-compose.yml # Dev-окружение
├── docker-compose.prod.yml # Prod-окружение
├── pyproject.toml # Poetry зависимости и метаданные
├── NOTE.md # Инструкции по релизам и версионированию
└── CHANGELOG.md # История версий
```
## 4. Ссылки на детальные описания
- [Бэкенд и логика приложений](backend.md)
- [Фронтенд и сборка](frontend.md)
- [Деплой, окружение и релизный процесс](deployment.md)
+57
View File
@@ -0,0 +1,57 @@
# CI/CD с Gitea Runner
Gitea Runner — это инструмент для выполнения CI/CD задач, интегрированный с Gitea. Он позволяет автоматизировать
процессы сборки, тестирования и развертывания приложений.
В нашем репозии входим в "Настройки" -> "Действия" -> "Ранеры" и создаем новый Runner. Для это получим регистрационный
токен.
## Настройка Gitea Runner на macOS
```shell
docker run -d --restart always \ [±main ●]
-v /var/run/docker.sock:/var/run/docker.sock \
-e GITEA_INSTANCE_URL=https://git.cube2.ru \
-e GITEA_RUNNER_REGISTRATION_TOKEN=здест_полученный_токен \
-e GITEA_RUNNER_REGISTRATION_TOKEN=здесь_вставляем_полученный_токен \
-e GITEA_RUNNER_NAME=mac-mini-runner \
--name gitea-runner \
gitea/act_runner:latest
```
Увидим:
```txt
Unable to find image 'gitea/act_runner:latest' locally
latest: Pulling from gitea/act_runner
6e174226ea69: Pull complete
adcf2c0b73c2: Pull complete
e0c151a1a72f: Pull complete
3333c50851c8: Pull complete
Digest: sha256:0000000000000000000000000000000000000000000000000000000000000000
Status: Downloaded newer image for gitea/act_runner:latest
f000000000000000000000000000000000000000000000000000000000000000
```
## Обновление в продакшен
Наш `.gitea/workflows/docker-publish.yaml` настроен на публикацию Docker образа при создании тега, который начинается
с `v`. Образ собирается на компьютпере разработчика (см. главу Настройка Gitea Runner на macOS) и пакет загружается
в Gitea.
На хостинге работает Docker Stack с нашим проектом. Кроме `etpgrf-site-etpgrf-backend` и `etpgrf-site-etpgrf-nginx`
в нем работает `etpgrf-site-watchtower`, который следит за обновлениями образов на Gitea и если находит обновление, то
получает новый образ и перезапускает контейнер с новым образом.
Т.о. если мы хотим обновить продакшен, нам нужно просто создать новый тег в репозитории:
```shell
git tag v0.1.x
git push origin v0.1.x
```
sudo docker exec -it etpgrf-site-etpgrf-backend-1 python etpgrf_site/manage.py createsuperuser
e-serg
f0b01jLq$eRyID
+31 -13
View File
@@ -6,15 +6,13 @@
# Для первого запуска backend-контейнера, возможно, потребуется временно изменить владельца папки `data` на root
# и раскомментировать соответствующие строки в секции etpgrf-backend (смотри комментарии в коде ниже).
version: '3.8'
# version: '3.8'
services:
# Бэкенд сервис
etpgrf-backend:
# Используем готовый образ из Gitea Registry
image: git.cube2.ru/erjemin/2026-etpgrf-site:latest
# Если нужно, собрать образ из локального Dockerfile, а не скачивать готовый
# build: .
# Перезапускать всегда (если упал или сервер перезагрузился)
restart: always
# Метка для Watchtower, чтобы он обновлял только этот контейнер
@@ -55,7 +53,7 @@ services:
cp /app/etpgrf_site/typograph/templates/500.html /app/public/static_collected/500.html &&
cp /app/etpgrf_site/typograph/templates/404.html /app/public/static_collected/404.html &&
cp /app/etpgrf_site/typograph/templates/typograph/403.html /app/public/static_collected/403.html &&
gunicorn --bind 0.0.0.0:8000 --chdir /app/etpgrf_site etpgrf_site.wsgi"
gunicorn --bind 0.0.0.0:8000 --timeout 300 --workers 2 --chdir /app/etpgrf_site etpgrf_site.wsgi"
volumes:
# База данных (папка data должна быть создана на хосте)
@@ -65,15 +63,30 @@ services:
# Медиа (папка media должна быть создана на хосте)
- ./media:/app/media
# Переменные окружения
env_file:
- .env
# Логирование (Ротация)
logging:
driver: "json-file"
options:
max-size: "10m"
max-file: "3"
# Healthcheck отключен - вместо этого используем depends_on в nginx (service_started)
# Причина: healthcheck с Python-запросом к Django вызывал timeout workers,
# так как требовал полной загрузки Django при каждой проверке.
# See: https://github.com/erjemin/2026-etpgrf-site/issues/XXX
# Лимиты ресурсов (docker compose вне swarm)
deploy:
resources:
limits:
cpus: '0.40'
memory: 360M
# Nginx для отдачи статики и проксирования запросов к бэкенду
etpgrf-nginx:
image: nginx:1.25-alpine
@@ -86,21 +99,25 @@ services:
# Внешний порт. Если у тебя на хосте уже есть Nginx (прокси),
# то можно пробросить на 127.0.0.1:8000 или использовать внутреннюю сеть.
# Но пока оставим так:
ports:
- "127.0.0.1:8080:80" # Используем 8080, чтобы не конфликтовать с Portainer (8000) или основным Nginx (80)
depends_on:
- etpgrf-backend
etpgrf-backend:
condition: service_started
logging:
driver: "json-file"
options:
max-size: "10m"
max-file: "3"
max-size: "5m"
max-file: "2"
# Сервис для автоматического обновления образов из реестра
watchtower:
image: containrrr/watchtower
container_name: etpgrf_watchtower
restart: always
volumes:
- /var/run/docker.sock:/var/run/docker.sock
environment:
@@ -108,13 +125,14 @@ services:
# Берем учетные данные из .env файла
- REPO_USER=${REPO_USER}
- REPO_PASS=${REPO_PASS}
# Ограничиваем область видимости только этим проектом
- WATCHTOWER_REGISTRY_URL=git.cube2.ru
- WATCHTOWER_SCOPE=etpgrf
# Если нужно указать реестр явно (обычно watchtower сам понимает из имени образа)
# - WATCHTOWER_REGISTRY_URL=git.cube2.ru
command: --interval 1800 --cleanup # Проверять каждые 30 минут
restart: always
command: --interval 1800 --cleanup
logging:
driver: "json-file"
options:
max-size: "1m"
max-file: "1"
volumes:
static_volume:
+1 -1
View File
@@ -2,7 +2,7 @@
Основные возможности:
- Веб-интерфейс для ввода текста и настройки параметров типографики.
"""
__version__ = "0.2.7"
__version__ = "0.2.8"
__author__ = "Sergei Erjemin"
__email__ = "erjemin@gmail.com"
__license__ = "MIT"
+12
View File
@@ -1,6 +1,18 @@
from django.contrib.sitemaps import Sitemap
from django.urls import reverse
from .models import Post
class StaticViewSitemap(Sitemap):
"""Карта сайта для статических страниц (главная и др.)."""
priority = 1.0
changefreq = "daily"
def items(self):
return ['index']
def location(self, item):
return reverse(item)
class PostSitemap(Sitemap):
changefreq = "weekly" # Как часто меняются страницы
priority = 0.9 # Приоритет (от 0.0 до 1.0)
+305 -166
View File
@@ -4,175 +4,314 @@
{% block title %}Песочница верстки — ETPGRF{% endblock %}
{% block content %}
<div class="row">
{# Левая колонка: Дата и Картинка #}
<div class="col-lg-2 align-self-start text-end mb-4">
<p class="small align-self-end">
<small class="bg-secondary bg-opacity-10 p-2 text-nowrap">
12.фев.2026
</small>
</p>
<p>
<img src="{% static 'img/etpgrf-logo-for-fb-vk-x.gif' %}" class="w-100" alt="Django Admin" />
</p>
<div class="row align-items-start">
<div class="col border-end">
<h3>Сайт typograph.cube2.ru</h3>
<p>Исходный код сайта онланй-типографа <tt>etpgrf</tt> доступен в&nbsp;нескольких репози&shy;ториях (<a
href="https://github.com/erjemin/etpgrf-site" target="_blank">GitHub</a>, <a
href="https://gitverse.ru/erjemin/etpgrf-site" target="_blank">GitVerse</a> и&nbsp;<a
href="https://git.cube2.ru/erjemin/2026-etpgrf-site" target="_blank">Сube2</a>. Наиболее заметные изменения
сайта онлайн-типографа приводятся ниже в&nbsp;хронологическом порядке. Для&nbsp;полного списка изменений,
включая мелкие фиксы и&nbsp;коммиты, пожалуйста, обратитесь к&nbsp;истории репозитория.</p>
<h4>[0.2.8] - 2026–10–04</h4>
<h5>Добавлено</h5>
<ul>
<li>Локальная статика для&nbsp;внешних фронтенд-библиотек (Bootstrap&nbsp;5, Bootstrap Icons, HTMX, Alpine.js,
CodeMirror&nbsp;6) для&nbsp;работы интер&shy;фейса при&nbsp;недос&shy;тупности CDN.
</li>
<li>Стратегия fallback-подключения в&nbsp;шаблонах: автома&shy;тическое переклю&shy;чение на&nbsp;локальную
статику при&nbsp;сбое или&nbsp;блокировке CDN.
</li>
<li>Скрипт копиро&shy;вания production-ассетов <code>frontend-assembly/copy-vendor.js</code>
и&nbsp;обновление сборки через&nbsp;<code>frontend-assembly/assembly_via_npm.sh</code>.
</li>
<li>Автомати&shy;ческие тесты проверки наличия стати&shy;ческих вендорных ассетов и&nbsp;коррект&shy;ности
ренде&shy;ринга fallback-подключений в&nbsp;<code>typograph/tests.py</code>.
</li>
</ul>
<h5>Изменено</h5>
<ul>
<li>Обновлен и&nbsp;структу&shy;рирован <code>.gitignore</code> с&nbsp;подроб&shy;ными коммен&shy;тариями.</li>
</ul>
<h4>[0.2.7] - 2026–03–22</h4>
<h5>Изменено</h5>
<ul>
<li>Обновление всех пактов, включая <tt>etpgrf</tt> (v0.1.5&nbsp;→&nbsp;v0.1.6.post1).</li>
</ul>
<h4>Исправлено</h4>
<ul>
<li><code>canonical</code> для страниц учитывает https/http.</li>
</ul>
<h4>[0.2.6] - 2026–02–28</h4>
<h5>Изменено</h5>
<ul>
<li>Подключена новая версия библиотеки <tt>etpgrf</tt> (v0.1.4 → v0.1.5).</li>
</ul>
<h4>[0.2.5]&nbsp;— 2026–02–13</h4>
<h5>Добавлено</h5>
<ul>
<li>Редизайн списка постов в&nbsp;блоге: шахматный порядок, вертикальные разделители, улучшенная адаптивность
для&nbsp;мобильных
устройств.
</li>
<li>Поле <code>updated_at</code> (<em>Дата обновления</em>) в&nbsp;модели, админке, блогах, страницах, <tt>sitemaps.xml</tt>
и&nbsp;микро&shy;разметке <tt>Schema.org</tt> для&nbsp;улучшения <abbr
title="Search Engine Optimization / Поисковая оптимизация">SEO</abbr>, <abbr
title="Generative Engine Optimization / Оптимизацию для Генеративных нейросетей и ИИ-поисковиков">GEO</abbr>
и&nbsp;<abbr title="Large Language Model Optimization / Оптимизация под Большие Языковые Модели">LLMO</abbr>.
</li>
<li><tt>README.md</tt> с&nbsp;описанием проекта онлайн-типографа, его особенностей, технического стека и&nbsp;инструкциями
по&nbsp;установке и&nbsp;запуску.
</li>
<li>Отображение заголовков постов в&nbsp;списке админки без&nbsp;HTML-мнемоник (декоди&shy;рование <code>&amp;nbsp;</code>
и&nbsp;др.).
</li>
</ul>
<h5>Изменено</h5>
<ul>
<li>Исправлены ошибки в&nbsp;шаблоне <tt>post_list.html</tt> (и&nbsp;полностью переработан дизайн в&nbsp;целом).
<ul>
<li>Улучшено отображение даты и&nbsp;скрытие декоративных изображений в&nbsp;списке постов на&nbsp;мобильных
устройствах.
</li>
<li>Оптими&shy;зированы отступы и&nbsp;типографика в&nbsp;списке постов.</li>
</ul>
</li>
<li>Формирование <code>slug</code> из&nbsp;<code>title</code> при&nbsp;сохранении&nbsp;поста или страницы с&nbsp;исполь&shy;зованием
библиотеки <code>pytils</code> для&nbsp;трансли&shy;терации с&nbsp;очистикой от&nbsp;HTML-мнемоник и&nbsp;создания
<abbr title="Uniform Resource Locator / Унифицированный Указатель Ресурса">URL</abbr>-дружес&shy;твенных
строк.
</li>
<li>Дизайн и&nbsp;вёрстка страниц для&nbsp;постов блога и&nbsp;вспомо&shy;гательных страниц для&nbsp;мобильных
устройств (адаптивность, скрытие картинки-обложки).
</li>
</ul>
<h4>[0.2.4]&nbsp;— 2026–02–12</h4>
<h5>Добавлено</h5>
<ul>
<li>Микро&shy;разметка <code>Schema.org</code> (JSON-LD) для&nbsp;постов и&nbsp;страниц для&nbsp;улучшения
SEO и&nbsp;понимания контента поисковиками и&nbsp;ИИ.
</li>
<li>Файл <code>llms.txt</code> для&nbsp;предоста&shy;вления информации о&nbsp;сайте и&nbsp;API для&nbsp;больших
языковых моделей (<abbr title="Large Language Model">LLM</abbr>) в&nbsp;соответвиии со&nbsp;стандартом GEO
и&nbsp;LLMO.
</li>
<li>Кастомный фильтр <code>unescape</code> для&nbsp;очистки мета-тегов от&nbsp;HTML-сущностей и&nbsp;переводов
строк.
</li>
</ul>
<h5>Исправлено</h5>
<ul>
<li>Исправлена ошибка, при&nbsp;которой счетчик символов не&nbsp;обновлялся при&nbsp;восста&shy;новлении&nbsp;вкладки
из&nbsp;истории браузера.
</li>
<li>Исправлена ошибка экрани&shy;рования кавычек в&nbsp;<tt>JSON-LD</tt>, <tt>Title</tt>
и&nbsp;<tt>Description</tt>.
</li>
<li>В&nbsp;<code>docker-compose.yaml</code> додавлен перезапуск <code>watchtower</code> при&nbsp;его
остановке.
</li>
</ul>
<h4>[0.2.3]&nbsp;— 2026–02–11</h4>
<h5>Изменено</h5>
<ul>
<li>Добавлена кнопка очистки текста во&nbsp;вводном поле и&nbsp;счетчик вводимых символов.</li>
</ul>
<h4>[0.2.2]&nbsp;— 2026–02–03</h4>
<h5>Изменено</h5>
<ul>
<li>В&nbsp;онлайн-типографе подключена новая версия библиотеки <tt>etpgrf</tt> (v0.1.3 → v0.1.4).</li>
<li>Незначи&shy;тельные улучшения в&nbsp;оформлении.</li>
</ul>
<h4>v0.2.1&nbsp;— 2026–01–30</h4>
<h5>Исправлено</h5>
<ul>
<li>Исправление ошибок при&nbsp;формировании&nbsp;мета-тегов, картинок, <code>alt</code> под&nbsp;картинками
и&nbsp;т.&thinsp;п.
</li>
<li>Исправлена ошибка в&nbsp;настройках nginx внутри docker-контейнера возникавшая при&nbsp;отдаче
media-файлов.
</li>
</ul>
<h5>Изменено</h5>
<ul>
<li>При&nbsp;создании&nbsp;записи в&nbsp;блог или страницы «тизер» обязателен!</li>
</ul>
<h4>v0.2.0&nbsp;— 2026–01–28</h4>
<h5>Добавлено</h5>
<ul>
<li>Приложение blog (для&nbsp;страниц и&nbsp;постов) и&nbsp;соответ&shy;ствующие изменения в&nbsp;моделях базы,
добавление новых view и&nbsp;шаблонов.
</li>
<li>Песочница (шаблон <code>blog/templates/blog/tmp.html</code> для&nbsp;тестирования верстки (доступен только в&nbsp;режиме
debug).
</li>
<li>Динамическое создание sitemap.xml</li>
<li>robots.txt</li>
<li>Изменения в&nbsp;шапке сайта (меню и&nbsp;бургер)</li>
</ul>
<h5>Изменено</h5>
<ul>
<li>Спрятан <code>url</code> админки типографа. Его расположение теперь задается через&nbsp;переменные окружения
в&nbsp;<code>.env</code>.
</li>
<li><code>favicon.ico</code> оптими&shy;зирована для&nbsp;Яндекс (120х120px).</li>
<li>Исправлено поведение шапки и&nbsp;логотива для&nbsp;мобильных устройств.</li>
</ul>
<h4>v0.1.8&nbsp;— 2026–01–23</h4>
Коммит:
846c066
<h4>v0.1.7&nbsp;— 2026–01–23</h4>
Коммит:
d74bee2
<h4>v0.1.6&nbsp;— 2026–01–23</h4>
Коммит:
6b4dbaf
<h4>v0.1.5&nbsp;— 2026–01–21</h4>
Коммит:
78174a8
<h4>v0.1.4&nbsp;— 2026–01–20</h4>
Коммит:
2d09aef
<h4>v0.1.3&nbsp;— 2026–01–19</h4>
Коммит:
66f2228
<h4>v0.1.2&nbsp;— 2026–01–18</h4>
Коммит:
92711f5
<h4>v0.1.1&nbsp;— 2026–01–16</h4>v0.1.1
Коммит:
5d5d48d
<h4>v0.1.0&nbsp;— 2026–01–16</h4>
Коммит:
3a7bb29
</div>
<div class="col border-start">
<h3>Библиотека etpgrf</h3>
<p>
Исходный код etpgrf-типографа доступен в&nbsp;нескольких репози&shy;ториях (<a
href="https://github.com/erjemin/etpgrf" target="_blank">GitHub</a>, <a
href="https://gitverse.ru/erjemin/etpgrf" target="_blank">GitVerse</a>, <a
href="https://git.cube2.ru/erjemin/2025-etpgrf" target="_blank">Сube2</a>, и&nbsp;<a
href="https://pypi.org/project/etpgrf/" target="_blank">PyPI</a>), распрос&shy;траняется под&nbsp;лицензией <a
href="https://opensource.org/licenses/MIT" target="_blank">MIT</a>, может быть установлен локально, на&nbsp;ваш
сайт или&nbsp;интегри&shy;рован в&nbsp;ваши проекты как&nbsp;Python-библиотека.</p>
{# Правая колонка: Контент #}
<div class="col-lg-10 border-start ps-lg-4 post-page-content">
<h1>Массовая типографика контента в&nbsp;Django: пользова&shy;тельские команды управления (Custom Management Commands)</h1>
<div class="lead bg-secondary bg-opacity-10 p-3 rounded">
<p>Если вы&nbsp;работали с&nbsp;Django, вы&nbsp;наверняка использовали команду <code>manage.py</code> сотни раз: <code>python manage.py runserver</code>, <code>migrate</code>, <code>createsuperuser</code>.</p>
<p>Но&nbsp;знаете&nbsp;ли вы, что можете легко создавать <strong>свои собственные</strong> команды? Это один из&nbsp;самых мощных и&nbsp;недоо&shy;цененных инструментов Django для&nbsp;автома&shy;тизации рутины. В&nbsp;этом посте я&nbsp;расскажу, что такое <strong>Management Command</strong>, зачем она нужна и&nbsp;как&nbsp;её использовать на&nbsp;примере реальной задачи: массовой типографики контента в&nbsp;базе данных.</p>
</div>
<hr>
<div class="post-content mt-4">
<h2>Что это такое?</h2>
<p><strong>Management Command</strong>&nbsp;— это обычный Python-скрипт, который «встраивается» в&nbsp;экосистему Django. Он&nbsp;имеет доступ к&nbsp;моделям, настройкам (settings.py) и&nbsp;базе данных, но&nbsp;запускается из&nbsp;консоли через&nbsp;<code>python manage.py ...</code>.</p>
<h2>Зачем это нужно?</h2>
<p>Представьте ситуации:</p>
<ul>
<li>Нужно пересчитать рейтинг для&nbsp;десятки тысяч товаров на&nbsp;сайте или сделать типографику всех публикаций после подключения etpgrf-типографа (или любого другого).</li>
<li>Необходимо обновить цены для&nbsp;всех товарных карточек в&nbsp;соответствии с&nbsp;таблицей excel или по&nbsp;API (или спарсить данные с&nbsp;внешнего сайта).</li>
<li>Нужно отправить e-mail рассылку пользо&shy;вателям.</li>
<li>Нужно пометить комментарии или публикации как&nbsp;архивные в&nbsp;соответствии с&nbsp;правилом или почистить базу от&nbsp;старых логов.</li>
</ul>
<p>Делать это через&nbsp;<tt>views.py</tt> (views) — плохая идея (страница может отвалиться по&nbsp;тайм-ауту). Писать отделный скрипт рядом <tt>manage.py</tt>&nbsp;— неудобно (нужно вручную настраивать `DJANGO_SETTINGS_MODULE`). Встроенные команды решают эти проблемы элегантно.</p>
<h2>Как&nbsp;это работает?</h2>
<p>Django использует систему «автообна&shy;ружения» (auto-discovery). Чтобы ваша команда появилась в&nbsp;списке `manage.py`, нужно соблюсти строгую иерархию папок внутри вашего приложения (например, <tt>web</tt>):</p>
<pre class="border p-3 my-3 rounded bg-secondary bg-opacity-25">web/
├── __init__.py
├── models.py
└── management/ <-- 1. Создаем папку management
├── __init__.py
└── nginx/
├── commands/ <-- 2. Внутри неё папку commands
├── __init__.py
└── my_cool_script.py <-- 3. Наш файл с командой</pre>
<p>Файл <tt>my_cool_script.py</tt> автома&shy;тически превратится в&nbsp;команду: <code>python manage.py my_cool_script</code>. Django будет искать его в&nbsp;папках <tt>management/commands/</tt> внутри каждого устано&shy;вленного приложения. Это позволяет легко организовать код и&nbsp;держать все «команды обслуживания» в&nbsp;одном месте.</p>
<p><strong>Для&nbsp;справки:</strong> Механизм Custom Management Commands появился еще в&nbsp;Django&nbsp;0.96 (в&nbsp;глубокой древности) и&nbsp;с&nbsp;тех пор является стандартом де-факто для&nbsp;написания скриптов обслуживания.</p>
<h2>Анатомия команды</h2>
<p>Вот пример простейшей команды. Мы&nbsp;наследуемся от&nbsp;класса <code>BaseCommand</code> и&nbsp;переопре&shy;деляем метод <code>handle</code>:</p>
<pre class="border p-3 my-3 rounded bg-secondary bg-opacity-25">
# web/management/commands/hello.py
from django.core.management.base import BaseCommand
class Command(BaseCommand):
help = 'Выводит приветствие' # Описание для --help
def add_arguments(self, parser):
# Можно добавлять аргументы, как в argparse
parser.add_argument('name', type=str, help='Имя пользователя')
def handle(self, *args, **options):
# Главная логика
name = options['name']
self.stdout.write(f"Привет, {name}!")</pre>
<p>Запуск:</p>
<pre class="border p-3 my-3 rounded bg-secondary bg-opacity-25">
python manage.py hello Иван</pre>
<p>Увидим в&nbsp;консоли:</p>
<pre class="border p-3 my-3 rounded bg-secondary bg-opacity-25">
Привет, Иван!</pre>
<h2>Реальный пример: Массовая типографика через&nbsp;etpgrf</h2>
<p>В&nbsp;моём проекте, <a href="https://dq.cube2.ru/" target="_blank">DQ&nbsp;– коллекция цитат: место для&nbsp;вдумчивого чтения</a>, контент был частично обработан с&nbsp;помощью Типографа Муравьёа, частично вручную. И&nbsp;вот я&nbsp;установил и&nbsp;настроил etpgrf (тем более что Типограф Муравьёва «почил в&nbsp;бозе», да&nbsp;и&nbsp;до&nbsp;того не&nbsp;обновлялся с&nbsp;2018 года). Все новые цитаты типогра&shy;фируются через&nbsp;etpgrf, но&nbsp;что делать со&nbsp;старыми? Их&nbsp;сотни, и&nbsp;открывать и&nbsp;«пересо&shy;хранаять» каждую вручную&nbsp;— это адский труд. Вот тут на&nbsp;помощь и&nbsp;приходит Custom Management Command.</p>
<p>Вот как&nbsp;я&nbsp;это реализовал. В&nbsp;<tt>web/management/commands/reprocess_typography.py</tt>:</p>
<pre class="border p-3 my-3 rounded bg-secondary bg-opacity-25">
from django.core.management.base import BaseCommand
from web.models import TbDictumAndQuotes
# Импорты библиотеки etpgrf
from etpgrf.typograph import Typographer
from etpgrf.sanitizer import SanitizerProcessor
# ... другие процессоры, если нужно ...
class Command(BaseCommand):
help = 'Переобрабатывает все цитаты'
def add_arguments(self, parser):
# Добавляем флаг "сухой прогон"
parser.add_argument(
'--dry-run',
action='store_true',
help='Запустить без сохранения изменений',
)
# Ограничение количества
parser.add_argument('--limit', type=int, help='Сколько записей обработать')
# Смещение (для пагинации)
parser.add_argument('--offset', type=int, default=0, help='Сколько пропустить')
def handle(self, *args, **options):
# 1. Настраиваем типограф
# ... инициализация процессоров ...
settings = {
# ...
'sanitizer': SanitizerProcessor(mode="html"), # Режим HTML-очистки
'hanging_punctuation': 'left', # Режим висячей пунктуации
# ...
}
typographer = Typographer(**settings)
# 2. Получаем записи из базы с учетом limit/offset
qs = TbDictumAndQuotes.objects.all().order_by('id')
start = options['offset']
if options['limit']:
qs = qs[start : start + options['limit']]
else:
qs = qs[start:]
self.stdout.write(f"Найдено {qs.count()} цитат...")
# 3. Бежим по циклу с прогресс-баром (tqdm если есть)
try:
from tqdm import tqdm
iterator = tqdm(qs)
except ImportError:
iterator = qs
for dq in iterator:
try:
# Обрабатываем текст
new_html = typographer.process(dq.szContent)
if options['dry_run']:
self.stdout.write(f"[{dq.id}] Предпросмотр: {new_html[:50]}...")
else:
dq.szContentHTML = new_html
dq.save(update_fields=['szContentHTML'])
except Exception as e:
self.stdout.write(self.style.ERROR(f"Ошибка id={dq.id}: {e}"))
self.stdout.write(self.style.SUCCESS(f"\nГотово!"))</pre>
<p>Возможно вы&nbsp;заметили, что в&nbsp;моем проекте для&nbsp;контента есть два поля: <code>szContent</code> и&nbsp;<code>szContentHTML</code>. В&nbsp;первом хранится «сырой» текст, во&nbsp;втором&nbsp;— результат типогра&shy;фирования. В&nbsp;вашем проекте, скорее всего, только одно поле для&nbsp;контента, но&nbsp;по&nbsp;сути это ничего не&nbsp;меняет.</p>
<p>Еще интересные фишки, которые исполь&shy;зовались при&nbsp;типогра&shy;фировании:</p>
<ol>
<li><code>self.stdout.write</code> вместо <code>print</code>&nbsp;– позволяет Django перехва&shy;тывать вывод (например, для&nbsp;тестов) и&nbsp;корректно работать с&nbsp;кодировками.</li>
<li><code>self.style.SUCCESS</code> и&nbsp;<code>self.style.ERROR</code>&nbsp;– раскрашивает текст в&nbsp;консоли (зеленый/красный) и&nbsp;это очень удобно для&nbsp;визуального восприятия логов.</li>
<li>Аргумент <tt>--dry-run</tt>&nbsp;— позволяют безопасно тестировать скрипт на&nbsp;продакшене перед&nbsp;тем, как&nbsp;реально менять данные.</li>
<li>Аргументы <tt>--limit</tt> и&nbsp;<tt>--offset</tt>&nbsp;— позволяют обрабатывать базу «порциями», что полезно для&nbsp;больших объемов данных (можно запустить несколько процессов параллельно с&nbsp;разными <tt>offset</tt>).</li>
<li>Используется <code>update_fields</code>&nbsp;— позволяет переза&shy;писывать не&nbsp;всю модель целиком (что могло&nbsp;бы затереть изменения, сделанные кем-то&nbsp;другим в&nbsp;ту&nbsp;же секунду), а&nbsp;обновляем только конкретные поля.</li>
</ol>
<p>Теперь, чтобы типогра&shy;фировать весь контент, нам достаточно одной строку в&nbsp;терминале, и&nbsp;Django сделает всю грязную работу за&nbsp;нас (не&nbsp;забудьте инициировать виртуальное окружение вашего проекта).</p>
<p>Тестовый прогон (безопасно, ничего не&nbsp;сохраняет):</p>
<pre class="border p-3 my-3 rounded bg-secondary bg-opacity-25">
python manage.py reprocess_typography --dry-run</pre>
<p>Боевой запуск, с&nbsp;изменениями данные в&nbsp;базе:</p>
<pre class="border p-3 my-3 rounded bg-secondary bg-opacity-25">
python manage.py reprocess_typography</pre>
<p>Если у&nbsp;вас очень много записей, можно запускать по&nbsp;частям:</p>
<pre class="border p-3 my-3 rounded bg-secondary bg-opacity-25">
python manage.py reprocess_typography --limit 1000 --offset 0
python manage.py reprocess_typography --limit 1000 --offset 1000
python manage.py reprocess_typography --limit 1000 --offset 2000</pre>
<h4>[0.1.6.post1] - 2026–03–19</h4>
<h5>Изменено</h5>
<ul>
<li>Новый алгоритм «висячей пунктуации» (<em>HangingPunctuationProcessor</em>). Добавлены компенси­рующие
пробелы для висячих символов, чтобы избежать наложения на соседние слова. Теперь «висячие символы» (кавычки,
скобки и т. п.) обора­чиваются в <code>&lt;span&gt;</code> вместе с ближайшим словом и пробелом, что
обеспечивает отсутствие визуальных смещений внутри строки. Режим <code>both</code> (для одновре­менного
вывешивания в обе стороны) отключен из-за потенци­альных конфликтов компенси­рующих пробелов и проблем
с&nbsp;выравни&shy;ванием при&nbsp;исполь&shy;зовании&nbsp;CSS <code>text-justify</code>.</li>
</ul>
<h4>Исправлено</h4>
<ul>
<li>Автоматическая замена символов <code>x</code>, <code>X</code>, <code>х</code>, <code>Х</code>, стоящих между
числами, на&nbsp;знак умножения&nbsp;<code>×</code>, чтобы выражения вида <code>100x100</code> или&nbsp;<code>100&nbsp;х&nbsp;100</code>
корректно обрабатывались и&nbsp;выглядели типографски правильными (<code>100×100</code> или&nbsp;<code>100&amp;nbsp;×&amp;nbsp;100</code>).
</li>
</ul>
<h4>[0.1.5] - 2026–02–27</h4>
<h5>Исправлено</h5>
<ul>
<li>Исправлена ошибка, из-за которой <code>&amp;amp;</code> в&nbsp;исходном тексте некорректно преобразовывался
в&nbsp;<code>&amp;</code>. Теперь <code>&amp;amp;</code>; и&nbsp;его маскирование (<code>&amp;amp;amp;</code>,
<code>&amp;amp;lt;</code>&nbsp;и&nbsp;т.&thinsp;д.) сохраняются в&nbsp;итоговом HTML.
</li>
<li>Исправлена (частично) расстановка неразрывных пробелов <code>&amp;nbsp;</code> на&nbsp;границах закрывающих
тегов (например, <code>&lt;b&gt;Текст&lt;/b&gt; — слово</code> теперь корректно обрабатывается, в <code>&lt;b&gt;Текст&lt;/b&gt;&amp;nbsp;—
слово)</code>.
</li>
</ul>
<h4>[0.1.4] - 2026–02–03</h4>
<h5>Изменено</h5>
<ul>
<li><b>Архите&shy;ктурное улучшение:</b> Полностью переработан механизм обработки HTML.</li>
<li>Внедрены <b>маркеры границ узлов</b> (<code>\uFFFF</code>) при&nbsp;сборке текста. Это позволяет корректно
восста&shy;навливать структуру HTML даже если длина текста изменилась в&nbsp;процессе обработки (например, при&nbsp;удалении&nbsp;лишних
пробелов).
</li>
<li>Внедрены <b>плейсхолдеры</b> (<code>\uFFFC</code>) для&nbsp;защищенных тегов (<code>&lt;code&gt;</code>,
<code>&lt;script&gt;</code> и&nbsp;др.). Теперь содержимое этих тегов физически изолируется перед&nbsp;обработкой,
что предот&shy;вращает «протекание» контекста (например, склеивание слов, разделенных кодом).
</li>
</ul>
<h5>Исправлено</h5>
<ul>
<li>Исправлена ошибка смещения текста при&nbsp;наличии спецсимволов (мнемоник) или при&nbsp;изменении&nbsp;длины
строки.
</li>
<li>Исправлена обработка кавычек, стоящих вплотную к&nbsp;границам тегов (например, <code>"&lt;b&gt;Текст&lt;/b&gt;"</code>).
</li>
</ul>
<h4>v0.1.3&nbsp;— 2026–01–11</h4>
<h5>Исправлено</h5>
<ul>
<li>Исправлена проблема с&nbsp;появлением лишних тегов <code>&lt;html&gt;</code>
и&nbsp;<code>&lt;body&gt;</code> при&nbsp;обработке фрагментов HTML (когда исполь&shy;зуется парсер
<code>lxml</code>). Теперь типограф автома&shy;тически определяет, был&nbsp;ли на&nbsp;входе полноценный
документ или&nbsp;фрагмент, и&nbsp;возвращает соответ&shy;ствующий результат.
</li>
</ul>
<h4>v0.1.2&nbsp;— 2025–12–27</h4>
<h5>Исправлено</h5>
<ul>
<li><strong>Критическое исправление:</strong> Добавлена отсут&shy;ствующая зависимость <code>regex</code> в&nbsp;<code>pyproject.toml</code>.
Без&nbsp;неё библиотека падала при&nbsp;импорте.
</li>
</ul>
<h4>v0.1.1&nbsp;— 2025–12–23</h4>
<h5>Добавлено</h5>
<ul>
<li>Ссылки на&nbsp;зеркала репозитория (GitVerse, Gitea) в&nbsp;<code>pyproject.toml</code> и&nbsp;<code>README.md</code>.
</li>
<li>Раздел Credits в&nbsp;документации.</li>
</ul>
<h4>v0.1.0&nbsp;— 2025–12–23</h4>
<h5>Добавлено</h5>
<ul>
<li>Первый публичный релиз библиотеки <code>etpgrf</code>.</li>
<li>
Основные модули:
<ul>
<li><code>Typographer</code>: основной класс-оркестратор.</li>
<li><code>Hyphenator</code>: расстановка мягких переносов (алгоритм Ляна-Кнута).</li>
<li><code>QuotesProcessor</code>: замена кавычек («ёлочки», „лапки“).</li>
<li><code>Unbreakables</code>: неразрывные пробелы для&nbsp;предлогов, союзов и&nbsp;частиц.</li>
<li><code>LayoutProcessor</code>: типографика тире, инициалов, акронимов, единиц измерения, устойчивых
сокращений (постпо&shy;зиционных и&nbsp;препози&shy;ционных).</li>
<li><code>SymbolsProcessor</code>: псевдо&shy;графика (тире, стрелочки, копирайт и&nbsp;т.&thinsp;п.)</li>
<li><code>HangingPunctuationProcessor</code>: висячая пунктуация.</li>
<li><code>SanitizerProcessor</code>: очистка HTML перед&nbsp;обработкой.</li>
</ul>
</li>
<li>Поддержка русского, русского дорефо&shy;рменного и&nbsp;английского языков.</li>
<li>Поддержка обработки HTML (через&nbsp;BeautifulSoup).</li>
</ul>
</div>
</div>
{% endblock %}
+2 -1
View File
@@ -4,10 +4,11 @@ from django.conf import settings
from django.conf.urls.static import static
from django.contrib.sitemaps.views import sitemap # Импортируем view для sitemap
from blog import views as blog_views
from blog.sitemaps import PostSitemap # Импортируем наш класс Sitemap
from blog.sitemaps import PostSitemap, StaticViewSitemap # Импортируем классы Sitemap
# Словарь с картами сайта
sitemaps = {
'static': StaticViewSitemap,
'posts': PostSitemap,
}
@@ -3,25 +3,25 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
{# SEO & Meta Tags #}<title>{% block title %}ETPGRF — единая типографика для веба{% endblock %}</title>
<meta name="description" content="{% block description %}Бесплатный онлайн-типограф для подготовки текстов к публикации в вебе. Расставка неразрывных пробелов, правильных кавычек («ёлочки»), тире, спецсимволы, отбивка, компоновка, висячая пунктуация. Идеально для верстки сайтов, статей и постов.{% endblock %}">
<meta name="keywords" content="{% block keywords %}типограф, типографика, онлайн типограф, подготовка текста для веба, html типограф, неразрывные пробелы, кавычки елочки, длинное тире, очистка текста от мусора, интернет верстка, муравьев{% endblock %}">
{# SEO & Meta Tags #}<title>{% block title %}Онлайн-типограф для текста и HTML — ETPGRF{% endblock %}</title>
<meta name="description" content="{% block description %}Онлайн-типограф для подготовки HTML и публикаций на русском и английском: кавычки «ёлочки» и “лапки”, длинное тире, неразрывные пробелы (&amp;nbsp;), отбивка предлогов, артиклей и чисел, висячая пунктуация…{% endblock %}">
<meta name="keywords" content="{% block keywords %}онлайн типограф, типографика онлайн, типограф для текста, html типограф, неразрывные пробелы, кавычки елочки, длинное тире, подготовка текста для веба, висячая пунктуация, python etpgrf, типограф лебедева муравьева{% endblock %}">
<meta name="author" content="Sergei Erjemin">
{# Schema.org (JSON-LD) #}{% block schema %}{% endblock %}
{# Open Graph (Facebook, VK, LinkedIn, Telegram) #}<meta property="og:type" content="website" />
<meta property="og:site_name" content="ETPGRF" />
<meta property="og:url" content="{{ request.build_absolute_uri }}" />
<meta property="og:title" content="{% block og_title %}ETPGRF — единая типографика для веба{% endblock %}" />
<meta property="og:description" content="{% block og_description %}Сделайте ваш текст профессиональным и готовым к публикации в интернете за один клик. Умная типографика для веб-дизайнеров, редакторов и контент-менеджеров.{% endblock %}" />
<meta property="og:url" content="{% block og_url %}{{ request.scheme }}://{{ request.get_host }}{{ request.path }}{% endblock %}" />
<meta property="og:title" content="{% block og_title %}Онлайн-типограф для текста и HTML — ETPGRF{% endblock %}" />
<meta property="og:description" content="{% block og_description %}Бесплатный онлайн-типограф для подготовки текстов и HTML к публикации: кавычки «ёлочки», неразрывные пробелы, длинное тире и висячая пунктуация.{% endblock %}" />
<meta property="og:image" content="{% block og_image %}{{ request.scheme }}://{{ request.get_host }}{% static 'img/etpgrf-logo-for-fb-vk-x.gif' %}{% endblock %}" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
{# --- Twitter Cards (X) --- #}<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="{% block twitter_title %}ETPGRF — единая типографика для веба{% endblock %}" />
<meta name="twitter:description" content="{% block twitter_description %}Сделайте ваш текст профессиональным и готовым к публикации в интернете за один клик.{% endblock %}" />
<meta name="twitter:title" content="{% block twitter_title %}Онлайн-типограф для текста и HTML — ETPGRF{% endblock %}" />
<meta name="twitter:description" content="{% block twitter_description %}Бесплатный онлайн-типограф для подготовки текстов и HTML к публикации в вебе.{% endblock %}" />
<meta name="twitter:image" content="{% block twitter_image %}{{ request.scheme }}://{{ request.get_host }}{% static 'img/etpgrf-logo-for-fb-vk-x.gif' %}{% endblock %}" />
{# Шутка #}<meta name="generator" content="Microsoft FrontPage 1.0"/>
{# Canonical #}<link rel="canonical" href="{{ request.build_absolute_uri }}"/>
{# Canonical #}<link rel="canonical" href="{% block canonical %}{{ request.scheme }}://{{ request.get_host }}{{ request.path }}{% endblock %}"/>
{# Favicons #}<link rel="icon" href="{{ request.scheme }}://{{ request.get_host }}{% static 'favicon.ico' %}" type="image/x-icon" />
{# Favicons #}<link rel="icon" type="image/png" href="{% static 'favicon-96x96.png' %}" />
{# Favicons #}<link rel="icon" href="{% static 'favicon-light.svg' %}" type="image/svg+xml" media="(prefers-color-scheme: light)" />
@@ -29,8 +29,9 @@
{# Favicons #}<link rel="icon" type="image/svg+xml" href="{% static 'favicon.svg' %}" />
{# Favicons #}<link rel="apple-touch-icon" sizes="180x180" href="{% static 'apple-touch-icon.png' %}" />
{# Favicons #}<link rel="manifest" href="{% static 'site.webmanifest' %}" />
{# Bootstrap 5 CSS #}<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet"/>
{# Bootstrap Icons #}<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.3/font/bootstrap-icons.min.css"/>
{# Для ИИ #}<link rel="help" type="text/markdown" href="/llms.txt"/>
{# Bootstrap 5 CSS #}<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet" onerror="this.onerror=null;this.href='{% static 'vendor/bootstrap/bootstrap.min.css' %}';"/>
{# Bootstrap Icons #}<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.3/font/bootstrap-icons.min.css" onerror="this.onerror=null;this.href='{% static 'vendor/bootstrap-icons/bootstrap-icons.min.css' %}';"/>
<style>
:root {
--bg-image-text: url("{% static 'svg/logo-etpgrf-site-light-txt.svg' %}");
@@ -45,8 +46,18 @@
}
</style>
{# Custom CSS #}<link href="{% static 'css/etpgrf.css' %}" rel="stylesheet"/>
{# HTMX #}<script src="https://unpkg.com/htmx.org@1.9.10"></script>
{# Alpine.js #}<script defer src="https://cdn.jsdelivr.net/npm/alpinejs@3.x.x/dist/cdn.min.js"></script>
{# HTMX #}<script src="https://unpkg.com/htmx.org@1.9.12"></script>
<script>window.htmx || document.write('<script src="{% static "vendor/htmx/htmx.min.js" %}"><\/script>')</script>
{# Alpine.js #}<script defer src="https://cdn.jsdelivr.net/npm/alpinejs@3.14.8/dist/cdn.min.js" onerror="this.onerror=null;var s=document.createElement('script');s.defer=true;s.src='{% static 'vendor/alpinejs/cdn.min.js' %}';document.head.appendChild(s);"></script>
<script>
document.addEventListener('DOMContentLoaded', function() {
if (!window.Alpine) {
var s = document.createElement('script');
s.src = "{% static 'vendor/alpinejs/cdn.min.js' %}";
document.head.appendChild(s);
}
});
</script>
</head>
<body>
@@ -83,7 +94,7 @@
<div class="container d-flex justify-content-between align-items-center">
<span class="text-muted small nowrap me-2">&copy; Sergei Erjemin, 2025&ndash;{% now 'Y' %}.</span>
<nobr class="text-muted small mx-2">
<i class="bi bi-tags me-1" title="Версия библиотеки etpgrf / Версия сайта"></i><a href="/changelog">v0.1.6.post1 / v0.2.7</a>
<i class="bi bi-tags me-1" title="Версия библиотеки etpgrf / Версия сайта"></i><a href="/changelog">v0.1.6.post1 / v0.2.8</a>
</nobr>
{# Сводная статистика (HTMX) #}<span class="text-muted small ms-2" hx-get="{% url 'stats_summary' %}" hx-trigger="load">
...
@@ -105,7 +116,8 @@
</div>
</div>
{# Bootstrap JS #}<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
{# Bootstrap JS #}<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js"></script>
<script>window.bootstrap || document.write('<script src="{% static "vendor/bootstrap/bootstrap.bundle.min.js" %}"><\/script>')</script>
{# Custom JS #}<script src="{% static 'js/base.js' %}" defer></script>
{% block scripts %}{% endblock %}
</body>
@@ -1,11 +1,11 @@
{% extends 'typograph/base.html' %}
{% load static %}
{% block title %}ETPGRF — единая типографика для веба{% endblock %}
{% block title %}Онлайн-типограф для текста и HTML — ETPGRF: кавычки «ёлочки», тире, неразрывные пробелы{% endblock %}
{% block description %}Бесплатный онлайн-типограф для подготовки текстов к публикации в вебе. Расставка неразрывных пробелов, правильных кавычек («ёлочки»), тире, спецсимволы, отбивка, компоновка, висячая пунктуация. Идеально для верстки сайтов, статей и постов.{% endblock %}
{% block og_title %}Онлайн-типограф для текста и HTML — ETPGRF{% endblock %}
{% block keywords %}типограф, типографика, онлайн типограф, подготовка текста для веба, html типограф, неразрывные пробелы, кавычки елочки, длинное тире, очистка текста от мусора, интернет верстка, муравьев{% endblock %}
{% block og_description %}Бесплатный умный онлайн-типограф для подготовки текстов, статей и верстки к публикации в вебе за один клик.{% endblock %}
{% block content %}
<div class="row">
@@ -13,7 +13,7 @@
{# SEO-текст и описание #}
<div class="mb-4">
<h1 class="h3 mb-3">Онлайн-типограф для веба</h1>
<h1 class="h3 mb-3">Онлайн-типограф для текста и веб-публикаций</h1>
<p>
Интернет-типограф <strong>etpgrf</strong>&nbsp;— инструмент для&nbsp;подготовки текста для&nbsp;публикации
в&nbsp;вебе. Расстановка неразрывных пробелов перед&nbsp;союзами и&nbsp;предлогами, замена кавычек
@@ -298,6 +298,192 @@
<div id="cm-result-wrapper" class="result-box p-0"></div>
<div id="result-area" style="display: none;"></div>
</div>
{# ИНФОРМАЦИОННЫЙ И SEO-БЛОК #}
<div class="col-md-12 mt-4 pt-3 border-top">
<div class="text-center mb-3">
<button class="btn btn-sm btn-outline-secondary rounded-pill px-3 py-1 shadow-sm collapse-toggle-btn collapsed"
type="button"
data-bs-toggle="collapse"
data-bs-target="#seoDetailsCollapse"
aria-expanded="false"
aria-controls="seoDetailsCollapse">
<i class="bi bi-info-circle me-1"></i> О&nbsp;сервисе, возможности и&nbsp;правила
<i class="bi bi-chevron-down ms-1 collapse-icon"></i>
</button>
</div>
<div class="collapse" id="seoDetailsCollapse">
<section class="mb-5 pt-3">
<h2 class="h4 mb-4">Возможности онлайн-типографа etpgrf</h2>
<div class="row g-4">
<div class="col-md-6 col-lg-4">
<div class="p-3 border rounded bg-body-tertiary h-100 feature-card">
<h3 class="h6 fw-bold"><i class="bi bi-distribute-horizontal me-1"></i> Неразрывные пробелы (&amp;nbsp;)</h3>
<p class="small text-muted mb-0">
Автоматическая привязка предлогов, союзов, частиц (&laquo;в&raquo;, &laquo;на&raquo;, &laquo;с&raquo;, &laquo;и&raquo;, &laquo;не&raquo;, &laquo;бы&raquo;…) и&nbsp;артиклей (&bdquo;the&ldquo;, &bdquo;a&ldquo;, &bdquo;is&ldquo;…). Парсер &laquo;видит&raquo; и&nbsp;связывает их&nbsp;со&nbsp;словами даже сквозь кавычки и&nbsp;скобки (например, <code>и&amp;nbsp;&laquo;Беда&raquo; села на&nbsp;мель</code>).
</p>
</div>
</div>
<div class="col-md-6 col-lg-4">
<div class="p-3 border rounded bg-body-tertiary h-100 feature-card">
<h3 class="h6 fw-bold"><i class="bi bi-quote me-1"></i> Кавычки «ёлочки» и&nbsp;„лапки“</h3>
<p class="small text-muted mb-0">
Замена машинных прямых кавычек (<code>&quot;</code>) на&nbsp;правильные русские &laquo;ёлочки&raquo; и&nbsp;французские &bdquo;лапки&ldquo; для&nbsp;вложенных цитат. Поддержка английской, современной русской и&nbsp;русской дореформенной типографики (&laquo;безъ&raquo;, &laquo;въ&raquo;, &laquo;надъ&raquo;, &laquo;сiя&raquo;…).
</p>
</div>
</div>
<div class="col-md-6 col-lg-4">
<div class="p-3 border rounded bg-body-tertiary h-100 feature-card">
<h3 class="h6 fw-bold"><i class="bi bi-dash-lg me-1"></i> Тире, числа и&nbsp;диапазоны</h3>
<p class="small text-muted mb-0">
Замена дефисов на&nbsp;длинное тире (&mdash;) с&nbsp;языковой отбивкой, среднее тире (&ndash;) в&nbsp;числовых интервалах (1941&ndash;1945, 10&ndash;20&nbsp;кг). Корректная обработка арабских и&nbsp;римских чисел (например, XXI&nbsp;век, III&nbsp;в.&nbsp;н.&nbsp;э.).
</p>
</div>
</div>
<div class="col-md-6 col-lg-4">
<div class="p-3 border rounded bg-body-tertiary h-100 feature-card">
<h3 class="h6 fw-bold"><i class="bi bi-person-badge me-1"></i> Инициалы и&nbsp;сокращения</h3>
<p class="small text-muted mb-0">
Связывание неразрывными пробелами инициалов (А.С.&nbsp;Пушкин), устойчивых сокращений (ЗАО&nbsp;&laquo;Рога и&nbsp;Копыта&raquo;, др.&nbsp;Барменталь), сокращений (&laquo;и&nbsp;т.д.&raquo;, &laquo;и&nbsp;др.&raquo;), знаков (&sect;&nbsp;5, &#8470;&nbsp;12) и&nbsp;единиц (100&nbsp;руб., 50&nbsp;м&sup2;).
</p>
</div>
</div>
<div class="col-md-6 col-lg-4">
<div class="p-3 border rounded bg-body-tertiary h-100 feature-card">
<h3 class="h6 fw-bold"><i class="bi bi-layout-text-sidebar me-1"></i> Висячая пунктуация</h3>
<p class="small text-muted mb-0">
Оптическое выравнивание левого и&nbsp;правого края текстового блока за&nbsp;счет выноса кавычек, скобок и&nbsp;тире за&nbsp;границу полосы набора. Идеально для&nbsp;крупных заголовков, цитат, выносов и&nbsp;врезок.
</p>
</div>
</div>
<div class="col-md-6 col-lg-4">
<div class="p-3 border rounded bg-body-tertiary h-100 feature-card">
<h3 class="h6 fw-bold"><i class="bi bi-shield-check me-1"></i> Санитайзер и&nbsp;спецсимволы</h3>
<p class="small text-muted mb-0">
Встроенный HTML-санитайзер: очистка текста от&nbsp;мусорных тегов при&nbsp;копировании из&nbsp;Word/Google Docs, сброс разметки висячей пунктуации. Обработка псевдографики (<code>(c)</code>&nbsp;&rarr;&nbsp;&copy;, <code>(tm)</code>&nbsp;&rarr;&nbsp;&trade;, <code>+/-</code>&nbsp;&rarr;&nbsp;&plusmn;).
</p>
</div>
</div>
<div class="col-md-6 col-lg-4">
<div class="p-3 border rounded bg-body-tertiary h-100 feature-card">
<h3 class="h6 fw-bold"><i class="bi bi-fonts me-1"></i> Переносы в&nbsp;словах</h3>
<p class="small text-muted mb-0">
Автоматическая расстановка мягких переносов (<code>&amp;shy;</code>) в&nbsp;длинных словах с&nbsp;настраиваемым порогом длины (от&nbsp;12&nbsp;символов). Колонки текста аккуратно перено&shy;сятся в&nbsp;узких блоках и&nbsp;на&nbsp;мобильных экранах без&nbsp;разрыва вёрстки.
</p>
</div>
</div>
<div class="col-md-6 col-lg-4">
<div class="p-3 border rounded bg-body-tertiary h-100 feature-card">
<h3 class="h6 fw-bold"><i class="bi bi-code-slash me-1"></i> Форматы вывода и&nbsp;гибкие правила</h3>
<p class="small text-muted mb-0">
Поддержка HTML с&nbsp;мнемониками, смешанного режима и&nbsp;Unicode (UTF-8) для&nbsp;постов в&nbsp;соцсетях (VK, Telegram, Reddit). Любые группы правил можно гибко комбинировать, включать или&nbsp;отключать под&nbsp;конкретную задачу или&nbsp;проект.
</p>
</div>
</div>
<div class="col-md-6 col-lg-4">
<div class="p-3 border rounded bg-body-tertiary h-100 feature-card">
<h3 class="h6 fw-bold"><i class="bi bi-infinity me-1"></i> Бесплатно и&nbsp;безлимитно</h3>
<p class="small text-muted mb-0">
Полная свобода использования без&nbsp;ограничений по&nbsp;объёму текста, без&nbsp;регистрации, подписок и&nbsp;рекламы. Доступен как&nbsp;онлайн-сервис, так и&nbsp;в&nbsp;виде открытой библиотеки для&nbsp;Python по&nbsp;лицензии MIT.
</p>
</div>
</div>
</div>
</section>
<hr />
<section class="mb-5">
<h2 class="h4 mb-3">Кому подходит типограф ETPGRF</h2>
<div class="row g-3">
<div class="col-md-4">
<div class="border-start border-3 border-secondary ps-3">
<h3 class="h6 fw-bold">Контент-менеджерам и&nbsp;дизайнерам</h3>
<p class="small text-muted">
Профессиональный визуальный ритм и&nbsp;читаемость текста в&nbsp;веб-интерфейсах, блогах, SMM-публикациях в&nbsp;соцсетях и&nbsp;электронных рассылках.
</p>
</div>
</div>
<div class="col-md-4">
<div class="border-start border-3 border-secondary ps-3">
<h3 class="h6 fw-bold">Веб-разработчикам и&nbsp;верстальщикам</h3>
<p class="small text-muted">
Получайте чистый, валидный HTML-код с&nbsp;неразрывными пробелами и&nbsp;мнемониками, готовый к&nbsp;вставке в&nbsp;шаблоны, CMS и&nbsp;лендинги.
</p>
</div>
</div>
<div class="col-md-4">
<div class="border-start border-3 border-secondary ps-3">
<h3 class="h6 fw-bold">Редакторам и&nbsp;копирайтерам</h3>
<p class="small text-muted">
Быстрая автоматическая подготовка статей, колонок и&nbsp;постов для&nbsp;публикации без&nbsp;рутинной ручной расстановки спецсимволов.
</p>
</div>
</div>
</div>
</section>
<hr />
<section class="mb-5">
<h2 class="h4 mb-3">Интеграция в&nbsp;проекты: Python-библиотека etpgrf</h2>
<p class="small text-muted">
Вы&nbsp;можете свободно использовать движок etpgrf-типографа офлайн в&nbsp;своих Python-скриптах, Django-, FastAPI- или&nbsp;Flask-приложениях и&nbsp;сайтах:
</p>
<div class="bg-body-tertiary p-3 rounded border font-monospace small mb-3">
<div class="text-secondary mb-1"># Установка через pip:</div>
<div class="text-success fw-bold mb-3">pip install etpgrf</div>
<div class="text-secondary mb-1"># Пример использования в коде:</div>
<div><span class="text-primary">from</span> etpgrf.main <span class="text-primary">import</span> Typographer</div>
<div class="mt-1">tp = Typographer(lang=<span class="text-success">'ru'</span>, mode=<span class="text-success">'mixed'</span>)</div>
<div>formatted_html = tp.process(<span class="text-success">'Правильная вёрстка "кавычек" и отбивка тире -- улучшают читаемость текста на сайте!'</span>)</div>
</div>
<p class="small text-muted mb-0">
Подробная документация и&nbsp;исходный код библиотеки открыты на&nbsp;<a href="https://github.com/erjemin/etpgrf" target="_blank" rel="noopener">GitHub</a> и&nbsp;<a href="https://pypi.org/project/etpgrf/" target="_blank" rel="noopener">PyPI</a>.
</p>
</section>
<hr />
<section class="mb-5">
<h2 class="h4 mb-3">Часто задаваемые вопросы (FAQ)</h2>
<div class="accordion" id="faqAccordion">
<div class="accordion-item bg-body-tertiary">
<h3 class="accordion-header" id="faqHeadingOne">
<button class="accordion-button collapsed bg-body-tertiary" type="button" data-bs-toggle="collapse" data-bs-target="#faqOne" aria-expanded="false" aria-controls="faqOne">
Зачем типографировать текст перед публикацией на сайте?
</button>
</h3>
<div id="faqOne" class="accordion-collapse collapse" aria-labelledby="faqHeadingOne" data-bs-parent="#faqAccordion">
<div class="accordion-body small text-muted">
В&nbsp;вебе строки переносятся динамически в&nbsp;зависимости от&nbsp;экрана устройства. Без&nbsp;неразрывных пробелов предлоги и&nbsp;союзы часто &laquo;висят&raquo; на&nbsp;концах строк, а&nbsp;дефисы путаются с&nbsp;длинным тире. Типографика делает текст легким для&nbsp;восприятия и&nbsp;профессиональным.
</div>
</div>
</div>
<div class="accordion-item bg-body-tertiary">
<h3 class="accordion-header" id="faqHeadingTwo">
<button class="accordion-button collapsed bg-body-tertiary" type="button" data-bs-toggle="collapse" data-bs-target="#faqTwo" aria-expanded="false" aria-controls="faqTwo">
Чем ETPGRF отличается от Типографа Студии Лебедева или Типографа Муравьёва?
</button>
</h3>
<div id="faqTwo" class="accordion-collapse collapse" aria-labelledby="faqHeadingTwo" data-bs-parent="#faqAccordion">
<div class="accordion-body small text-muted">
ETPGRF разработан на&nbsp;современной открытой кодовой базе Python 3, активно поддерживается, умеет корректно обрабатывать смешанные русско-английские тексты (ru+en), имеет гибкий выбор режима кодирования (Unicode/HTML-мнемоники), настраиваемую висячую пунктуацию и&nbsp;может работать как&nbsp;локальный модуль или веб-микросервис.
</div>
</div>
</div>
<div class="accordion-item bg-body-tertiary">
<h3 class="accordion-header" id="faqHeadingThree">
<button class="accordion-button collapsed bg-body-tertiary" type="button" data-bs-toggle="collapse" data-bs-target="#faqThree" aria-expanded="false" aria-controls="faqThree">
Сохраняются ли введённые тексты на сервере?
</button>
</h3>
<div id="faqThree" class="accordion-collapse collapse" aria-labelledby="faqHeadingThree" data-bs-parent="#faqAccordion">
<div class="accordion-body small text-muted">
Нет, сервис соблюдает полную конфиденциальность. Тексты обрабатываются исключительно в&nbsp;памяти в&nbsp;момент отправки запроса и&nbsp;не&nbsp;сохраняются в&nbsp;базу данных и&nbsp;логи.
</div>
</div>
</div>
</div>
</section>
</div>
</div>
</div>
{% endblock %}
+119
View File
@@ -0,0 +1,119 @@
from pathlib import Path
from django.test import TestCase, Client, override_settings
from django.urls import reverse
from django.conf import settings
@override_settings(SECURE_SSL_REDIRECT=False)
class VendorAssetsAndFallbackTestCase(TestCase):
"""
Тестирование наличия вендорных ассетов и корректности подключения fallback в шаблоне base.html.
"""
def setUp(self):
self.client = Client()
def test_vendor_static_files_exist(self):
"""Проверяем, что все скомпилированные/скопированные локальные файлы присутствуют в статике."""
static_dir = settings.BASE_DIR.parent / 'public' / 'static'
required_files = [
'vendor/bootstrap/bootstrap.min.css',
'vendor/bootstrap/bootstrap.bundle.min.js',
'vendor/bootstrap-icons/bootstrap-icons.min.css',
'vendor/bootstrap-icons/fonts/bootstrap-icons.woff2',
'vendor/bootstrap-icons/fonts/bootstrap-icons.woff',
'vendor/htmx/htmx.min.js',
'vendor/alpinejs/cdn.min.js',
'codemirror/editor.js',
]
for rel_path in required_files:
file_path = static_dir / rel_path
self.assertTrue(
file_path.exists(),
f"Файл вендора не найден в статике: {rel_path} (ожидался по пути {file_path})"
)
self.assertGreater(
file_path.stat().st_size,
0,
f"Файл вендора пуст: {rel_path}"
)
def test_base_template_fallback_tags(self):
"""Проверяем, что главная страница отдает теги с fallback-обработкой ошибок загрузки с CDN."""
response = self.client.get(reverse('index'))
self.assertEqual(response.status_code, 200)
content = response.content.decode('utf-8')
# Проверка fallback для Bootstrap CSS
self.assertIn('bootstrap.min.css', content)
self.assertIn("vendor/bootstrap/bootstrap.min.css", content)
# Проверка fallback для Bootstrap Icons
self.assertIn('bootstrap-icons.min.css', content)
self.assertIn("vendor/bootstrap-icons/bootstrap-icons.min.css", content)
# Проверка fallback для HTMX
self.assertIn('htmx.org', content)
self.assertIn('window.htmx || document.write', content)
self.assertIn('vendor/htmx/htmx.min.js', content)
# Проверка fallback для Alpine.js
self.assertIn('alpinejs', content)
self.assertIn('vendor/alpinejs/cdn.min.js', content)
# Проверка fallback для Bootstrap JS
self.assertIn('bootstrap.bundle.min.js', content)
self.assertIn('window.bootstrap || document.write', content)
self.assertIn('vendor/bootstrap/bootstrap.bundle.min.js', content)
@override_settings(SECURE_SSL_REDIRECT=False)
class TypographViewsTestCase(TestCase):
"""
Базовые тесты функциональности представлений типографа.
"""
def setUp(self):
self.client = Client()
def test_process_text_endpoint(self):
"""Проверка эндпоинта типографирования текста."""
response = self.client.post(
reverse('process_text'),
data={
'text': 'Тест "кавычек" и предлога в тексте.',
'langs': 'ru',
'quotes': 'on',
'unbreakables': 'on',
}
)
self.assertEqual(response.status_code, 200)
self.assertIn('X-Processing-Time', response.headers)
content = response.content.decode('utf-8')
# Проверяем типографирование кавычек «ёлочки»
self.assertIn('«кавычек»', content)
def test_stats_summary_endpoint(self):
"""Проверка эндпоинта сводной статистики."""
response = self.client.get(reverse('stats_summary'))
self.assertEqual(response.status_code, 200)
def test_seo_metadata_and_sitemap(self):
"""Проверка мета-тегов на главной странице и генерации sitemap.xml."""
response = self.client.get(reverse('index'))
self.assertEqual(response.status_code, 200)
content = response.content.decode('utf-8')
self.assertIn('<title>Онлайн-типограф', content)
self.assertIn('name="description"', content)
self.assertIn('name="keywords"', content)
self.assertIn('rel="canonical"', content)
# Проверка sitemap.xml
sitemap_res = self.client.get('/sitemap.xml')
self.assertEqual(sitemap_res.status_code, 200)
sitemap_content = sitemap_res.content.decode('utf-8')
self.assertIn('<loc>', sitemap_content)
self.assertIn('http://testserver/', sitemap_content)
+16 -16
View File
@@ -1,24 +1,24 @@
#!/usr/bin/bash
#!/usr/bin/env bash
set -e
# Необходимо предварительно установить NPM и esbuild:
# Переходим в директорию скрипта
cd "$(dirname "$0")"
# Необходимо предварительно установить Node.js и npm:
# Для Ubuntu/Debian:
# sudo apt install npm
# npm install -g esbuild
# sudo apt install nodejs npm
# Для MacOS (через Homebrew):
# brew install npm
# npm install -g esbuild
# brew install node
# Для Windows:
# Скачайте и установите Node.js с официального сайта: https://nodejs.org/
# Затем установите esbuild глобально:
# npm install -g esbuild
# Устанавливаем CodeMirror и необходимые пакеты
npm install \ [±main ●●]
@codemirror/lang-html \
@codemirror/theme-one-dark \
@codemirror/commands \
@codemirror/language
# Устанавливаем зависимости
npm install
# Собираем js в каталог ./public/static/codemirror/editor.js с помощью esbuild
npx esbuild src/editor.js --bundle --format=esm --outfile=../public/static/codemirror/editor.js
# Собираем всё (CodeMirror и копирование вендорных библиотек в public/static/vendor/)
npm run build
# Подчищаем за собой node_modules
echo "Очистка node_modules..."
rm -rf node_modules
+78
View File
@@ -0,0 +1,78 @@
const fs = require('fs');
const path = require('path');
// Целевая папка для статики вендоров
const targetDir = path.resolve(__dirname, '../public/static/vendor');
// Список файлов и директорий для копирования
const itemsToCopy = [
// Bootstrap 5 (CSS & JS bundle)
{
src: 'node_modules/bootstrap/dist/css/bootstrap.min.css',
dest: 'bootstrap/bootstrap.min.css'
},
{
src: 'node_modules/bootstrap/dist/css/bootstrap.min.css.map',
dest: 'bootstrap/bootstrap.min.css.map'
},
{
src: 'node_modules/bootstrap/dist/js/bootstrap.bundle.min.js',
dest: 'bootstrap/bootstrap.bundle.min.js'
},
{
src: 'node_modules/bootstrap/dist/js/bootstrap.bundle.min.js.map',
dest: 'bootstrap/bootstrap.bundle.min.js.map'
},
// Bootstrap Icons (CSS & WOFF/WOFF2 шрифты)
{
src: 'node_modules/bootstrap-icons/font/bootstrap-icons.min.css',
dest: 'bootstrap-icons/bootstrap-icons.min.css'
},
{
src: 'node_modules/bootstrap-icons/font/fonts/bootstrap-icons.woff2',
dest: 'bootstrap-icons/fonts/bootstrap-icons.woff2'
},
{
src: 'node_modules/bootstrap-icons/font/fonts/bootstrap-icons.woff',
dest: 'bootstrap-icons/fonts/bootstrap-icons.woff'
},
// HTMX
{
src: 'node_modules/htmx.org/dist/htmx.min.js',
dest: 'htmx/htmx.min.js'
},
// Alpine.js
{
src: 'node_modules/alpinejs/dist/cdn.min.js',
dest: 'alpinejs/cdn.min.js'
}
];
console.log('Сборка и копирование вендорных библиотек в static/vendor/...');
let copiedCount = 0;
for (const item of itemsToCopy) {
const srcPath = path.resolve(__dirname, item.src);
const destPath = path.join(targetDir, item.dest);
if (!fs.existsSync(srcPath)) {
console.warn(`Предупреждение: исходный файл не найден: ${item.src}`);
continue;
}
// Создаем папку назначения, если не существует
const destDirPath = path.dirname(destPath);
if (!fs.existsSync(destDirPath)) {
fs.mkdirSync(destDirPath, { recursive: true });
}
fs.copyFileSync(srcPath, destPath);
console.log(` Скопировано: ${item.src} -> ${path.relative(path.resolve(__dirname, '..'), destPath)}`);
copiedCount++;
}
console.log(`Успешно скопировано файлов: ${copiedCount}`);
+83 -3
View File
@@ -1,11 +1,11 @@
{
"name": "tmp-frontend",
"name": "frontend-assembly",
"version": "1.0.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "tmp-frontend",
"name": "frontend-assembly",
"version": "1.0.0",
"license": "ISC",
"dependencies": {
@@ -13,7 +13,11 @@
"@codemirror/lang-html": "^6.4.11",
"@codemirror/language": "^6.12.1",
"@codemirror/theme-one-dark": "^6.1.3",
"codemirror": "^6.0.2"
"alpinejs": "^3.14.8",
"bootstrap": "^5.3.3",
"bootstrap-icons": "^1.11.3",
"codemirror": "^6.0.2",
"htmx.org": "^1.9.12"
},
"devDependencies": {
"esbuild": "^0.27.2"
@@ -662,6 +666,76 @@
"integrity": "sha512-l0h88YhZFyKdXIFNfSWpyjStDjGHwZ/U7iobcK1cQQD8sejsONdQtTVU+1wVN1PBw40PiiHB1vA5S7VTfQiP9g==",
"license": "MIT"
},
"node_modules/@popperjs/core": {
"version": "2.11.8",
"resolved": "https://registry.npmjs.org/@popperjs/core/-/core-2.11.8.tgz",
"integrity": "sha512-P1st0aksCrn9sGZhp8GMYwBnQsbvAWsZAX44oXNNvLHGqAOcoVxmjZiohstwQ7SqKnbR47akdNi+uleWD8+g6A==",
"license": "MIT",
"peer": true,
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/popperjs"
}
},
"node_modules/@vue/reactivity": {
"version": "3.1.5",
"resolved": "https://registry.npmjs.org/@vue/reactivity/-/reactivity-3.1.5.tgz",
"integrity": "sha512-1tdfLmNjWG6t/CsPldh+foumYFo3cpyCHgBYQ34ylaMsJ+SNHQ1kApMIa8jN+i593zQuaw3AdWH0nJTARzCFhg==",
"license": "MIT",
"dependencies": {
"@vue/shared": "3.1.5"
}
},
"node_modules/@vue/shared": {
"version": "3.1.5",
"resolved": "https://registry.npmjs.org/@vue/shared/-/shared-3.1.5.tgz",
"integrity": "sha512-oJ4F3TnvpXaQwZJNF3ZK+kLPHKarDmJjJ6jyzVNDKH9md1dptjC7lWR//jrGuLdek/U6iltWxqAnYOu8gCiOvA==",
"license": "MIT"
},
"node_modules/alpinejs": {
"version": "3.14.8",
"resolved": "https://registry.npmjs.org/alpinejs/-/alpinejs-3.14.8.tgz",
"integrity": "sha512-wT2fuP2DXpGk/jKaglwy7S/IJpm1FD+b7U6zUrhwErjoq5h27S4dxkJEXVvhbdwyPv9U+3OkUuNLkZT4h2Kfrg==",
"license": "MIT",
"dependencies": {
"@vue/reactivity": "~3.1.1"
}
},
"node_modules/bootstrap": {
"version": "5.3.3",
"resolved": "https://registry.npmjs.org/bootstrap/-/bootstrap-5.3.3.tgz",
"integrity": "sha512-8HLCdWgyoMguSO9o+aH+iuZ+aht+mzW0u3HIMzVu7Srrpv7EBBxTnrFlSCskwdY1+EOFQSm7uMJhNQHkdPcmjg==",
"funding": [
{
"type": "github",
"url": "https://github.com/sponsors/twbs"
},
{
"type": "opencollective",
"url": "https://opencollective.com/bootstrap"
}
],
"license": "MIT",
"peerDependencies": {
"@popperjs/core": "^2.11.8"
}
},
"node_modules/bootstrap-icons": {
"version": "1.11.3",
"resolved": "https://registry.npmjs.org/bootstrap-icons/-/bootstrap-icons-1.11.3.tgz",
"integrity": "sha512-+3lpHrCw/it2/7lBL15VR0HEumaBss0+f/Lb6ZvHISn1mlK83jjFpooTLsMWbIjJMDjDjOExMsTxnXSIT4k4ww==",
"funding": [
{
"type": "github",
"url": "https://github.com/sponsors/twbs"
},
{
"type": "opencollective",
"url": "https://opencollective.com/bootstrap"
}
],
"license": "MIT"
},
"node_modules/codemirror": {
"version": "6.0.2",
"resolved": "https://registry.npmjs.org/codemirror/-/codemirror-6.0.2.tgz",
@@ -725,6 +799,12 @@
"@esbuild/win32-x64": "0.27.2"
}
},
"node_modules/htmx.org": {
"version": "1.9.12",
"resolved": "https://registry.npmjs.org/htmx.org/-/htmx.org-1.9.12.tgz",
"integrity": "sha512-VZAohXyF7xPGS52IM8d1T1283y+X4D+Owf3qY1NZ9RuBypyu9l8cGsxUMAG5fEAb/DhT7rDoJ9Hpu5/HxFD3cw==",
"license": "0BSD"
},
"node_modules/style-mod": {
"version": "4.1.3",
"resolved": "https://registry.npmjs.org/style-mod/-/style-mod-4.1.3.tgz",
+9 -3
View File
@@ -4,8 +4,10 @@
"description": "CodeMirror build for ETPGRF",
"main": "index.js",
"scripts": {
"build": "esbuild src/editor.js --bundle --format=esm --outfile=dist/editor.js --minify",
"dev": "esbuild src/editor.js --bundle --format=esm --outfile=../public/static/codemirror/editor.js --minify",
"build:codemirror": "esbuild src/editor.js --bundle --format=esm --outfile=../public/static/codemirror/editor.js --minify",
"build:vendor": "node copy-vendor.js",
"build": "npm run build:codemirror && npm run build:vendor",
"dev": "npm run build",
"watch": "esbuild src/editor.js --bundle --format=esm --outfile=../public/static/codemirror/editor.js --watch"
},
"keywords": [],
@@ -17,7 +19,11 @@
"@codemirror/lang-html": "^6.4.11",
"@codemirror/language": "^6.12.1",
"@codemirror/theme-one-dark": "^6.1.3",
"codemirror": "^6.0.2"
"alpinejs": "^3.14.8",
"bootstrap": "^5.3.3",
"bootstrap-icons": "^1.11.3",
"codemirror": "^6.0.2",
"htmx.org": "^1.9.12"
},
"devDependencies": {
"esbuild": "^0.27.2"
File diff suppressed because one or more lines are too long
+41
View File
@@ -410,3 +410,44 @@ footer.footer a:hover {
border-right: 1px solid var(--bs-border-color) !important;
}
}
/* --- Карточки возможностей (hover-эффект без потери читаемости) --- */
.feature-card {
transition: transform 0.2s ease, box-shadow 0.2s ease, border-color 0.2s ease, background-color 0.2s ease;
}
.feature-card:hover {
transform: translateY(-2px);
border-color: rgba(var(--bs-primary-rgb), 0.5) !important;
box-shadow: 0 6px 20px rgba(0, 0, 0, 0.09), 0 2px 6px rgba(0, 0, 0, 0.04);
}
[data-bs-theme="dark"] .feature-card:hover {
border-color: rgba(176, 190, 197, 0.5) !important;
background-color: rgba(255, 255, 255, 0.03) !important;
box-shadow: 0 6px 22px rgba(255, 255, 255, 0.15), 0 2px 8px rgba(255, 255, 255, 0.08);
}
@media (prefers-color-scheme: dark) {
:root:not([data-bs-theme="light"]) .feature-card:hover {
border-color: rgba(176, 190, 197, 0.5) !important;
background-color: rgba(255, 255, 255, 0.03) !important;
box-shadow: 0 6px 22px rgba(255, 255, 255, 0.15), 0 2px 8px rgba(255, 255, 255, 0.08);
}
}
/* --- Кнопка раскрытия информационного блока --- */
.collapse-toggle-btn {
font-size: 0.875rem;
font-weight: 500;
transition: all 0.2s ease-in-out;
}
.collapse-toggle-btn .collapse-icon {
display: inline-block;
transition: transform 0.25s ease-in-out;
}
.collapse-toggle-btn:not(.collapsed) .collapse-icon {
transform: rotate(180deg);
}
+3
View File
@@ -3,3 +3,6 @@ Allow: /
Host: https://typograph.cube2.ru
Sitemap: https://typograph.cube2.ru/sitemap.xml
# Ссылка на файл для ИИ-моделей
Link: /llms.txt
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
Binary file not shown.
Binary file not shown.
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
+1 -1
View File
@@ -1,6 +1,6 @@
[tool.poetry]
name = "2026-etpgrf-site"
version = "0.2.7"
version = "0.2.8"
description = ""
authors = ["erjemin <erjemin@gmail.com>"]
readme = "README.md"