Add FAQ (#2836)

_config.yml

@@ -77,6 +77,8 @@ collections:
     output: true
   addons:
     output: true
+  faq:
+    output: true
 
 # ----------------------- #
 #   3rd Party Settings    #

source/_faq/component.markdown

@@ -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`.

source/_faq/distutils.markdown

@@ -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.

source/_faq/libyaml.markdown

@@ -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`.

source/_faq/pip.markdown

@@ -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
+```

source/_faq/pip3.markdown

@@ -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`.

source/faq/index.markdown

@@ -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 %}