home-assistant.io README

README проекта с github.com/home-assistant/home-assistant.io. Одним файлом markdown: README.md.

Discord License: CC BY-NC-SA 4.0

Deploys by netlify

Home Assistant website

This is the source for the Home-Assistant.io website.

Access

You can access the site at the following URLs, depending on the target branch:

Additionally, Netlify provides a preview deployment for every pull request, linked in the first PR comment.

Setup

Setting up to contribute to documentation and the process for submitting pull requests is explained in the contributor documentation.

Site preview

In order to make the preview available on http://127.0.0.1:4000, use the following bundler command:

bundle exec rake preview

If the preview is not running on your local machine, pass the IP of the target machine from where it should be served as a parameter, i.e. to access on http://192.168.0.123:4000:

bundle exec rake preview[192.168.0.123]

Speeding up site generation

Every release we post long changelogs to the website. This slows down generation of the website significantly! We include some tools to temporarily exclude the blog posts that you're not working on out of the way.

bundle exec rake isolate[filename-of-blogpost]

When you're done working on the site, run the following command to move the posts back again:

bundle exec rake integrate

Home Assistant - A project from the Open Home Foundation

home-assistant.io (home-assistant/home-assistant.io)

Ищем в базе…

Что это?Это исходный репозиторий сайта Home-Assistant.io, на котором размещена официальная пользовательская документация для Home Assistant — открытой платформы домашней автоматизации.
Это само приложение Home Assistant или только сайт с документацией?Это только исходный код сайта с документацией, собранного на Jekyll. Само программное обеспечение Home Assistant находится в отдельном репозитории.
Как посмотреть мои изменения в документации локально?После настройки окружения по документации для контрибьюторов запустите команду предпросмотра bundler, которая откроет сайт локально; если предпросмотр открывается с другой машины, передайте её IP-адрес как параметр.
Что нужно установить, чтобы собрать сайт?Нужны Ruby и Bundler (менеджер зависимостей Jekyll) для установки гемов и запуска локального сервера предпросмотра, как описано в документации для контрибьюторов.
Почему сборка сайта иногда идёт медленно?После каждого релиза сборка заметно замедляется из-за длинных записей в блоге со списками изменений; в репозитории есть инструменты, которые временно исключают записи, с которыми вы не работаете, и возвращают их после завершения.
Где посмотреть живой сайт и незавершённые изменения?Рабочий сайт отслеживает ветку current, бета-версия — ветку rc, версия для разработки — ветку next. Для каждого пул-реквеста также создаётся предварительная версия сайта на Netlify, ссылка на которую указана в первом комментарии.
Какие есть похожие проекты?zigbee2mqtt, origami, glasshouse, WLED, esphome, EchoMuse, localthings, echo-dot-assist
Автор
home-assistant
Размер
1.2 GB
Звёзды
10.2K
Обновлён
КоммитNov 17
Возраст
11 г
Коммиты · 90 дней