Skip to content
romanvhtPublic

About

Vue приложение для изучения пород кошек с фотогалереей и поиском

Resources

Stars

5 stars

Watchers

0 watching

Forks

Repository files navigation

Catbook

Catbook - небольшой справочник пород кошек с поиском, подробными характеристиками и фотогалереей.

Сайт написан на Vue 3 и публикуется как набор статики.

Формально это локальный архив датасета The Cat API, так как с самим API начали происходить странности.

Как устроен

Справочник хранится в каталоге data:

  • breeds.json - описания и характеристики пород;
  • images.json - индекс фото по породам;
  • images/ - фото;
  • manifest.json - дата сборки и статистика датасета.

Скрипт подготовки данных загружает материалы из The Cat API. Готовый каталог data является частью репозитория и должен быть в Git.

Подготовка датасета

Понадобится Node.js 20 или новее. После клонирования установите зависимости:

npm install

Windows:

build-dataset.cmd

Linux/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.cmd
CAT_API_KEY=ваш_ключ ./build-dataset.sh

Сначала создаётся временная версия датасета. Каталог data заменяется только после успешной сборки. В режиме add существующие изображения копируются в эту временную версию. Новые фотографии уменьшаются и сжимаются, для списка пород создаются отдельные миниатюры.

Локальный запуск

Windows:

run.cmd

Linux/macOS:

./run.sh

Также можно использовать npm:

npm start

Сайт откроется по адресу http://127.0.0.1:8000.

Локализация

Интерфейс доступен на английском и русском языках. Английский выбран по умолчанию. Все переводы хранятся в:

  • locales/en.json
  • locales/ru.json

Русские описания включены в раздел descriptions файла locales/ru.json. Если для новой породы перевода ещё нет, приложение показывает английский текст из датасета.

После обновления датасета список пород в файлах локализации синхронизируется автоматически. Синхронизацию также можно запустить отдельно:

npm run sync:locales

Сделано romanvht для любителей кошек.

About

Vue приложение для изучения пород кошек с фотогалереей и поиском

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages