From 37dc43dc40ce3081cc2edee97bcb0779b06794f9 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 18 Jun 2017 22:43:18 +0200 Subject: [PATCH] Add menu and new entries (#2841) --- source/_faq/after-upgrading.markdown | 16 ++++++++++++++ source/_faq/component.markdown | 3 +-- source/_faq/dependencies.markdown | 13 +++++++++++ source/_faq/distutils.markdown | 5 ++--- source/_faq/libyaml.markdown | 3 +-- source/_faq/pip.markdown | 3 +-- source/_faq/pip3.markdown | 3 +-- .../_faq/problems-with-dependencies.markdown | 14 ++++++++++++ source/_includes/asides/faq_navigation.html | 22 +++++++++++++++++++ source/_includes/site/sidebar.html | 2 ++ source/faq/index.markdown | 5 +++-- 11 files changed, 76 insertions(+), 13 deletions(-) create mode 100644 source/_faq/after-upgrading.markdown create mode 100644 source/_faq/dependencies.markdown create mode 100644 source/_faq/problems-with-dependencies.markdown create mode 100644 source/_includes/asides/faq_navigation.html diff --git a/source/_faq/after-upgrading.markdown b/source/_faq/after-upgrading.markdown new file mode 100644 index 00000000000..1c137fc726f --- /dev/null +++ b/source/_faq/after-upgrading.markdown @@ -0,0 +1,16 @@ +--- +layout: page +title: "After upgrading, your browser login gets stuck" +description: "After upgrading, your browser login gets stuck" +date: 2017-06-18 09:00 +comments: false +sharing: true +footer: true +ha_category: Usage +--- + + +After upgrading to a new version, you may notice your browser gets stuck at the "loading data" login screen. Close the window/tab and go into your browser settings and delete all the cookies for your URL. You can then log back in and it should work. + +Android Chrome +chrome -> settings -> site settings -> storage -> search for your URL for home assistant-> "clear & reset" diff --git a/source/_faq/component.markdown b/source/_faq/component.markdown index e0dc15363a7..0f46cf01cf7 100644 --- a/source/_faq/component.markdown +++ b/source/_faq/component.markdown @@ -1,9 +1,8 @@ --- layout: page -title: "Component" +title: "My component does not show up" description: "My component does not show up" date: 2017-06-18 09:00 -sidebar: true comments: false sharing: true footer: true diff --git a/source/_faq/dependencies.markdown b/source/_faq/dependencies.markdown new file mode 100644 index 00000000000..3e8e5781f8b --- /dev/null +++ b/source/_faq/dependencies.markdown @@ -0,0 +1,13 @@ +--- +layout: page +title: "Dependencies" +description: "Dependencies" +date: 2017-06-18 09:00 +comments: false +sharing: true +footer: true +ha_category: Usage +--- + +The dependencies which are used by Home Assistant are stored in the folder `deps` of the [configuration folder](/docs/configuration/) directory. After an [upgrade](/docs/installation/updating/) the dependences will be upgraded as well. + diff --git a/source/_faq/distutils.markdown b/source/_faq/distutils.markdown index 7b1819cbbbd..75f9a72e615 100644 --- a/source/_faq/distutils.markdown +++ b/source/_faq/distutils.markdown @@ -1,13 +1,12 @@ --- layout: page -title: "distutils" +title: "distutils.errors.DistutilsOptionError" 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. +The problem which leads to `distutils.errors.DistutilsOptionError: must supply either home or prefix/exec-prefix -- not both` 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. diff --git a/source/_faq/libyaml.markdown b/source/_faq/libyaml.markdown index 4f58a051058..59b89bee0b3 100644 --- a/source/_faq/libyaml.markdown +++ b/source/_faq/libyaml.markdown @@ -1,9 +1,8 @@ --- layout: page -title: "libyaml" +title: "libyaml is not found or a compiler error" description: "libyaml is not found or a compiler error" date: 2017-06-18 09:00 -sidebar: true comments: false sharing: true footer: true diff --git a/source/_faq/pip.markdown b/source/_faq/pip.markdown index 6cb31f419f8..45b3d127318 100644 --- a/source/_faq/pip.markdown +++ b/source/_faq/pip.markdown @@ -1,9 +1,8 @@ --- layout: page -title: "pip" +title: "No module named pip" description: "No module named pip" date: 2017-06-18 09:00 -sidebar: true comments: false sharing: true footer: true diff --git a/source/_faq/pip3.markdown b/source/_faq/pip3.markdown index 733336e296e..cb957a7cf43 100644 --- a/source/_faq/pip3.markdown +++ b/source/_faq/pip3.markdown @@ -1,9 +1,8 @@ --- layout: page -title: "pip3" +title: "pip3: command not found" description: "pip3: command not found" date: 2017-06-18 09:00 -sidebar: true comments: false sharing: true footer: true diff --git a/source/_faq/problems-with-dependencies.markdown b/source/_faq/problems-with-dependencies.markdown new file mode 100644 index 00000000000..a2535ee7943 --- /dev/null +++ b/source/_faq/problems-with-dependencies.markdown @@ -0,0 +1,14 @@ +--- +layout: page +title: "Problems with dependencies" +description: "Problems with dependencies" +date: 2017-06-18 09:00 +comments: false +sharing: true +footer: true +ha_category: Usage +--- + +Almost all components have external dependencies to communicate with your devices and services. Sometimes Home Assistant is unable to install the necessary dependencies. If this is the case, it should show up in `home-assistant.log`. + +The first step is trying to restart Home Assistant and see if the problem persists. If it does, look at the log to see what the error is. If you can't figure it out, please [report it](https://github.com/home-assistant/home-assistant/issues) so we can investigate what is going on. diff --git a/source/_includes/asides/faq_navigation.html b/source/_includes/asides/faq_navigation.html new file mode 100644 index 00000000000..68ccac63ebd --- /dev/null +++ b/source/_includes/asides/faq_navigation.html @@ -0,0 +1,22 @@ +
+
+

Entries

+
    +{% assign faq = site.faq | sort: 'title' %} +{% assign categories = faq | map: 'ha_category' | uniq | sort %} + +{% for category in categories %} +
  • + {{ category }} +
      + {% for entry in faq %} + {% if entry.ha_category == category %} +
    • {{ entry.title}}
      • + {% endif %} + {% endfor %} +
    +
    • +{% endfor %} +
+
+
diff --git a/source/_includes/site/sidebar.html b/source/_includes/site/sidebar.html index 9f0cf41e435..289411a118b 100644 --- a/source/_includes/site/sidebar.html +++ b/source/_includes/site/sidebar.html @@ -10,6 +10,8 @@ {% include asides/getting_started_navigation.html | compact_newlines %} {% elsif url_parts[1] == 'docs' %} {% include asides/docs_navigation.html | compact_newlines %} + {% elsif url_parts[1] == 'faq' %} + {% include asides/faq_navigation.html | compact_newlines %} {% elsif url_parts[1] == 'hassio' or url_parts[1] == 'addons' %} {% include asides/hassio_navigation.html | compact_newlines %} {% else %} diff --git a/source/faq/index.markdown b/source/faq/index.markdown index cfa67acbe0e..4cb6498054c 100644 --- a/source/faq/index.markdown +++ b/source/faq/index.markdown @@ -1,9 +1,9 @@ --- layout: page title: "FAQ" -description: "Home Assistant' FAQ" +description: "Home Assistant's FAQ" date: 2015-10-08 19:05 -sidebar: false +sidebar: true comments: false sharing: true footer: true @@ -26,3 +26,4 @@ This is a community curated list of frequently asked questions (FAQ) about the i {% endif %} {% endfor %} {% endfor %} +