Catbook - небольшой справочник пород кошек с поиском, подробными характеристиками и фотогалереей.
Сайт написан на Vue 3 и публикуется как набор статики.
Формально это локальный архив датасета The Cat API, так как с самим API начали происходить странности.
Справочник хранится в каталоге data:
breeds.json- описания и характеристики пород;images.json- индекс фото по породам;images/- фото;manifest.json- дата сборки и статистика датасета.
Скрипт подготовки данных загружает материалы из The Cat API.
Готовый каталог data является частью репозитория и должен быть в Git.
Понадобится Node.js 20 или новее. После клонирования установите зависимости:
npm installWindows:
build-dataset.cmdLinux/macOS:
chmod +x build-dataset.sh run.sh
./build-dataset.shПо умолчанию скрипт сохраняет уже загруженные фотографии и только дополняет коллекцию до 8 файлов на породу. При необходимости число можно изменить:
npm run build:dataset -- --images-per-breed 8Чтобы удалить прежние фотографии и полностью скачать их заново, используйте режим replace:
npm run build:dataset -- --images-mode replaceРежим add используется по умолчанию. Его можно указать явно:
npm run build:dataset -- --images-mode addПеред сборкой передайте ключ через переменную окружения:
set CAT_API_KEY=ваш_ключ
build-dataset.cmdCAT_API_KEY=ваш_ключ ./build-dataset.shСначала создаётся временная версия датасета. Каталог data заменяется только после успешной сборки.
В режиме add существующие изображения копируются в эту временную версию. Новые фотографии
уменьшаются и сжимаются, для списка пород создаются отдельные миниатюры.
Windows:
run.cmdLinux/macOS:
./run.shТакже можно использовать npm:
npm startСайт откроется по адресу http://127.0.0.1:8000.
Интерфейс доступен на английском и русском языках. Английский выбран по умолчанию. Все переводы хранятся в:
locales/en.jsonlocales/ru.json
Русские описания включены в раздел descriptions файла locales/ru.json. Если для новой
породы перевода ещё нет, приложение показывает английский текст из датасета.
После обновления датасета список пород в файлах локализации синхронизируется автоматически. Синхронизацию также можно запустить отдельно:
npm run sync:localesСделано romanvht для любителей кошек.