Skip to content

Commit e37fb6f

Browse files
fabaffballoob
fabaff
authored and
balloob
committed
1 parent 5d240e1 commit e37fb6f

File tree

7 files changed

+113
-0
lines changed

7 files changed

+113
-0
lines changed

‎_config.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,6 +77,8 @@ collections:
7777
output: true
7878
addons:
7979
output: true
80+
faq:
81+
output: true
8082

8183
# ----------------------- #
8284
# 3rd Party Settings #

‎source/_faq/component.markdown

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
---
2+
layout: page
3+
title: "Component"
4+
description: "My component does not show up"
5+
date: 2017-06-18 09:00
6+
sidebar: true
7+
comments: false
8+
sharing: true
9+
footer: true
10+
ha_category: Configuration
11+
---
12+
13+
14+
When a component does not show up, many different things can be the case. Before you try any of these steps, make sure to look at the `home-assistant.log` file and see if there are any errors related to your component you are trying to set up.
15+
16+
If you have incorrect entries in your configuration files you can use the `check_config` script to assist in identifying them: `hass --script check_config`.

‎source/_faq/distutils.markdown

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
layout: page
3+
title: "distutils"
4+
description: "distutils.errors.DistutilsOptionError: must supply either home or prefix/exec-prefix -- not both"
5+
date: 2017-06-18 09:00
6+
sidebar: true
7+
comments: false
8+
sharing: true
9+
footer: true
10+
ha_category: Installation
11+
---
12+
13+
This is a known issue if you're on a Mac using Homebrew to install Python. Please follow [these instructions](https://github.com/Homebrew/brew/blob/master/docs/Homebrew-and-Python.md#note-on-pip-install---user) to resolve it.

‎source/_faq/libyaml.markdown

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
---
2+
layout: page
3+
title: "libyaml"
4+
description: "libyaml is not found or a compiler error"
5+
date: 2017-06-18 09:00
6+
sidebar: true
7+
comments: false
8+
sharing: true
9+
footer: true
10+
ha_category: Installation
11+
---
12+
13+
14+
On a Debian system, install the Python 3 YAML library by `sudo apt-get install python3-yaml`.

‎source/_faq/pip.markdown

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
layout: page
3+
title: "pip"
4+
description: "No module named pip"
5+
date: 2017-06-18 09:00
6+
sidebar: true
7+
comments: false
8+
sharing: true
9+
footer: true
10+
ha_category: Installation
11+
---
12+
13+
14+
[Pip](https://pip.pypa.io/en/stable/) should come bundled with the latest Python 3 but is omitted by some distributions. If you are unable to run `python3 -m pip --version` you can install `pip` by [downloading the installer](https://bootstrap.pypa.io/get-pip.py) and running it with Python 3:
15+
16+
```bash
17+
$ python3 get-pip.py
18+
```

‎source/_faq/pip3.markdown

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
layout: page
3+
title: "pip3"
4+
description: "pip3: command not found"
5+
date: 2017-06-18 09:00
6+
sidebar: true
7+
comments: false
8+
sharing: true
9+
footer: true
10+
ha_category: Installation
11+
---
12+
13+
14+
This utility should have been installed as part of the Python 3.4 installation. Check if Python 3.4 is installed by running `python3 --version`. If it is not installed, [download it here](https://www.python.org/getit/).
15+
16+
If you are able to successfully run `python3 --version` but not `pip3`, install Home Assistant by running the following command instead:
17+
18+
```bash
19+
$ python3 -m pip install homeassistant
20+
```
21+
22+
On a Debian system, you can also install python3 by `sudo apt-get install python3`d and pip3 by `sudo apt-get install python3-pip`.

‎source/faq/index.markdown

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
---
2+
layout: page
3+
title: "FAQ"
4+
description: "Home Assistant' FAQ"
5+
date: 2015-10-08 19:05
6+
sidebar: false
7+
comments: false
8+
sharing: true
9+
footer: true
10+
regenerate: true
11+
hide_github_edit: true
12+
---
13+
14+
This is a community curated list of frequently asked questions (FAQ) about the installation, setup, and usage of Home Assistant.
15+
16+
{% assign faq = site.faq | sort: 'title' %}
17+
{% assign categories = faq | map: 'ha_category' | uniq | sort %}
18+
19+
{% for category in categories %}
20+
## {% linkable_title {{ category }} %}
21+
22+
{% for entry in faq %}
23+
{% if entry.ha_category == category %}
24+
### {% linkable_title {{ entry.description }} %}
25+
{{entry.content}}
26+
{% endif %}
27+
{% endfor %}
28+
{% endfor %}

0 commit comments

Comments
 (0)