Files
1998-cad-cadpoint/README.md
2026-03-27 18:21:03 +03:00

132 lines
7.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Архив сайта cad.ru (1998 год)
## ВСЕ о САПР (CAD/CAM/CAE Archive)
Архивная версия исторического русскоязычного сайта о системах автоматизированного проектирования (САПР), созданного в 19981999 годах. Развернуто, для обозрения по адресу: [1998.cadpoint.ru/](https://1998.cadpoint.ru/).
**Осторожно:**
- фреймы (frameset) и meta-refresh;
- оптимизировано под разрешение 640х480;
- кодировка KOI8-R (не UTF-8);
- куча "битых ссылок" на внешние ресурсы.
### ⚠️ Важно: Кодировка KOI8-R
Этот архив хранится в кодировке **KOI8-R** (устаревший стандарт для русского текста в интернете конца 90-х).
#### Отображение в Gitea (веб-интерфейс)
Если в веб-интерфейсе Gitea видишь "кракозябры" или иероглифы вместо русского текста — **это не ошибка, файлы хранятся корректно**. Веб-интерфейс Git/Gitea обычно ожидает UTF-8 и не умеет надёжно показывать KOI8-R как есть. Содержимое в репозитории не повреждено.
#### Правильное отображение и работа
##### 1. Локально (клонирование + IDE)
```bash
git clone https://git.cube2.ru/erjemin/1998-cad-cadpoint.git
cd 1998-cad-cadpoint
```
Откройте файлы в IDE **с явным указанием кодировки KOI8-R**:
- **VS Code**: нижняя панель → `UTF-8` → выберите `KOI8-R`
- **JetBrains IDE** (PhpStorm, IntelliJ и т.д.): правый клик → `File Encoding``KOI8-R`
- **nano/vim**: `:set encoding=koi8-r` (vim)
`.editorconfig` в репозитории подскажет IDE открыть KOI8-R файлы с правильной кодировкой автоматически.
##### 2. Через nginx (контейнер/веб-сервер)
Сайт отдаётся через nginx с заголовком:
```
Content-Type: text/html; charset=koi8-r
```
Браузер автоматически декодирует текст корректно. Содержимое отображается правильно для конечного пользователя.
### Структура
```
.
├── html/ # Статические файлы сайта
│ ├── index.htm # Промежуточная страница с meta-refresh
│ ├── index1.htm # Главная (frameset)
│ ├── header.htm # Шапка фреймовой структуры
│ ├── nav.htm # Навигация (левая панель)
│ ├── main.htm # Основной контент
│ ├── _b/ # Графические элементы (GIF)
│ ├── _co/ # Раздел "Компании"
│ ├── _pr/ # Раздел "Программные продукты"
│ ├── _ex/ # Раздел "События и новости"
│ ├── _pb/ # Раздел "Публикации"
│ ├── _fr/ # Раздел "Ссылки"
│ ├── _sh/ # Раздел "Поиск"
│ ├── images/ # Баннеры и логотипы
│ ├── robots.txt # Инструкции для поисковых роботов
│ └── favicon.* # Иконки браузера
├── configs/ # Конфигурация nginx
│ ├── cadpoin-ru_1998.conf
│ └── cadpoin-ru_1998_w_ssl.conf
├── .gitignore # Исключение из репозитория
├── .gitattributes # Правила кодировки и обработки файлов
├── .editorconfig # Рекомендации для редакторов
└── README.md # Этот файл
```
### Важные замечания
#### ❌ НЕ делай
-Не переводи файлы в UTF-8 без планомерного миграционного процесса
-Не пересохраняй файлы в редакторе без явного указания `Keep KOI8-R`
-Не игнорируй предупреждения IDE о кодировке
#### ✅ Делай
- ✅ Явно указывай кодировку KOI8-R при открытии файлов
- ✅ Используй `.editorconfig` (IDE будут читать автоматически)
- ✅ Проверяй git diff перед коммитом, чтобы убедиться, что файлы не перекодированы
- ✅ При внесении изменений убеждайся, что IDE сохраняет KOI8-R
### Технический контекст
#### Фреймовая структура (HTML frameset)
Сайт использует устаревший элемент `<frameset>` для разделения layout:
- Левая колонка: `nav.htm` (навигация)
- Верхний блок: `header.htm` (логотип и заголовок)
- Основная область: `main.htm` (контент)
Это типично для веб-дизайна конца 90-х, но не поддерживается современными стандартами. При миграции на современный сайт потребуется переделка HTML-структуры. Тем не менее, браузеры показывают сайт корректно.
#### Meta-refresh редирект
Главная страница (`index.htm`) использует `meta http-equiv="refresh"` для редиректа на `index1.htm`. Это также устаревший подход.
#### Внешние ресурсы
В коде есть ссылки на старые внешние сервисы (счётчики, баннеры):
- `counter.rambler.ru` (архивная служба рейтингов)
- `mail.ru` (счётчик Mail.ru)
- `ir.ru` (InterReklama, старая рекламная сеть)
Эти сервисы могут быть недоступны или нестабильны. Они не влияют на функциональность сайта при корректной обработке ошибок.
### Дальнейшее развитие
Проект может быть расширен в отдельных ветках:
- **`legacy-1998`** — архивная версия в оригинальном виде (текущая ветка)
- **`main`** — версия с миграцией:
- Развертывание в Docker
- Возможно что-то еще (пока не знаю)
## Контакты и лицензия
Автор: *Sergei Erjemin* (это я)
Контакт: `erjemin@gmail.com`
Архив сохранён и перенесён в современную инфраструктуру в 2026 году.
---
**Последнее обновление:** March 27, 2026