创建一个新页面/h1>
对于平台或集成页面,最快的方法是制作现有页面的副本并进行编辑。这集成概述/a>和示例部分/a>自动生成,因此无需添加到这些页面的链接。/p>
请尊敬标准/a>我们有文档。/p>
如果从头开始,则需要添加标头。文档的不同部分可能需要不同的标题。//p>
文件标头的其他键:/p>
有预定义的变量/a>可用,但通常,编写文档时不必使用它们。/p>
要记住几点:/p>
每个平台页面都应包含一个配置示例。该样本必须仅包含必需的/strong>变量使其易于将其复制和粘贴到用户中 这配置变量/strong>部分必须使用 可用密钥:/p>
您可以使用默认标记语法/a>生成语法突出显示的代码。对于内联代码,将您的代码包装在背键中。//p>
当您编写要在终端上执行的代码时,请勿将其前缀 为了配置模板/a>金贾/a>用来。检查文档标准/a>有关更多详细信息。/p>
如果您不逃脱模板,那么它们将被渲染并在网站上显示为空白。/p>
支持HTML的直接使用,但不建议使用。笔记框是一个例外。//p>
请注意,如果您想在HTML块内使用Markdown,则必须被新行包围。/p>
具有与集成的徽标,使集成可以与最终用户快速识别。从文档侧来看,不需要特定的配置来启用徽标,但是,我们的品牌存储库中必须存在徽标。//p>
要添加徽标和图标以进行集成,请在:必威是什么家庭助理品牌/a>。/p>
在页面上显示的其他图像根据其目的存储在各种目录中:/p>
如果要添加一个需要从侧边栏链接的新页面,则需要编辑---/span>
标题:“很棒的传感器”/span>
描述:“ home-assistant.io网络存在”/span>
ha_release:“ 0.38”/span>
ha_category:传感器/span>
ha_iot_class:“本地民意调查”/span>
ha_quality_scale:银/span>
ha_config_flow:true/span>
ha_codeowners:/span>
- '@balloob'/span>
ha_domain:很棒/span>
---/span>
内容...用降价写。/span>
###标题标题/span>
.../span>
标题/code>:此标题应与集成清单文件中书面的集成名称匹配。/li>
ha_release/code>:当包括集成时的释放,例如“ 0.38”。如果当前版本为0.37,则
ha_release/code>0.38。如果是0.30或0.40,请引用
''/code>。/li>
ha_category/code>:该条目用于将集成在集成概述/a>。/li>
ha_iot_class/code>:物联网课/a>是设备行为的分类器。/li>
ha_quality_scale/code>:质量量表/a>是集成质量的代表。/li>
ha_config_flow/code>: 调成
真的/code>如果集成有一个数据输入流/a>,否则。/li>
ha_codeowners/code>:github用户名或团队名称(以
@//code>)负责这种整合的人。这应该与集成清单文件中列出的复论者匹配。//li>
ha_domain/code>:在家庭助理核心中集成的域。必威是什么这必须匹配集成清单文件中的名称。//li>
配置
configuration.yaml/code>文件。/p>
{%配置%} ... {%endConfiguration%}/code>标签。/p>
{% 配置 %}/span>
API_KEY:/span>
描述:访问服务的API键。/span>
必需:正确/span>
类型:字符串/span>
姓名:/span>
描述:在前端使用的名称。/span>
必需:false/span>
默认值:在前端中使用的默认名称。/span>
类型:字符串/span>
监视_Conditions:/span>
描述:在前端显示的条件。/span>
必需:正确/span>
类型:地图/span>
钥匙:/span>
天气:/span>
描述:可读文本摘要。/span>
温度:/span>
描述:当前温度。/span>
{%endConfiguration%}/span>
描述:/code>
:该变量是关于的。/li>
必需的:/code>
:如果需要变量。/li>
必需:true#=>必需/span>
必要:false#=>可选/span>
必需:包含#=>包含/span>
必需:独家#=>独家/span>
必需:这里的任何字符串#=>此处的任何字符串/span>
类型:/code>
:变量的类型。允许的条目:行动/code>,,,,
布尔/code>,,,,
细绳/code>,,,,
整数/code>,,,,
漂浮/code>,,,,
时间/code>,,,,
模板/code>,,,,
device_class/code>,,,,
图标/code>,,,,
地图/code>/
列表/code>(对于条目列表),
日期/code>,,,,
约会时间/code>,,,,
选择器/code>, 和
任何/code>。用于多种可能性
[字符串,整数]/code>。如果您使用
地图/code>/
列表/code>然后应该定义
钥匙:/code>(请参阅
模板/code>传感器/a>例如)。如果您使用
布尔/code>, 然后
默认:/code>必须定义。/li>
嵌入代码
$/code>,因为这很难复制和粘贴命令。但是,当需要区分键入命令和命令输出时,会做出例外。在那些情况下,将命令加上一个
$/code>是必须的。/p>
模板
html
<//span>div/span>班级/span>=//span>'/span>注意警告/span>'/span>>//span>
您需要在路由器上启用telnet。/span>
//span>div/span>>//span><//span>div/span>班级/span>=//span>'/span>注意警告/span>'/span>>//span>
您需要在路由器上启用[** telnet **](https://en.wikipedia.org/wiki/telnet)。/span>
//span>div/span>>//span>图像,图标和徽标
类型/th>
地点/th>
博客/td>
来源/图像/博客/td>
屏幕截图/td>
源/图像/集成/td>
从侧边栏上链接
docs_navigation.html/code>文件中的文件
source/_includes/asides/docs_navigation.html/code>。/p>