mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-18 23:06:58 +00:00
Add FAQ (#2836)
This commit is contained in:
parent
5d240e1898
commit
e37fb6f094
@ -77,6 +77,8 @@ collections:
|
||||
output: true
|
||||
addons:
|
||||
output: true
|
||||
faq:
|
||||
output: true
|
||||
|
||||
# ----------------------- #
|
||||
# 3rd Party Settings #
|
||||
|
16
source/_faq/component.markdown
Normal file
16
source/_faq/component.markdown
Normal file
@ -0,0 +1,16 @@
|
||||
---
|
||||
layout: page
|
||||
title: "Component"
|
||||
description: "My component does not show up"
|
||||
date: 2017-06-18 09:00
|
||||
sidebar: true
|
||||
comments: false
|
||||
sharing: true
|
||||
footer: true
|
||||
ha_category: Configuration
|
||||
---
|
||||
|
||||
|
||||
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.
|
||||
|
||||
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`.
|
13
source/_faq/distutils.markdown
Normal file
13
source/_faq/distutils.markdown
Normal file
@ -0,0 +1,13 @@
|
||||
---
|
||||
layout: page
|
||||
title: "distutils"
|
||||
description: "distutils.errors.DistutilsOptionError: must supply either home or prefix/exec-prefix -- not both"
|
||||
date: 2017-06-18 09:00
|
||||
sidebar: true
|
||||
comments: false
|
||||
sharing: true
|
||||
footer: true
|
||||
ha_category: Installation
|
||||
---
|
||||
|
||||
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.
|
14
source/_faq/libyaml.markdown
Normal file
14
source/_faq/libyaml.markdown
Normal file
@ -0,0 +1,14 @@
|
||||
---
|
||||
layout: page
|
||||
title: "libyaml"
|
||||
description: "libyaml is not found or a compiler error"
|
||||
date: 2017-06-18 09:00
|
||||
sidebar: true
|
||||
comments: false
|
||||
sharing: true
|
||||
footer: true
|
||||
ha_category: Installation
|
||||
---
|
||||
|
||||
|
||||
On a Debian system, install the Python 3 YAML library by `sudo apt-get install python3-yaml`.
|
18
source/_faq/pip.markdown
Normal file
18
source/_faq/pip.markdown
Normal file
@ -0,0 +1,18 @@
|
||||
---
|
||||
layout: page
|
||||
title: "pip"
|
||||
description: "No module named pip"
|
||||
date: 2017-06-18 09:00
|
||||
sidebar: true
|
||||
comments: false
|
||||
sharing: true
|
||||
footer: true
|
||||
ha_category: Installation
|
||||
---
|
||||
|
||||
|
||||
[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:
|
||||
|
||||
```bash
|
||||
$ python3 get-pip.py
|
||||
```
|
22
source/_faq/pip3.markdown
Normal file
22
source/_faq/pip3.markdown
Normal file
@ -0,0 +1,22 @@
|
||||
---
|
||||
layout: page
|
||||
title: "pip3"
|
||||
description: "pip3: command not found"
|
||||
date: 2017-06-18 09:00
|
||||
sidebar: true
|
||||
comments: false
|
||||
sharing: true
|
||||
footer: true
|
||||
ha_category: Installation
|
||||
---
|
||||
|
||||
|
||||
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/).
|
||||
|
||||
If you are able to successfully run `python3 --version` but not `pip3`, install Home Assistant by running the following command instead:
|
||||
|
||||
```bash
|
||||
$ python3 -m pip install homeassistant
|
||||
```
|
||||
|
||||
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`.
|
28
source/faq/index.markdown
Normal file
28
source/faq/index.markdown
Normal file
@ -0,0 +1,28 @@
|
||||
---
|
||||
layout: page
|
||||
title: "FAQ"
|
||||
description: "Home Assistant' FAQ"
|
||||
date: 2015-10-08 19:05
|
||||
sidebar: false
|
||||
comments: false
|
||||
sharing: true
|
||||
footer: true
|
||||
regenerate: true
|
||||
hide_github_edit: true
|
||||
---
|
||||
|
||||
This is a community curated list of frequently asked questions (FAQ) about the installation, setup, and usage of Home Assistant.
|
||||
|
||||
{% assign faq = site.faq | sort: 'title' %}
|
||||
{% assign categories = faq | map: 'ha_category' | uniq | sort %}
|
||||
|
||||
{% for category in categories %}
|
||||
## {% linkable_title {{ category }} %}
|
||||
|
||||
{% for entry in faq %}
|
||||
{% if entry.ha_category == category %}
|
||||
### {% linkable_title {{ entry.description }} %}
|
||||
{{entry.content}}
|
||||
{% endif %}
|
||||
{% endfor %}
|
||||
{% endfor %}
|
Loading…
x
Reference in New Issue
Block a user