🌐 Translate all files to English and add cache-busting

kiku-jw · kiku-jw · commit 994cf86c5667 · 2025-10-31T17:01:16.000+02:00
- Translate SITE_REVIEW.md to English
- Translate PUBLISH.md to English
- Translate publish.sh comments to English
- Add cache-busting parameters (?v=2) to CSS and JS in index.html
- Ensure repository is fully in English
diff --git a/PUBLISH.md b/PUBLISH.md
@@ -1,77 +1,76 @@
-# ИНСТРУКЦИЯ ПО ПУБЛИКАЦИИ
+# PUBLISHING INSTRUCTIONS
 
-## Шаги для публикации на GitHub:
+## Steps to publish on GitHub:
 
-1. **Создайте новый репозиторий на GitHub:**
-   - Перейдите на https://github.com/new
-   - Название репозитория: `DocStripper`
-   - Описание: "Batch document cleaner — удаляет мусор из текстовых документов"
-   - Выберите Public
-   - НЕ добавляйте README, .gitignore или лицензию (они уже есть)
-   - Нажмите "Create repository"
+1. **Create a new repository on GitHub:**
+   - Go to https://github.com/new
+   - Repository name: `DocStripper`
+   - Description: "Batch document cleaner — removes noise from text documents"
+   - Select Public
+   - DO NOT add README, .gitignore or license (they already exist)
+   - Click "Create repository"
 
-2. **Подключите локальный репозиторий к GitHub:**
+2. **Connect local repository to GitHub:**
    ```bash
    git remote add origin https://github.com/YOUR_USERNAME/DocStripper.git
    git branch -M main
    git push -u origin main
    ```
-   (Замените YOUR_USERNAME на ваш GitHub username)
+   (Replace YOUR_USERNAME with your GitHub username)
 
-3. **Создайте релиз v1.0.0:**
-   - Перейдите в раздел Releases на GitHub
-   - Нажмите "Create a new release"
+3. **Create v1.0.0 release:**
+   - Go to Releases section on GitHub
+   - Click "Create a new release"
    - Tag: `v1.0.0`
    - Release title: `DocStripper — Batch document cleaner`
-   - Описание:
+   - Description:
      ```
      ## DocStripper v1.0.0
      
-     Первый релиз DocStripper — утилиты для массовой очистки текстовых документов.
+     First release of DocStripper — utility for batch cleaning text documents.
      
-     ### Основные возможности:
-     - Удаление повторяющихся строк
-     - Удаление номеров страниц
-     - Удаление заголовков и подвалов
-     - Удаление пустых строк
-     - Поддержка .txt, .docx, .pdf файлов
-     - Режим dry-run
-     - Откат изменений
+     ### Main features:
+     - Remove duplicate lines
+     - Remove page numbers
+     - Remove headers and footers
+     - Remove empty lines
+     - Support for .txt, .docx, .pdf files
+     - Dry-run mode
+     - Undo changes
      
-     ### Технические детали:
+     ### Technical details:
      - Python 3.9+
-     - Только стандартная библиотека
-     - Кросс-платформенная поддержка
+     - Standard library only
+     - Cross-platform support
      
-     См. README.md для инструкций по установке и использованию.
+     See README.md for installation and usage instructions.
      ```
-   - Нажмите "Publish release"
+   - Click "Publish release"
 
-4. **Проверьте, что всё работает:**
+4. **Verify everything works:**
    ```bash
    python tool.py --help
    ```
 
-## Структура проекта:
+## Project structure:
 
 ```
 DocStripper/
-├── tool.py              # Основной файл утилиты
-├── README.md            # Документация с примерами
-├── CHANGELOG.md         # История изменений
+├── tool.py              # Main utility file
+├── README.md            # Documentation with examples
+├── CHANGELOG.md         # Change history
 ├── LICENSE.txt          # MIT License
-├── SELF_TESTS.md        # Тестовые случаи
-├── RELEASE_LEDGER.json  # Регистр релизов
-├── .gitignore          # Git ignore файл
+├── SELF_TESTS.md        # Test cases
+├── RELEASE_LEDGER.json  # Release registry
+├── .gitignore          # Git ignore file
 └── examples/
-    └── before_after.txt # Демонстрация работы
+    └── before_after.txt # Demonstration
 ```
 
-## Проверка готовности:
-
-✅ Все файлы созданы
-✅ Git репозиторий инициализирован
-✅ tool.py работает корректно
-✅ README содержит 6 примеров использования
-✅ Готово к публикации!
+## Readiness check:
 
+✅ All files created
+✅ Git repository initialized
+✅ tool.py works correctly
+✅ README contains 6 usage examples
+✅ Ready to publish!
diff --git a/SITE_REVIEW.md b/SITE_REVIEW.md
@@ -1,88 +1,87 @@
-# Оценка и улучшения сайта DocStripper
-
-## 📊 Оценка текущего состояния
-
-### ✅ Сильные стороны:
-1. **Функциональность**: Полностью рабочее веб-приложение
-2. **Приватность**: Все обработка происходит в браузере
-3. **Дизайн**: Современный, минималистичный стиль
-4. **Адаптивность**: Работает на мобильных устройствах
-
-### ⚠️ Обнаруженные проблемы:
-1. **Область загрузки**: Недостаточно заметна
-2. **Визуальная иерархия**: Можно улучшить
-3. **Обратная связь**: Нужны лучшие уведомления
-4. **Темная тема**: Кнопка переключения может быть не видна
-
-## ✨ Внесенные улучшения
-
-### 1. Область загрузки файлов
-- ✅ Увеличена минимальная высота до 250px
-- ✅ Увеличен padding до 5rem
-- ✅ Увеличен размер иконки до 6rem
-- ✅ Увеличен размер текста до 1.75rem
-- ✅ Улучшена граница (4px dashed)
-- ✅ Добавлен градиентный фон секции
-
-### 2. Визуальная обратная связь
-- ✅ Добавлены toast-уведомления вместо alert
-- ✅ Анимация загрузки с spinner
-- ✅ Плавные переходы и hover-эффекты
-- ✅ Улучшенные состояния элементов
-
-### 3. Темная тема
-- ✅ Кнопка переключения в правом верхнем углу
-- ✅ Сохранение выбора в localStorage
-- ✅ Плавное переключение между темами
-- ✅ Адаптивные цвета для обеих тем
-
-### 4. Дизайн и UX
-- ✅ Улучшены тени и границы
-- ✅ Лучшая типографика
-- ✅ Стилизованные scrollbar'ы
-- ✅ Состояния фокуса для доступности
-- ✅ Улучшенная мобильная версия
-
-### 5. Технические улучшения
-- ✅ Улучшена обработка ошибок
-- ✅ Защита от XSS (escapeHtml)
-- ✅ Проверка существования элементов
-- ✅ Graceful fallback для JSZip
-
-## 🎯 Итоговые характеристики
-
-**Дизайн:**
-- Минималистичный и чистый
-- Профессиональный внешний вид
-- Хорошая визуальная иерархия
-- Современные тренды UI/UX
-
-**Работоспособность:**
-- Полностью функциональное веб-приложение
-- Обработка файлов в браузере
-- Поддержка .txt и .docx
-- Статистика и предпросмотр результатов
-
-**Доступность:**
-- Состояния фокуса для клавиатурной навигации
-- Адаптивный дизайн
-- Понятные сообщения об ошибках
-
-## 📈 Рекомендации для дальнейшего развития
-
-1. Добавить примеры файлов для тестирования
-2. Добавить прогресс-бар для больших файлов
-3. Добавить сравнение "до/после" side-by-side
-4. Добавить экспорт статистики в JSON/CSV
-5. Добавить поддержку больше форматов (если возможно)
-
-## ✅ Заключение
-
-Сайт полностью функционален и готов к использованию. Все основные улучшения внесены:
-- Большая, заметная область загрузки
-- Красивый минималистичный дизайн
-- Работающая темная тема
-- Улучшенная обратная связь
-
-Сайт готов к публичному использованию!
-
+# DocStripper Site Assessment and Improvements
+
+## 📊 Current State Assessment
+
+### ✅ Strengths:
+1. **Functionality**: Fully working web application
+2. **Privacy**: All processing happens in browser
+3. **Design**: Modern, minimalistic style
+4. **Responsiveness**: Works on mobile devices
+
+### ⚠️ Issues Found:
+1. **Upload area**: Not prominent enough
+2. **Visual hierarchy**: Could be improved
+3. **User feedback**: Better notifications needed
+4. **Dark theme**: Toggle button visibility
+
+## ✨ Improvements Made
+
+### 1. File Upload Area
+- ✅ Increased min-height to 250px
+- ✅ Increased padding to 5rem
+- ✅ Increased icon size to 6rem
+- ✅ Increased text size to 1.75rem
+- ✅ Improved border (4px dashed)
+- ✅ Added gradient background to section
+
+### 2. Visual Feedback
+- ✅ Added toast notifications instead of alerts
+- ✅ Loading animation with spinner
+- ✅ Smooth transitions and hover effects
+- ✅ Improved element states
+
+### 3. Dark Theme
+- ✅ Toggle button in top right corner
+- ✅ Save choice in localStorage
+- ✅ Smooth theme switching
+- ✅ Adaptive colors for both themes
+
+### 4. Design and UX
+- ✅ Improved shadows and borders
+- ✅ Better typography
+- ✅ Styled scrollbars
+- ✅ Focus states for accessibility
+- ✅ Improved mobile version
+
+### 5. Technical Improvements
+- ✅ Improved error handling
+- ✅ XSS protection (escapeHtml)
+- ✅ Element existence checks
+- ✅ Graceful fallback for JSZip
+
+## 🎯 Final Characteristics
+
+**Design:**
+- Minimalistic and clean
+- Professional appearance
+- Good visual hierarchy
+- Modern UI/UX trends
+
+**Functionality:**
+- Fully functional web application
+- Browser-based file processing
+- Support for .txt and .docx
+- Statistics and results preview
+
+**Accessibility:**
+- Focus states for keyboard navigation
+- Responsive design
+- Clear error messages
+
+## 📈 Recommendations for Further Development
+
+1. Add example files for testing
+2. Add progress bar for large files
+3. Add side-by-side before/after comparison
+4. Add statistics export to JSON/CSV
+5. Add support for more formats (if possible)
+
+## ✅ Conclusion
+
+The site is fully functional and ready for use. All major improvements have been made:
+- Large, prominent upload area
+- Beautiful minimalistic design
+- Working dark theme
+- Improved user feedback
+
+The site is ready for public use!
diff --git a/docs/index.html b/docs/index.html
@@ -5,7 +5,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>DocStripper - Batch Document Cleaner</title>
     <meta name="description" content="DocStripper - Remove noise from text documents automatically. Clean page numbers, headers, footers, duplicates, and empty lines.">
-    <link rel="stylesheet" href="assets/style.css">
+    <link rel="stylesheet" href="assets/style.css?v=2">
     <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><text y='.9em' font-size='90'>🧹</text></svg>">
 </head>
 <body>
@@ -184,6 +184,6 @@ <h2>Prefer Command Line?</h2>
         </div>
     </footer>
 
-    <script src="assets/app.js"></script>
+    <script src="assets/app.js?v=2"></script>
 </body>
 </html>
diff --git a/publish.sh b/publish.sh
