The website you’re reading now is the home of Home Assistant: https://home-assistant.io. This is the place where we provide documentation and additional details about Home Assistant for end users and developers.
-
home-assistant.io uses the Octopress framework for Jekyll. To get more details, please checkout the Octopress documentation.
-That means that creating a new page is simple. The pages are written in markdown; you don’t need to care about HTML or the like.
+
home-assistant.io is built using Jekyll. The pages are written in markdown; to add a page you don’t need to know about HTML or the like.
-
The process for working on the website is no different from working on Home Assistant itself.
+
The process for working on the website is no different from working on Home Assistant itself. You work on your change and propose it via a pull request.
To test your changes locally, you need to install the Ruby dependencies (gems):
To take advantage of the built-in features of Octopress to display code snippets, just use the default markdown syntax. Please use $ and # if it’s a command and to differ from output.
+
Embedding Code
-
Here goes the code...
+
You can use the default markdown syntax to generate syntax highlighted code. For inline code wrap your code in `. For multi line syntax wrap your code like this:
+
+
\`\`\`yaml
+sensor:
+ platform: template
+\`\`\`
-
If you want to display line numbers, add the following snippet somewhere on your page.
+
Note that you can replace text next to ``` with the language that is within the block.
-
{::optionscoderay_line_numbers="table"/}
-
-
+
When you’re writing code that is to be executed on the terminal, prefix it with $.
Images, icons, and logos
+
The images which are displayed on the pages are stored in various directories according to their purpose.
@@ -141,7 +143,7 @@ That means that creating a new page is simple. The pages are written in
@@ -154,7 +156,6 @@ That means that creating a new page is simple. The pages are written in Not everything (product, component, etc.) has a logo. To show something for internal parts of Home Assistant we are using the Material Design Icons.
-
diff --git a/sitemap.xml b/sitemap.xml
index 3683ee42a3..7034face82 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -1855,62 +1855,62 @@
https://home-assistant.io/demo/frontend.html
-2016-08-22T08:19:33+00:00
+2016-08-22T08:25:00+00:00https://home-assistant.io/demo/index.html
-2016-08-22T08:19:33+00:00
+2016-08-22T08:25:00+00:00https://home-assistant.io/demo/panels/ha-panel-dev-event.html
-2016-08-22T08:19:33+00:00
+2016-08-22T08:25:00+00:00https://home-assistant.io/demo/panels/ha-panel-dev-info.html
-2016-08-22T08:19:33+00:00
+2016-08-22T08:25:00+00:00https://home-assistant.io/demo/panels/ha-panel-dev-service.html
-2016-08-22T08:19:33+00:00
+2016-08-22T08:25:00+00:00https://home-assistant.io/demo/panels/ha-panel-dev-state.html
-2016-08-22T08:19:33+00:00
+2016-08-22T08:25:00+00:00https://home-assistant.io/demo/panels/ha-panel-dev-template.html
-2016-08-22T08:19:33+00:00
+2016-08-22T08:25:00+00:00https://home-assistant.io/demo/panels/ha-panel-history.html
-2016-08-22T08:19:33+00:00
+2016-08-22T08:25:00+00:00https://home-assistant.io/demo/panels/ha-panel-iframe.html
-2016-08-22T08:19:33+00:00
+2016-08-22T08:25:00+00:00https://home-assistant.io/demo/panels/ha-panel-logbook.html
-2016-08-22T08:19:33+00:00
+2016-08-22T08:25:00+00:00https://home-assistant.io/demo/panels/ha-panel-map.html
-2016-08-22T08:19:33+00:00
+2016-08-22T08:25:00+00:00https://home-assistant.io/googlef4f3693c209fe788.html
-2016-08-22T08:19:33+00:00
+2016-08-22T08:25:00+00:00https://home-assistant.io/static/fonts/roboto/DESCRIPTION.en_us.html
-2016-08-22T08:19:34+00:00
+2016-08-22T08:25:00+00:00https://home-assistant.io/static/fonts/robotomono/DESCRIPTION.en_us.html
-2016-08-22T08:19:34+00:00
+2016-08-22T08:25:00+00:00https://home-assistant.io/static/mdi-demo.html
-2016-08-22T08:19:34+00:00
+2016-08-22T08:25:00+00:00