Skip to content
phoenixweissPublic

About

Интерактивный словарь редких, сложных и интересных слов русского языка.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Заумникъ

zaumnik.phoenixweiss.me

Заумникъ — интерактивный словарь редких, сложных, необычных и просто интересных слов русского языка. Он помогает быстро понять незнакомое слово, увидеть связанные понятия и постепенно расширять собственный лексикон.

Это не академическая энциклопедия, а живая коллекция, которую удобно изучать и постепенно дополнять. В неё уже перенесена полная авторская подборка названий; готовые определения будут добавляться небольшими, понятными изменениями.

Возможности

  • поиск по словам, определениям, синонимам и антонимам;
  • автоподсказки с управлением клавиатурой;
  • навигация по буквам;
  • отдельная ссылка на каждую словарную статью;
  • переходы между связанными, противоположными и часто путаемыми понятиями;
  • выдача результатов по десять записей;
  • случайное готовое слово для свободного исследования словаря;
  • адаптивный интерфейс без аналитики и внешних запросов.

Разработка

Проект использует Node.js 24.20.0 и Yarn Classic 1.22.22. Версия Node для локального окружения и CI задаётся в .nvmrc. При использовании nvm выполните nvm install и nvm use; в другом менеджере выберите ту же версию.

yarn install
yarn dev

Проверка форматирования, кода, словарных данных, интерфейса и production-сборки:

yarn quality

Словарные данные

Канонические записи находятся в src/data/words: отдельный YAML-файл для каждой представленной буквы. Исходная необработанная подборка хранится только локально в игнорируемой папке tmp/.

Добавить слово (если файла для его первой буквы ещё нет, команда создаст его):

yarn word:add -- "Абулия" --stress "5" --definition "Состояние ослабленной воли."

Допустимы --synonyms, --antonyms, а также связи --related, --opposite и --confused со значениями через запятую.

После ручного изменения YAML словарь необходимо проверить и рассортировать:

yarn words:rebuild
yarn quality

Воспроизвести минимальный начальный набор из локального Markdown:

yarn words:import -- --seed

Полный импорт исходной подборки с прежними описаниями выполняется только явной командой yarn words:import -- --all, а импорт одних названий — командой yarn words:import -- --names-only. Импорт без выбранного режима не изменяет данные.

Подробности:

Стек

  • Vue 3;
  • Vite;
  • Pinia;
  • Vue Router;
  • Sass;
  • ESLint и Prettier;
  • Playwright;
  • Yarn Classic.

Проект написан на обычном JavaScript и совместим со статическим размещением по адресу /zaumnik/.

Для размещения в корне https://zaumnik.phoenixweiss.me/ предусмотрен режим domain:

yarn build:domain
yarn quality:domain

Обычные yarn build и yarn quality используют /zaumnik/. Адрес сайта, пути ресурсов и метаданные выбираются при сборке. Подготовка и порядок подключения описаны в инструкции по домену.

Версии

Версия хранится в VERSION и синхронизируется с package.json только через Bumpster. Конфигурация .bumpsterrc задаёт поток dev → main → tag и возвращает рабочую копию на ветку dev.

Перед bump Bumpster запускает yarn quality. Сам bump, создание тега, push и публикация выполняются только как отдельные явно подтверждённые действия; номера версий вручную не редактируются.

Автор

Создан и поддерживается Павлом Ткачевым (@phoenixweiss).

Лицензия

MIT

About

Интерактивный словарь редких, сложных и интересных слов русского языка.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages