2.0 KiB
layout, title, description, date, sidebar, comments, sharing, footer
| layout | title | description | date | sidebar | comments | sharing | footer |
|---|---|---|---|---|---|---|---|
| page | Website home-assistant.io | home-assistant.io web presence | 2015-06-17 08:00 | false | false | true | true |
The home of Home Assistant is 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 is using Octopress. To get more details, please checkout the 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 alike.
To work on the website the process is no different to working on Home Assistant itself.
- Fork the home-assistant.io git repository.
- Create/edit/update a page.
- To test changes to home-assistant.io locally, run
rake previewand navigate to http://127.0.0.1:4000. - Create a Pull Request against the master branch of home-assistant.io.
For a component page it would be the fastest way to make a copy of an existing page and edit it.
Code
To take advantage of the build-in features of Octopress to display code snipplets, just use the default markdown syntax.
Here goes the code...
Images, icons, and logos
The images which are displayed on the pages are stored in various directories according their purpose.
| Type | Location |
|---|---|
| screen shots | source/images/screenshots |
| logos | source/images/supported_brands |
No everything has a logo, to show something we are using the Gnome Icon Theme from the GNOME Project as a source for the placeholders. Those icon are licensed under the GNU LGPL v.3 or Creative Commons BY-SA 3.0 license.