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 的依赖管理工具),用于安装 gems 并运行本地预览服务器,具体步骤见贡献者文档。
为什么网站构建有时会很慢?每次发布新版本后,由于包含大量长篇更新日志的博客文章,网站生成速度会明显变慢;仓库提供了工具,可以临时排除你暂时不需要处理的文章,并在完成后再恢复。
在哪里可以查看正式站点与正在进行中的修改?正式站点跟踪 current 分支,测试版跟踪 rc 分支,开发版跟踪 next 分支;每个拉取请求还会在其第一条评论中附带一个 Netlify 预览部署链接。
大小
1.2 GB
星标
10.2K
更新
提交Nov 17
时长
11年
提交 · 90 天