Как жить лучше (версия для России)
Сайт с советами для жизни в порядке выгоды: сколько стоит (деньги, время, сила воли), что даёт (жизнь, деньги, время, свобода) и насколько доказано (уровни A, B, C). Каждая запись написана «простым языком», с цифрами из исследований и со ссылками на источники.
Сайт: https://maxbzd.github.io/HowToLiveBetter/ (репозиторий: https://github.com/maxbzd/HowToLiveBetter).
Сайт — один файл dist/index.html. Он открывается без сервера, внешние только шрифты Google Fonts.
Откуда это
Основа — китайская книга-руководство HowToLiveBetter («高性价比人生指南»), автор eternity4719, лицензия Unlicense (общественное достояние). Мы не копируем её, а переводим и адаптируем под Россию:
- всё, что зависит от страны (законы, суммы, ведомства, телефоны, программы), заменено российским или убрано;
- российские нормы проверены по КонсультантПлюс, ГАРАНТ, Банку России и сайтам ведомств, дата проверки указана в записи (вкладка «В России»);
- записи, у которых нет российского аналога, в сайт не вошли;
- уровень доказательности (A, B, C) взят из оригинала, спорные записи помечены.
Что вошло и что нет, видно в docs/translation-manifest.csv: статус каждой из 630 записей оригинала. Причины для непереведённых записей лежат в tools/triage.json.
Важно
- Это не медицинская и не юридическая консультация. Записи рассказывают, что известно, и не заменяют врача или юриста.
- В записях о лекарствах нет доз. Рецептурные препараты принимают только по назначению врача.
- Законы меняются. Перед действием проверьте актуальную редакцию по ссылке в записи.
- Если вам плохо или вы думаете о том, чтобы навредить себе: психологическая помощь МЧС 8 (495) 989-50-50, экстренные службы 112.
Проверка перед публикацией
Список записей, которые должны посмотреть врач и юрист: docs/review-checklist.md. Он собирается командой python3 tools/review_list.py.
Запуск
python3 tools/mkcontent.py # собрать записи из src/in/*.json в src/gen.js
python3 tools/build.py # собрать dist/index.html
Затем откройте dist/index.html в браузере.
Проверка: pip install -r requirements.txt && playwright install chromium, затем python3 tests/sweep.py (экраны и темы), python3 tests/func.py (работа сайта), python3 tests/layout.py (отступы), python3 tests/perf.py (скорость).
Публикация на GitHub Pages
GitHub Pages умеет отдавать только корень репозитория или папку /docs, а наш сайт лежит в dist/. Поэтому в репозитории есть готовый workflow .github/workflows/pages.yml, который публикует папку dist.
- Выложите проект в репозиторий на GitHub (вместе с готовым
dist/index.html).
- Settings → Pages → Source: GitHub Actions.
- После каждого push в
main сайт обновляется сам: https://maxbzd.github.io/HowToLiveBetter/. Если первый запуск упал до включения Pages, откройте вкладку Actions и нажмите Re-run jobs.
Как устроен проект
source/HowToLiveBetter.html оригинал (630 записей)
src/in/NN_тема.json наши русские записи (правим только их)
tools/mkcontent.py собирает gen.js, сверяет числа с оригиналом
tools/build.py склеивает всё в dist/index.html
tests/sweep.py проверка размеров экрана, тем и ошибок JS
tools/manifest.py статус каждой из 630 записей
Подробные правила и формат записи: CLAUDE.md. Для работы с Claude Code откройте папку проекта и запустите claude.
Лицензия
Unlicense (общественное достояние), как и у оригинала. Копируйте, правьте и публикуйте свободно. Юридическую и медицинскую ответственность за решения, принятые по записям, проект не несёт.
