diff --git a/sitemap.xml b/sitemap.xml
index d9aa6d8a0a..b0a0cb917f 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -1292,626 +1292,626 @@
https://home-assistant.io/components/alarm_control_panel.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/alarm_control_panel.manual.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/alarm_control_panel.mqtt.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/arduino.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/automation.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/browser.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/camera.foscam.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/camera.generic.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/configurator.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/conversation.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/device_sun_light_trigger.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/device_tracker.actiontec.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/device_tracker.aruba.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/device_tracker.asuswrt.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/device_tracker.ddwrt.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/device_tracker.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/device_tracker.locative.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/device_tracker.luci.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/device_tracker.mqtt.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/device_tracker.netgear.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/device_tracker.nmap_scanner.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/device_tracker.owntracks.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/device_tracker.snmp.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/device_tracker.thomson.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/device_tracker.tomato.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/device_tracker.tplink.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/device_tracker.ubus.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/discovery.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/downloader.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/ecobee.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/group.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/history.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/ifttt.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/ifttt.manything.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/introduction.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/isy994.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/keyboard.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/light.blinksticklight.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/light.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/light.hue.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/light.hyperion.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/light.limitlessled.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/light.rfxtrx.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/light.tellstick.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/light.vera.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/light.wink.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/lock.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/lock.wink.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/logbook.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/media_player.cast.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/media_player.denon.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/media_player.firetv.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/media_player.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/media_player.itunes.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/media_player.kodi.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/media_player.mpd.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/media_player.plex.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/media_player.sonos.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/media_player.squeezebox.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/modbus.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/mqtt.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/notify.file.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/notify.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/notify.instapush.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/notify.nma.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/notify.pushbullet.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/notify.pushover.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/notify.slack.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/notify.smtp.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/notify.syslog.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/notify.telegram.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/notify.xmpp.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/rfxtrx.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/scene.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/script.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.arduino.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.arest.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.bitcoin.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.command_sensor.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.cpuspeed.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.dht.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.ecobee.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.efergy.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.forecast.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.glances.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.modbus.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.mqtt.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.mysensors.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.openweathermap.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.rest.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.rfxtrx.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.rpi_gpio.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.sabnzbd.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.speedtest.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.swiss_public_transport.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.systemmonitor.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.tellstick.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.temper.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.time_date.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.transmission.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.vera.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.wink.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sensor.worldclock.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/shell_command.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/simple_alarm.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/sun.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/switch.arduino.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/switch.arest.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/switch.command_switch.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/switch.edimax.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/switch.hikvision.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/switch.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/switch.modbus.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/switch.mqtt.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/switch.rest.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/switch.rfxtrx.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/switch.rpi_gpio.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/switch.tellstick.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/switch.transmission.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/switch.vera.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/switch.wemo.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/switch.wink.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/tellstick.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/thermostat.ecobee.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/thermostat.heat_control.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/thermostat.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/thermostat.nest.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/thermostat.radiotherm.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/vera.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/verisure.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/wink.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/zone.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/components/zwave.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/demo/frontend.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/demo/index.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/developers/add_new_platform.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/developers/api.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/developers/architecture.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/developers/creating_components.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/developers/credits.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/developers/frontend.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/developers/python_api.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/developers/rest_api.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/developers/website.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/getting-started/android.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/getting-started/automation.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/getting-started/autostart.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/getting-started/configuration.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/getting-started/devices.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/getting-started/presence-detection.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/getting-started/templating.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/getting-started/troubleshooting-configuration.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/getting-started/troubleshooting.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/googlef4f3693c209fe788.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
https://home-assistant.io/static/mdi-demo.html
- 2016-03-26T05:17:56+00:00
+ 2016-03-26T06:15:05+00:00
diff --git a/topics/splitting_configuration/index.html b/topics/splitting_configuration/index.html
index 719c45b299..83360782f7 100644
--- a/topics/splitting_configuration/index.html
+++ b/topics/splitting_configuration/index.html
@@ -117,7 +117,302 @@

-!Coming Soon
+So you’ve been using Home Assistant (HA, hass, or any number of other abbreviations) for a while now and your configuration.yaml file brings people to tears (https://home-assistant.io/cookbook/configuration_yaml_from_bassclarinetl2/) or you simply want to start off with the distributed approach, here’s how to “split the configuration.yaml” into more manageable (read: husmanly readable) pieces.
+
+First off, several community members have sanitized (read: without api keys/passwords etc) versions of their configurations available for viewing:
+
+
+ - https://github.com/bassclarinetl2/HASS
+ - https://github.com/happyleavesaoc/my-home-automation/tree/master/homeassistant
+
+
+As commenting code doesn’t always happen, please read on for the details.
+
+Now despite the logical assumption that the configuration.yaml will be replaced by this process it will in fact remain all be it in a much less cluttered form.
+
+In this lighter version we will still need what could be called the core snippet:
+
+homeassistant:
+ # Name of the location where Home Assistant is running
+ name: My Hass Instance
+ # Location required to calculate the time the sun rises and sets
+ latitude: 37
+ longitude: -121
+ # C for Celcius, F for Fahrenheit
+ temperature_unit: F
+ # Pick yours from here: http://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+ time_zone: America/Los_Angeles
+ customize: !include customize.yaml
+
+
+Note that each line after homeassistant:
is indented two (2) spaces. Since the configuration files in Home Assistant are based on the YAML “language”, indentation and spacing are important. Also note that seemingly strange entry under customize:
.
+
+!include filename.yaml
is the statement that tells Home Assistant to insert the contents of filename.yaml
at that point. This is how we are going to break a monolithic and hard to read file (when it gets big) into more manageable chunks.
+
+Now before we start splitting out the different components, let’s look at the other components (in our example) that will stay in the base file:
+
+#discovery:
+sun:
+#updater:
+history:
+#conversation:
+frontend:
+logbook:
+http:
+ api_password: ImNotTelling!
+ server_port: 8123
+ ssl_certificate: /etc/letsencrypt/live/example.com/fullchain.pem
+ ssl_key: /etc/letsencrypt/live/example.com/privkey.pem
+
+ifttt:
+ key: [nope]
+
+wink:
+ access_token: [wouldn't you]
+ refresh_token: [like to know]
+
+zwave:
+ usb_path: /dev/ttyUSB0
+ config_path: /usr/local/share/python-openzwave/config
+ polling_interval: 10000
+
+#zigbee:
+# device: /dev/ttyUSB1
+# baud: 115200
+
+mqtt:
+ broker: 127.0.0.1
+ port: 8883
+ username: user
+ password: password
+
+As with the core snippet, indentation makes a difference. The component headers (mqtt:
) should be fully left aligned (aka no indent), and the parameters (port:
) should be indented two (2) spaces.
+
+While some of these components can technically be moved to a separate file they are so small or “one off’s” where splitting them off is superfluous. Also, you’ll notice the # symbol (hash/pound). This represents a “comment” as far as the commands are interpreted. Put another way, any line prefixed with a #
will be ignored. This makes breaking up files for human readability really convenient , not to mention turning off features while leaving the entry intact. (Look at the zigbee:
entry above and the sensors entry further down)
+
+Now, lets assume that a blank file has been created in the hass configuration directory for each of the following:
+
+groups.yaml
+zones.yaml
+automation.yaml
+notifications.yaml
+sensors.yaml
+switches.yaml
+scripts.yaml
+media_player.yaml
+device_tracker.yaml
+customize.yaml
+
+
+automation.yaml
will hold all the automation component details
+zones.yaml
will hold the zone component details
+and so forth. These files can be called anything but giving them names that match their function will make things easier to keep track of.
+
+Inside the base configuration file add the following entries:
+
+group: !include groups.yaml
+zone: !include zones.yaml
+automation: !include automation.yaml
+notifications: !include notifications.yaml
+sensor: !include sensors.yaml
+switch: !include switches.yaml
+scripts: !include: scripts.yaml
+media_player: !include media_player.yaml
+device_tracker: !include device_tracker.yaml
+
+Note that there can only be one !include:
for each component so chaining them isn’t going to work. If that sounds like greek, don’t worry about it.
+
+Alright, so we’ve got the single components and the include statements in the base file, what goes in those extra files?
+
+Let’s look at the device_tracker
file from our example:
+
+### device_tracker.yaml
+###
+###
+
+- platform: owntracks
+- platform: nmap_tracker
+ hosts: 192.168.2.0/24
+ home_interval: 3
+
+ track_new_devices: yes
+ interval_seconds: 40
+ consider_home: 120
+
+This small example illustrates how the “split” files work. In this case, we start with a “comment block” identifying the file followed by two (2) device tracker entries (owntracks and nmap). These files follow “style 2” that is to say a fully left aligned leading entry (- platform: owntracks
) followed by the parameter entries indented two (2) spaces.
+
+This (large) sensor configuration gives us another example:
+```
+### sensors.yaml
+###
+###
+###
+##############################################################
+### METEOBRIDGE ####
+### http://meteobridge.com/wiki/index.php/Add-On_Services ####
+### Live Data as Plain text ####
+##############################################################
+
+
+
+##################################
+#### TIME/DATE ####
+##################################
+
+
+ - platform: time_date
+display_options:
+ - ‘time’
+ - ‘date’
+ - platform: worldclock
+time_zone: Etc/UTC
+name: ‘UTC’
+ - platform: worldclock
+time_zone: America/New_York
+name: ‘Ann Arbor’
+ - platform: worldclock
+time_zone: Europe/Vienna
+name: ‘Innsbruck’
+ - platform: worldclock
+time_zone: America/New_York
+name: ‘Ann Arbor’
+```
+
+
+You’ll notice that this example includes a secondary parameter section (under the steam section) as well as a better example of the way comments can be used to break down files into sections.
+
+That about wraps it up.
+
+If you have issues checkout home-assistant.log
in the configuration directory as well as your indentations. If all else fails, head over to the gitter.im chat and ask away.