Merge remote-tracking branch 'origin/current' into next

2025-07-15 13:26:54 +00:00 · 2019-07-11 14:39:19 -07:00 · 2019-07-11 14:39:19 -07:00 · eb5f18c8fc
commit eb5f18c8fc
parent 305a259d76 1833c32a2c
1549 changed files with 848 additions and 9048 deletions
--- a/34
+++ b/34
@ -1,29 +1,23 @@
 source "https://rubygems.org"

-ruby "> 2.3.0"
+ruby "> 2.5.0"

 group :development do
-  gem 'rake', '~> 10.0'
-  # 3.8.5 throws errors on unfinished liquid tags in excerpts
-  # Wait with upgrade until release https://github.com/jekyll/jekyll/pull/7382
-  gem 'jekyll', '3.8.4'
-  gem 'compass', '~> 0.12'
-  gem 'sass-globbing', '~> 1.0'
-  gem 'stringex', '~> 1.4'
-  gem 'pry'
-
-  # See https://github.com/home-assistant/home-assistant.github.io/pull/3904
-  gem 'rb-inotify', '< 0.9.9'
+  gem 'rake', '12.3.2'
+  gem 'jekyll', '3.8.6'
+  gem 'compass', '1.0.3'
+  gem 'sass-globbing', '1.1.5'
+  gem 'stringex', '2.8.5'
 end

 group :jekyll_plugins do
-  gem 'jekyll-paginate'
-  gem 'jekyll-redirect-from'
-  gem 'jekyll-sitemap'
-  gem 'jekyll-time-to-read'
-  gem 'octopress', '~> 3.0'
-  gem 'octopress-include-tag'
+  gem 'jekyll-paginate', '1.1.0'
+  gem 'jekyll-redirect-from', '0.15.0'
+  gem 'jekyll-sitemap', '1.3.1'
+  gem 'jekyll-time-to-read', '0.1.2'
+  gem 'octopress', '3.0.11'
+  gem 'octopress-include-tag', '1.1.3'
 end

-gem 'sinatra', '~> 1.4.2'
-gem 'nokogiri'
+gem 'sinatra', '2.0.5'
+gem 'nokogiri', '1.10.3'
--- a/Gemfile.lock
+++ b/Gemfile.lock
@ -1,27 +1,33 @@
 GEM
  remote: https://rubygems.org/
  specs:
-    addressable (2.5.2)
+    addressable (2.6.0)
      public_suffix (>= 2.0.2, < 4.0)
-    chunky_png (1.3.8)
-    coderay (1.1.1)
+    chunky_png (1.3.11)
    colorator (1.1.0)
-    compass (0.12.7)
+    compass (1.0.3)
      chunky_png (~> 1.2)
-      fssm (>= 0.2.7)
-      sass (~> 3.2.19)
-    concurrent-ruby (1.1.3)
+      compass-core (~> 1.0.2)
+      compass-import-once (~> 1.0.5)
+      rb-fsevent (>= 0.9.3)
+      rb-inotify (>= 0.9)
+      sass (>= 3.3.13, < 3.5)
+    compass-core (1.0.3)
+      multi_json (~> 1.0)
+      sass (>= 3.3.0, < 3.5)
+    compass-import-once (1.0.5)
+      sass (>= 3.2, < 3.5)
+    concurrent-ruby (1.1.5)
    em-websocket (0.5.1)
      eventmachine (>= 0.12.9)
      http_parser.rb (~> 0.6.0)
    eventmachine (1.2.7)
-    ffi (1.9.25)
+    ffi (1.11.1)
    forwardable-extended (2.6.0)
-    fssm (0.2.10)
    http_parser.rb (0.6.0)
    i18n (0.9.5)
      concurrent-ruby (~> 1.0)
-    jekyll (3.8.4)
+    jekyll (3.8.6)
      addressable (~> 2.4)
      colorator (~> 1.0)
      em-websocket (~> 0.5)
@ -35,26 +41,27 @@ GEM
      rouge (>= 1.7, < 4)
      safe_yaml (~> 1.0)
    jekyll-paginate (1.1.0)
-    jekyll-redirect-from (0.12.1)
-      jekyll (~> 3.3)
-    jekyll-sass-converter (1.3.0)
-      sass (~> 3.2)
-    jekyll-sitemap (1.1.1)
-      jekyll (~> 3.3)
+    jekyll-redirect-from (0.15.0)
+      jekyll (>= 3.3, < 5.0)
+    jekyll-sass-converter (1.5.2)
+      sass (~> 3.4)
+    jekyll-sitemap (1.3.1)
+      jekyll (>= 3.7, < 5.0)
    jekyll-time-to-read (0.1.2)
      jekyll
-    jekyll-watch (2.1.2)
+    jekyll-watch (2.2.1)
      listen (~> 3.0)
    kramdown (1.17.0)
-    liquid (4.0.1)
+    liquid (4.0.3)
    listen (3.1.5)
      rb-fsevent (~> 0.9, >= 0.9.4)
      rb-inotify (~> 0.9, >= 0.9.7)
      ruby_dep (~> 1.2)
    mercenary (0.3.6)
-    method_source (0.8.2)
    mini_portile2 (2.4.0)
-    nokogiri (1.10.1)
+    multi_json (1.13.1)
+    mustermann (1.0.3)
+    nokogiri (1.10.3)
      mini_portile2 (~> 2.4.0)
    octopress (3.0.11)
      jekyll (>= 2.0)
@ -73,57 +80,51 @@ GEM
    octopress-include-tag (1.1.3)
      jekyll (>= 2.0)
      octopress-tag-helpers (~> 1.0)
-    octopress-tag-helpers (1.0.8)
+    octopress-tag-helpers (1.0.9)
      jekyll (>= 2.0)
    pathutil (0.16.2)
      forwardable-extended (~> 2.6)
-    pry (0.10.4)
-      coderay (~> 1.1.0)
-      method_source (~> 0.8.1)
-      slop (~> 3.4)
-    public_suffix (3.0.3)
-    rack (1.6.9)
-    rack-protection (1.5.5)
+    public_suffix (3.1.1)
+    rack (2.0.7)
+    rack-protection (2.0.5)
      rack
-    rake (10.5.0)
+    rake (12.3.2)
    rb-fsevent (0.10.3)
-    rb-inotify (0.9.8)
-      ffi (>= 0.5.0)
+    rb-inotify (0.10.0)
+      ffi (~> 1.0)
    redcarpet (3.4.0)
-    rouge (3.3.0)
+    rouge (3.5.1)
    ruby_dep (1.5.0)
-    safe_yaml (1.0.4)
-    sass (3.2.19)
+    safe_yaml (1.0.5)
+    sass (3.4.25)
    sass-globbing (1.1.5)
      sass (>= 3.1)
-    sinatra (1.4.8)
-      rack (~> 1.5)
-      rack-protection (~> 1.4)
-      tilt (>= 1.3, < 3)
-    slop (3.6.0)
-    stringex (1.5.1)
-    tilt (2.0.8)
+    sinatra (2.0.5)
+      mustermann (~> 1.0)
+      rack (~> 2.0)
+      rack-protection (= 2.0.5)
+      tilt (~> 2.0)
+    stringex (2.8.5)
+    tilt (2.0.9)
    titlecase (0.1.1)

 PLATFORMS
  ruby

 DEPENDENCIES
-  compass (~> 0.12)
-  jekyll (= 3.8.4)
-  jekyll-paginate
-  jekyll-redirect-from
-  jekyll-sitemap
-  jekyll-time-to-read
-  nokogiri
-  octopress (~> 3.0)
-  octopress-include-tag
-  pry
-  rake (~> 10.0)
-  rb-inotify (< 0.9.9)
-  sass-globbing (~> 1.0)
-  sinatra (~> 1.4.2)
-  stringex (~> 1.4)
+  compass (= 1.0.3)
+  jekyll (= 3.8.6)
+  jekyll-paginate (= 1.1.0)
+  jekyll-redirect-from (= 0.15.0)
+  jekyll-sitemap (= 1.3.1)
+  jekyll-time-to-read (= 0.1.2)
+  nokogiri (= 1.10.3)
+  octopress (= 3.0.11)
+  octopress-include-tag (= 1.1.3)
+  rake (= 12.3.2)
+  sass-globbing (= 1.1.5)
+  sinatra (= 2.0.5)
+  stringex (= 2.8.5)

 RUBY VERSION
   ruby 2.6.2p47
--- a/_config.yml
+++ b/_config.yml
@ -155,3 +155,25 @@ disqus_end_date: 2010-01-26 0:00:00

 # Support .well-known directory
 include: [".well-known"]
+
+# Set Front matter defaults
+defaults:
+  # Defaults for all pages
+  - scope:
+      path: ""
+    values:
+      layout: page
+      comments: false
+      footer: true
+      sharing: true
+      sidebar: true
+      featured: false
+  # Defaults for blogs posts
+  - scope:
+      type: posts
+    values:
+      layout: post
+      comments: true
+      footer: true
+      sharing: true
+      sidebar: true
--- a/plugins/category_generator.rb
+++ b/plugins/category_generator.rb
@ -3,13 +3,46 @@
 # Jekyll category page generator.
 # http://recursive-design.com/projects/jekyll-plugins/
 #
-# Version: 0.1.4 (201101061053)
+# Version: 0.2.4 (201210160037)
 #
 # Copyright (c) 2010 Dave Perrett, http://recursive-design.com/
 # Licensed under the MIT license (http://www.opensource.org/licenses/mit-license.php)
 #
 # A generator that creates category pages for jekyll sites.
 #
+# To use it, simply drop this script into the _plugins directory of your Jekyll site. You should
+# also create a file called 'category_index.html' in the _layouts directory of your jekyll site
+# with the following contents (note: you should remove the leading '# ' characters):
+#
+# ================================== COPY BELOW THIS LINE ==================================
+# ---
+# layout: default
+# ---
+#
+# <h1 class="category">{{ page.title }}</h1>
+# <ul class="posts">
+# {% for post in site.categories[page.category] %}
+#     <div>{{ post.date | date_to_html_string }}</div>
+#     <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
+#     <div class="categories">Filed under {{ post.categories | category_links }}</div>
+# {% endfor %}
+# </ul>
+# ================================== COPY ABOVE THIS LINE ==================================
+#
+# You can alter the _layout_ setting if you wish to use an alternate layout, and obviously you
+# can change the HTML above as you see fit.
+#
+# When you compile your jekyll site, this plugin will loop through the list of categories in your
+# site, and use the layout above to generate a page for each one with a list of links to the
+# individual posts.
+#
+# You can also (optionally) generate an atom.xml feed for each category. To do this, copy
+# the category_feed.xml file to the _includes/custom directory of your own project
+# (https://github.com/recurser/jekyll-plugins/blob/master/_includes/custom/category_feed.xml).
+# You'll also need to copy the octopress_filters.rb file into the _plugins directory of your
+# project as the category_feed.xml requires a couple of extra filters
+# (https://github.com/recurser/jekyll-plugins/blob/master/_plugins/octopress_filters.rb).
+#
 # Included filters :
 # - category_links:      Outputs the list of categories as comma-separated <a> links.
 # - date_to_html_string: Outputs the post.date as formatted html, with hooks for CSS styling.
@ -18,64 +51,81 @@
 # - category_dir:          The subfolder to build category pages in (default is 'categories').
 # - category_title_prefix: The string used before the category name in the page title (default is
 #                          'Category: ').
-
-require 'stringex'
-
 module Jekyll

  # The CategoryIndex class creates a single category page for the specified category.
-  class CategoryIndex < Page
+  class CategoryPage < Page

    # Initializes a new CategoryIndex.
    #
+    #  +template_path+ is the path to the layout template to use.
+    #  +site+          is the Jekyll Site instance.
+    #  +base+          is the String path to the <source>.
+    #  +category_dir+  is the String path between <source> and the category folder.
+    #  +category+      is the category currently being processed.
+    def initialize(template_path, name, site, base, category_dir, category)
+      @site  = site
+      @base  = base
+      @dir   = category_dir
+      @name  = name
+
+      self.process(name)
+
+      if File.exist?(template_path)
+        @perform_render = true
+        template_dir    = File.dirname(template_path)
+        template        = File.basename(template_path)
+        # Read the YAML data from the layout page.
+        self.read_yaml(template_dir, template)
+        self.data['category']    = category
+        # Set the title for this page.
+        title_prefix             = site.config['category_title_prefix'] || 'Category: '
+        self.data['title']       = "#{title_prefix}#{category}"
+        # Set the meta-description for this page.
+        meta_description_prefix  = site.config['category_meta_description_prefix'] || 'Category: '
+        self.data['description'] = "#{meta_description_prefix}#{category}"
+      else
+        @perform_render = false
+      end
+    end
+
+    def render?
+      @perform_render
+    end
+
+  end
+
+  # The CategoryIndex class creates a single category page for the specified category.
+  class CategoryIndex < CategoryPage
+
+    # Initializes a new CategoryIndex.
+    #
+    #  +site+         is the Jekyll Site instance.
    #  +base+         is the String path to the <source>.
    #  +category_dir+ is the String path between <source> and the category folder.
    #  +category+     is the category currently being processed.
    def initialize(site, base, category_dir, category)
-      @site = site
-      @base = base
-      @dir  = category_dir
-      @name = 'index.html'
-      self.process(@name)
-      # Read the YAML data from the layout page.
-      self.read_yaml(File.join(base, '_layouts'), 'category_index.html')
-      self.data['category']    = category
-      # Set the title for this page.
-      title_prefix             = site.config['category_title_prefix'] || 'Category: '
-      self.data['title']       = "#{title_prefix}#{category}"
-      # Set the meta-description for this page.
-      meta_description_prefix  = site.config['category_meta_description_prefix'] || 'Category: '
-      self.data['description'] = "#{meta_description_prefix}#{category}"
+      template_path = File.join(base, '_layouts', 'category_index.html')
+      super(template_path, 'index.html', site, base, category_dir, category)
    end

  end

  # The CategoryFeed class creates an Atom feed for the specified category.
-  class CategoryFeed < Page
+  class CategoryFeed < CategoryPage

    # Initializes a new CategoryFeed.
    #
+    #  +site+         is the Jekyll Site instance.
    #  +base+         is the String path to the <source>.
    #  +category_dir+ is the String path between <source> and the category folder.
    #  +category+     is the category currently being processed.
    def initialize(site, base, category_dir, category)
-      @site = site
-      @base = base
-      @dir  = category_dir
-      @name = 'atom.xml'
-      self.process(@name)
-      # Read the YAML data from the layout page.
-      self.read_yaml(File.join(base, '_includes/custom'), 'category_feed.xml')
-      self.data['category']    = category
-      # Set the title for this page.
-      title_prefix             = site.config['category_title_prefix'] || 'Category: '
-      self.data['title']       = "#{title_prefix}#{category}"
-      # Set the meta-description for this page.
-      meta_description_prefix  = site.config['category_meta_description_prefix'] || 'Category: '
-      self.data['description'] = "#{meta_description_prefix}#{category}"
+      template_path = File.join(base, '_includes', 'custom', 'category_feed.xml')
+      super(template_path, 'atom.xml', site, base, category_dir, category)

      # Set the correct feed URL.
-      self.data['feed_url'] = "#{category_dir}/#{name}"
+      self.data['feed_url'] = "#{category_dir}/#{name}" if render?
    end

  end
@ -86,44 +136,37 @@ module Jekyll
    # Creates an instance of CategoryIndex for each category page, renders it, and
    # writes the output to a file.
    #
-    #  +category_dir+ is the String path to the category folder.
-    #  +category+     is the category currently being processed.
-    def write_category_index(category_dir, category)
-      index = CategoryIndex.new(self, self.source, category_dir, category)
-      index.render(self.layouts, site_payload)
-      index.write(self.dest)
-      # Record the fact that this page has been added, otherwise Site::cleanup will remove it.
-      self.pages << index
+    #  +category+ is the category currently being processed.
+    def write_category_index(category)
+      target_dir = GenerateCategories.category_dir(self.config['category_dir'], category)
+      index      = CategoryIndex.new(self, self.source, target_dir, category)
+      if index.render?
+        index.render(self.layouts, site_payload)
+        index.write(self.dest)
+        # Record the fact that this pages has been added, otherwise Site::cleanup will remove it.
+        self.pages << index
+      end

      # Create an Atom-feed for each index.
-      feed = CategoryFeed.new(self, self.source, category_dir, category)
-      feed.render(self.layouts, site_payload)
-      feed.write(self.dest)
-      # Record the fact that this page has been added, otherwise Site::cleanup will remove it.
-      self.pages << feed
+      feed = CategoryFeed.new(self, self.source, target_dir, category)
+      if feed.render?
+        feed.render(self.layouts, site_payload)
+        feed.write(self.dest)
+        # Record the fact that this pages has been added, otherwise Site::cleanup will remove it.
+        self.pages << feed
+      end
    end

    # Loops through the list of category pages and processes each one.
    def write_category_indexes
      if self.layouts.key? 'category_index'
-        dir = self.config['category_dir'] || 'categories'
        self.categories.keys.each do |category|
-          self.write_category_index(File.join(dir, category.to_url), category)
+          self.write_category_index(category)
        end

      # Throw an exception if the layout couldn't be found.
      else
-        raise <<-ERR
-
-
-===============================================
- Error for category_generator.rb plugin
-----------------------------------------------
- No 'category_index.html' in source/_layouts/
- Perhaps you haven't installed a theme yet.
-===============================================
-
-ERR
+        throw "No 'category_index' layout found."
      end
    end

@ -135,10 +178,20 @@ ERR
    safe true
    priority :low

+    CATEGORY_DIR = 'categories'
+
    def generate(site)
      site.write_category_indexes
    end

+    # Processes the given dir and removes leading and trailing slashes. Falls
+    # back on the default if no dir is provided.
+    def self.category_dir(base_dir, category)
+      base_dir = (base_dir || CATEGORY_DIR).gsub(/^\/*(.*)\/*$/, '\1')
+      category = category.gsub(/_|\P{Word}/, '-').gsub(/-{2,}/, '-').downcase
+      File.join(base_dir, category)
+    end
+
  end


@ -151,9 +204,14 @@ ERR
    #  +categories+ is the list of categories to format.
    #
    # Returns string
-    #
    def category_links(categories)
-      categories = categories.sort!.map { |c| category_link c }
+      base_dir = @context.registers[:site].config['category_dir']
+      categories = categories.sort!.map do |category|
+        category_dir = GenerateCategories.category_dir(base_dir, category)
+        # Make sure the category directory begins with a slash.
+        category_dir = "/#{category_dir}" unless category_dir =~ /^\//
+        "<a class='category' href='#{category_dir}/'>#{category}</a>"
+      end

      case categories.length
      when 0
@ -161,7 +219,7 @@ ERR
      when 1
        categories[0].to_s
      else
-        "#{categories[0...-1].join(', ')}, #{categories[-1]}"
+        categories.join(', ')
      end
    end

@ -172,8 +230,9 @@ ERR
    # Returns string
    #
    def category_link(category)
-      dir = @context.registers[:site].config['category_dir']
-      "<a class='category' href='/#{dir}/#{category.to_url}/'>#{category}</a>"
+      base_dir = @context.registers[:site].config['category_dir']
+      category_dir = GenerateCategories.category_dir(base_dir, category)
+      "<a class='category' href='/#{category_dir}/'>#{category}</a>"
    end

    # Outputs the post.date as formatted html, with hooks for CSS styling.
--- a/source/_addons/cec_scan.markdown
+++ b/source/_addons/cec_scan.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "CEC Scanner"
 description: "Scan HDMI CEC devices."
-date: 2017-04-30 13:28
-sidebar: true
-comments: false
-sharing: true
-footer: true
 ---

 Help you to discover the HDMI CEC address. Start the add-on and look into the log to see all connected device on HDMI.
--- a/source/_addons/check_config.markdown
+++ b/source/_addons/check_config.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Check Home Assistant configuration"
 description: "Check your current Home Assistant configuration against a new version."
-date: 2017-04-30 13:28
-sidebar: true
-comments: false
-sharing: true
-footer: true
 ---

 You can use this add-on to check whether your configuration files are valid against the new version of Home Assistant before you actually update your Home Assistant installation. This add-on will help you avoid errors due to breaking changes, resulting in a smooth update.
--- a/source/_addons/configurator.markdown
+++ b/source/_addons/configurator.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "HASS Configurator"
 description: "Browser-based configuration file editor for Home Assistant."
-date: 2018-07-16 14:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 featured: true
 og_image: /images/hassio/screenshots/addon-hass-configurator.png
 ---
--- a/source/_addons/dhcp_server.markdown
+++ b/source/_addons/dhcp_server.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "DHCP server"
 description: "A simple DHCP server."
-date: 2017-04-30 13:28
-sidebar: true
-comments: false
-sharing: true
-footer: true
 ---

 Create a simple DHCP server for your network and allow setting fixed IPs for devices.
--- a/source/_addons/dnsmasq.markdown
+++ b/source/_addons/dnsmasq.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Dnsmasq"
 description: "A simple DNS server."
-date: 2017-04-30 13:28
-sidebar: true
-comments: false
-sharing: true
-footer: true
 ---

 Setup and manage a [Dnsmasq](http://thekelleys.org.uk/dnsmasq/doc.html) DNS server. This allows you to manipulate DNS requests. For example, you can have your Home Assistant domain resolve with an internal address inside your network.
--- a/source/_addons/duckdns.markdown
+++ b/source/_addons/duckdns.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "DuckDNS"
 description: "Automatically update your Duck DNS IP address with integrated HTTPS support via Let's Encrypt."
-date: 2017-04-30 13:28
-sidebar: true
-comments: false
-sharing: true
-footer: true
 featured: true
 ---

--- a/source/_addons/git_pull.markdown
+++ b/source/_addons/git_pull.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Git pull"
 description: "Load and update configuration files for Home Assistant from a GIT repository."
-date: 2017-09-25 14:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 ---

 Load and update configuration files for Home Assistant from a [Git](https://git-scm.com/) repository.
--- a/source/_addons/google_assistant.markdown
+++ b/source/_addons/google_assistant.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Google Assistant"
 description: "Enhance your Hass.io installation with Google Assistant."
-date: 2017-04-30 13:28
-sidebar: true
-comments: false
-sharing: true
-footer: true
 featured: true
 ---

--- a/source/_addons/homematic.markdown
+++ b/source/_addons/homematic.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "HomeMatic"
 description: "HomeMatic hardware support to turn you Home-Assistant into a CCU."
-date: 2017-04-30 13:28
-sidebar: true
-comments: false
-sharing: true
-footer: true
 ---

 Set up a [HomeMatic](https://github.com/eq-3/occu) hardware layer. For learning and handling devices use [Homematic-Manager](https://github.com/hobbyquaker/homematic-manager) > 2.0.
--- a/source/_addons/lets_encrypt.markdown
+++ b/source/_addons/lets_encrypt.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Let's Encrypt"
 description: "Automatically manage your SSL certificate using Let's Encrypt."
-date: 2018-04-18 10:55
-sidebar: true
-comments: false
-sharing: true
-footer: true
 ---

 <p class='note'>
--- a/source/_addons/mariadb.markdown
+++ b/source/_addons/mariadb.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "MariaDB"
 description: "MariaDB Server is one of the most popular database servers in the world."
-date: 2017-04-30 13:28
-sidebar: true
-comments: false
-sharing: true
-footer: true
 ---

 Set up a [MariaDB](https://mariadb.org/) SQL server. It supports multiple databases, users and permission settings. If you want to only connect from inside Home Assistant use `core-mariadb` as the host address.
--- a/source/_addons/mosquitto.markdown
+++ b/source/_addons/mosquitto.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Mosquitto MQTT broker"
 description: "Fast and reliable MQTT broker."
-date: 2017-04-30 13:28
-sidebar: true
-comments: false
-sharing: true
-footer: true
 featured: true
 ---

@ -104,7 +98,7 @@ acl_file /share/mosquitto/accesscontrollist
 3. Create `/share/mosquitto/accesscontrollist` with the contents:
 ```text
 user [YOUR_MQTT_USER]
-topic #
+topic readwrite #
 ```

 The `/share` folder can be accessed via SMB, or on the host filesystem under `/usr/share/hassio/share`.
--- a/source/_addons/nginx_proxy.markdown
+++ b/source/_addons/nginx_proxy.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "NGINX SSL proxy"
 description: "NGINX Home Assistant SSL proxy."
-date: 2017-04-30 13:28
-sidebar: true
-comments: false
-sharing: true
-footer: true
 ---

 Sets up an SSL proxy with NGINX and redirect port 80 to 443. Make sure you have generated a certificate before you start this add-on.
--- a/source/_addons/rpc_shutdown.markdown
+++ b/source/_addons/rpc_shutdown.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "RPC Shutdown"
 description: "Simple way for remote windows shutdowns."
-date: 2017-09-25 14:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 ---

 Allows you to shut down a Windows computer with a service call from Home Assistant.
--- a/source/_addons/samba.markdown
+++ b/source/_addons/samba.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Samba"
 description: "Manage your Home Assistant and custom add-ons over Samba."
-date: 2017-04-30 13:28
-sidebar: true
-comments: false
-sharing: true
-footer: true
 featured: true
 ---

--- a/source/_addons/snips.markdown
+++ b/source/_addons/snips.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Snips.ai"
 description: "Enhance your Hass.io installation with a local voice assistant."
-date: 2018-05-02 13:28
-sidebar: true
-comments: false
-sharing: true
-footer: true
 ---

 [Snips.ai](https://snips.ai/) is an AI-powered voice assistant that runs on the Raspberry Pi 3 and x86 platforms. It runs on-device and is Private by Design.
--- a/source/_addons/ssh.markdown
+++ b/source/_addons/ssh.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "SSH Server"
 description: "Allow logging in remotely to Hass.io using SSH."
-date: 2017-11-03 22:25
-sidebar: true
-comments: false
-sharing: true
-footer: true
 featured: true
 ---

--- a/source/_addons/tellstick.markdown
+++ b/source/_addons/tellstick.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "TellStick"
 description: "Telldus TellStick service enabler and tools."
-date: 2017-12-04 21:31
-sidebar: true
-comments: false
-sharing: true
-footer: true
 ---

 Setting up the [Tellstick](http://telldus.com) service and tools contained in the [telldus-core](http://developer.telldus.com/) package and adding configuration to enable Tellstick and Tellstick Duo to work on your Hass.io.
--- a/source/_components/abode.markdown
+++ b/source/_components/abode.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Abode Home Security"
 description: "Instructions on integrating Abode home security with Home Assistant."
-date: 2017-08-26 0:28
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: abode.jpg
 ha_category:
  - Hub
--- a/source/_components/acer_projector.markdown
+++ b/source/_components/acer_projector.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Acer Projector Switch"
 description: "Instructions on how to integrate Acer Projector switches into Home Assistant."
-date: 2016-05-07 07:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: acer.png
 ha_category:
  - Multimedia
--- a/source/_components/actiontec.markdown
+++ b/source/_components/actiontec.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Actiontec"
 description: "Instructions on how to integrate Actiontec routers into Home Assistant."
-date: 2015-08-30 19:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: actiontec.png
 ha_category:
  - Presence Detection
@ -15,7 +9,6 @@ redirect_from:
 - /components/device_tracker.actiontec/
 ---

-
 This platform allows you to detect presence by looking at connected devices to an [Actiontec](http://www.actiontec.com/) device.

 Supported devices (tested):
--- a/source/_components/adguard.markdown
+++ b/source/_components/adguard.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "AdGuard Home"
 description: "Instructions on how to integrate AdGuard Home with Home Assistant."
-date: 2019-05-31 00:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: adguard.png
 ha_category:
  - Network
--- a/source/_components/ads.markdown
+++ b/source/_components/ads.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "ADS"
 description: Connect Home Assistant to TwinCAT devices via the ADS interface
-date: 2017-12-05 12:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: beckhoff.png
 ha_category:
  - Hub
--- a/source/_components/aftership.markdown
+++ b/source/_components/aftership.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: AfterShip Sensor
 description: "Instructions on how to set up AfterShip sensors within Home Assistant."
-date: 2018-11-24 01:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: aftership.png
 ha_category:
  - Postal Service
--- a/source/_components/air_quality.markdown
+++ b/source/_components/air_quality.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Air Quality"
 description: "Instructions on how to add air quality sensors with Home Assistant"
-date: 2018-11-25 08:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 redirect_from:
  - /components/air_pollutants/
 ha_release: 0.85
--- a/source/_components/airvisual.markdown
+++ b/source/_components/airvisual.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "AirVisual"
 description: "Instructions on how to use AirVisual data within Home Assistant"
-date: 2017-09-06 12:15
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: airvisual.jpg
 ha_category:
  - Health
--- a/source/_components/aladdin_connect.markdown
+++ b/source/_components/aladdin_connect.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Genie Aladdin Connect Cover"
 description: "Instructions how to integrate Genie Aladdin Connect garage door covers into Home Assistant."
-date: 2018-07-26 22:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: aladdin_connect.png
 ha_category:
  - Cover
--- a/source/_components/alarm_control_panel.ifttt.markdown
+++ b/source/_components/alarm_control_panel.ifttt.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "IFTTT Alarm Control Panel"
 description: "Instructions on how to integrate IFTTT-controlled security systems into Home Assistant."
-date: 2018-03-10 21:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: ifttt.png
 ha_category:
  - Alarm
--- a/source/_components/alarm_control_panel.markdown
+++ b/source/_components/alarm_control_panel.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Alarm Control Panels"
 description: "Instructions on how to integrate Alarm Control Panels into Home Assistant."
-date: 2015-10-13 19:10
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: home-assistant.png
 ha_category:
  - Alarm
--- a/source/_components/alarm_control_panel.mqtt.markdown
+++ b/source/_components/alarm_control_panel.mqtt.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "MQTT Alarm Control Panel"
 description: "Instructions on how to integrate MQTT capable Alarm Panels into Home Assistant."
-date: 2015-09-14 19:10
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: mqtt.png
 ha_category:
  - Alarm
--- a/source/_components/alarmdecoder.markdown
+++ b/source/_components/alarmdecoder.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "AlarmDecoder Alarm"
 description: "Instructions on how to integrate a DSC/Honeywell alarm panel with Home Assistant using an AlarmDecoder device."
-date: 2017-04-02 13:28
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: alarmdecoder.png
 ha_category:
  - Alarm
--- a/source/_components/alarmdotcom.markdown
+++ b/source/_components/alarmdotcom.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Alarm.com Alarm Control Panel"
 description: "Instructions on how to integrate Alarm.com into Home Assistant."
-date: 2016-01-14 22:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: alarmdotcom.png
 ha_category:
  - Alarm
--- a/source/_components/alert.markdown
+++ b/source/_components/alert.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Alert"
 description: "Instructions on how to setup automatic alerts within Home Assistant."
-date: 2017-01-15 20:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: home-assistant.png
 ha_category:
  - Automation
--- a/source/_components/alexa.flash_briefings.markdown
+++ b/source/_components/alexa.flash_briefings.markdown
@ -1,16 +1,9 @@
 ---
-layout: page
 title: "Amazon Alexa Flash Briefing"
 description: "Instructions on how to create your Flash Briefing skills with Home Assistant."
-date: 2019-03-14 00:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: amazon-alexa.png
 ha_category:
  - Voice
-featured: false
 ha_release: "0.31"
 ---

--- a/source/_components/alexa.intent.markdown
+++ b/source/_components/alexa.intent.markdown
@ -1,16 +1,9 @@
 ---
-layout: page
 title: "Amazon Alexa Custom Skill"
 description: "Instructions on how to build your Alexa/Amazon Echo custom commands to connect with Home Assistant."
-date: 2015-12-13 13:02
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: amazon-alexa.png
 ha_category:
  - Voice
-featured: false
 ha_release: "0.10"
 ---

--- a/source/_components/alexa.markdown
+++ b/source/_components/alexa.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Amazon Alexa"
 description: "Instructions on how to connect Alexa/Amazon Echo to Home Assistant."
-date: 2015-12-13 13:02
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: amazon-alexa.png
 ha_category:
  - Voice
--- a/source/_components/alexa.smart_home.markdown
+++ b/source/_components/alexa.smart_home.markdown
@ -1,16 +1,9 @@
 ---
-layout: page
 title: "Amazon Alexa Smart Home Skill"
 description: "Instructions on how to build Smart Home skill to connect Amazon Alexa with Home Assistant."
-date: 2019-03-14 00:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: amazon-alexa.png
 ha_category:
  - Voice
-featured: false
 ha_release: "0.54"
 ---

@ -90,7 +83,7 @@ Next you need create a Lambda function.
 - Click `Service` in top navigation bar, expand the menu to display all AWS services, click `Lambda` under `Compute` section to navigate to Lambda console. Or you may use this [link](https://console.aws.amazon.com/lambda/home)
 - **IMPORTANT** Your current region will be displayed on the top right corner, make sure you select right region base on your Amazon account's country:
  * **US East (N.Virginia)** region for English (US) or English (CA) skills
-  * **EU (Ireland)** region for English (UK), English (IN), German or French (FR) skills
+  * **EU (Ireland)** region for English (UK), English (IN), German (DE), Spanish (ES) or French (FR) skills
  * **US West (Oregon)** region for Japanese and English (AU) skills. 
 - Click `Functions` in the left navigation bar, display list of your Lambda functions.
 - Click `Create function`, select `Author from scratch`, then input a `Function name`.
@ -237,6 +230,7 @@ The following is a list of regions and the corresponding URL for the web-based A
 * Canada: <https://alexa.amazon.ca>
 * Australia: <https://alexa.amazon.com.au>
 * India: <https://alexa.amazon.in>
+* Spain: <https://alexa.amazon.es>

 [alexa-dev-console]: https://developer.amazon.com/alexa/console/ask
 [emulated-hue-component]: /components/emulated_hue/
--- a/source/_components/alpha_vantage.markdown
+++ b/source/_components/alpha_vantage.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Alpha Vantage"
 description: "Instructions on how to setup Alpha Vantage within Home Assistant."
-date: 2017-12-02 12:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: alpha_vantage.png
 ha_category:
  - Finance
--- a/source/_components/amazon_polly.markdown
+++ b/source/_components/amazon_polly.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Amazon Polly"
 description: "Instructions on how to setup Amazon Polly with Home Assistant."
-date: 2017-01-28 09:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: polly.png
 ha_category:
  - Text-to-speech
--- a/source/_components/ambiclimate.markdown
+++ b/source/_components/ambiclimate.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Ambiclimate A/C controller"
 description: "Instructions on how to integrate Ambiclimate A/C controller into Home Assistant."
-date: 2019-02-21 15:00 +0200
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: ambiclimate.png
 ha_category: Climate
 ha_release: 0.93
--- a/source/_components/ambient_station.markdown
+++ b/source/_components/ambient_station.markdown
@ -1,10 +1,6 @@
 ---
-layout: page
 title: "Ambient Weather Station Sensor"
 description: "How to integrate Ambient Weather station within Home Assistant."
-date: 2018-11-15 08:00
-sidebar: true
-comments: false
 logo: ambient_weather.png
 ha_category:
  - Weather
--- a/source/_components/amcrest.markdown
+++ b/source/_components/amcrest.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Amcrest IP Camera"
 description: "Instructions on how to integrate Amcrest IP cameras within Home Assistant."
-date: 2017-06-24 10:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: amcrest.png
 ha_category:
  - Hub
--- a/source/_components/ampio.markdown
+++ b/source/_components/ampio.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Ampio Smog"
 description: "Instructions on how to setup Ampio Smog sensors in Home Assistant."
-date: 2019-02-17 00:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: ampio_smog.png
 ha_category:
  - Health
--- a/source/_components/android_ip_webcam.markdown
+++ b/source/_components/android_ip_webcam.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Android IP Webcam"
 description: "Connect Android devices as an IP webcam to Home Assistant"
-date: 2017-03-10 00:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: android_ip_webcam.png
 ha_category:
  - Hub
--- a/source/_components/androidtv.markdown
+++ b/source/_components/androidtv.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Android TV"
 description: "Instructions on how to integrate Android TV and Fire TV devices into Home Assistant."
-date: 2015-10-23 18:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: androidtv.png
 ha_category:
  - Media Player
--- a/source/_components/anel_pwrctrl.markdown
+++ b/source/_components/anel_pwrctrl.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "ANEL PwrCtrl Switch"
 description: "Instructions on how to integrate ANEL PwrCtrl switches within Home Assistant."
-date: 2016-10-02 19:04
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: anel.png
 ha_category:
  - Switch
--- a/source/_components/anthemav.markdown
+++ b/source/_components/anthemav.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Anthem A/V Receivers"
 description: "Instructions on how to integrate Anthem A/V Receivers into Home Assistant."
-date: 2016-12-31 23:11
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: anthemav.png
 ha_category:
  - Media Player
--- a/source/_components/apcupsd.markdown
+++ b/source/_components/apcupsd.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "APCUPSd"
 description: "Instructions on how to integrate APCUPSd status with Home Assistant."
-date: 2016-02-10 17:11
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: apcupsd.png
 ha_category:
  - System Monitor
--- a/source/_components/api.markdown
+++ b/source/_components/api.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "API"
 description: "Instructions on how to setup the RESTful API within Home Assistant."
-date: 2018-01-21 08:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: home-assistant.png
 ha_category:
  - Other
--- a/source/_components/apns.markdown
+++ b/source/_components/apns.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "APNS"
 description: "Instructions on how to add APNS notifications to Home Assistant."
-date: 2016-09-05 23:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: apple.png
 ha_category:
  - Notifications
--- a/source/_components/apple_tv.markdown
+++ b/source/_components/apple_tv.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Apple TV"
 description: "Instructions on how to integrate Apple TV devices into Home Assistant."
-date: 2017-06-26 20:47
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: apple.png
 ha_category:
  - Multimedia
--- a/source/_components/aprs.markdown
+++ b/source/_components/aprs.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "APRS"
 description: "Instructions on how to use APRS to track devices in Home Assistant."
-date: 2018-11-04 00:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: aprs.png
 ha_release: 0.95
 ha_category: Presence Detection
--- a/source/_components/aqualogic.markdown
+++ b/source/_components/aqualogic.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "AquaLogic"
 description: "Instructions on how to integrate an AquaLogic controller within Home Assistant."
-date: 2018-09-17 9:16
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: hayward.png
 ha_category:
  - Hub
--- a/source/_components/aquostv.markdown
+++ b/source/_components/aquostv.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Sharp Aquos TV"
 description: "Instructions on how to integrate a Sharp Aquos TV into Home Assistant."
-date: 2016-11-02 12:02
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: sharp_aquos.png
 ha_category:
  - Media Player
@ -16,7 +10,7 @@ redirect_from:
 - /components/media_player.aquostv/
 ---

-The `aquostv` platform allows you to control a [Sharp Aquos TV](http://www.sharp.ca/en-CA/ForHome/HomeEntertainment/LEDTV/QuattronPlus.aspx).
+The `aquostv` platform allows you to control a [Sharp Aquos TV](http://www.sharp-world.com/aquos/en/index.html).

 When the TV is first connected, you will need to accept Home Assistant on the TV to allow communication.

--- a/source/_components/arduino.markdown
+++ b/source/_components/arduino.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Arduino"
 description: "Instructions on how to setup an Arduino boards within Home Assistant."
-date: 2015-06-27 10:28
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: arduino.png
 ha_category:
  - DIY
--- a/source/_components/arest.markdown
+++ b/source/_components/arest.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "aREST"
 description: "Instructions on how to integrate aREST within Home Assistant."
-date: 2015-11-20 18:15
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: arest.png
 ha_category:
  - DIY
--- a/source/_components/arlo.markdown
+++ b/source/_components/arlo.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Arlo"
 description: "Instructions on how to integrate your Netgear Arlo cameras within Home Assistant."
-date: 2017-05-30 10:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: arlo.png
 ha_category:
  - Hub
--- a/source/_components/aruba.markdown
+++ b/source/_components/aruba.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Aruba"
 description: "Instructions on how to integrate Aruba routers into Home Assistant."
-date: 2015-08-31 08:45
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: aruba.png
 ha_category:
  - Presence Detection
--- a/source/_components/arwn.markdown
+++ b/source/_components/arwn.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "ARWN Sensor"
 description: "Instructions on how to integrate ARWN within Home Assistant."
-date: 2016-10-20 15:15
-sidebar: true
-comments: false
-sharing: true
-footer: true
 ha_category:
  - Sensor
 ha_release: 0.31
--- a/source/_components/asterisk_cdr.markdown
+++ b/source/_components/asterisk_cdr.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Asterisk Call Data Recorder"
 description: "Instructions on how to integrate an Asterisk CDR within Home Assistant."
-date: 2018-09-12 06:30
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: asterisk.png
 ha_category:
  - Mailbox
--- a/source/_components/asterisk_mbox.markdown
+++ b/source/_components/asterisk_mbox.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Asterisk Voicemail"
 description: "Instructions on how to integrate your existing Asterisk voicemail within Home Assistant."
-date: 2017-06-30 18:30
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: asterisk.png
 ha_category:
  - Mailbox
--- a/source/_components/asuswrt.markdown
+++ b/source/_components/asuswrt.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Asuswrt"
 description: "Instructions on how to integrate Asuswrt into Home Assistant."
-date: 2017-01-05 17:30
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: asus.png
 ha_category:
  - Hub
--- a/source/_components/august.markdown
+++ b/source/_components/august.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "August"
 description: "Instructions on how to integrate your August devices into Home Assistant."
-date: 2018-02-17 22:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: august.png
 ha_category:
  - Doorbell
--- a/source/_components/aurora.markdown
+++ b/source/_components/aurora.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Aurora sensor"
 description: "Know when auroras might be visible at your location"
-date: 2017-02-14 10:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 ha_category:
  - Environment
 ha_release: 0.39
--- a/source/_components/auth.markdown
+++ b/source/_components/auth.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Auth"
 description: "This integration is responsible for providing the authentication endpoints."
-date: 2018-03-19 21:04
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: home-assistant.png
 ha_category:
  - Other
--- a/source/_components/automatic.markdown
+++ b/source/_components/automatic.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Automatic"
 description: "Instructions for how to integrate Automatic ODB readers into Home Assistant."
-date: 2015-08-28 19:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: automatic.png
 ha_category:
  - Car
--- a/source/_components/automation.markdown
+++ b/source/_components/automation.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Automation"
 description: "Instructions on how to setup automation within Home Assistant."
-date: 2015-01-20 22:36
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: home-assistant.png
 ha_category:
  - Automation
--- a/source/_components/avion.markdown
+++ b/source/_components/avion.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Avi-on"
 description: "Instructions on how to setup GE Avi-on Bluetooth dimmers within Home Assistant."
-date: 2017-01-17 23:17
-sidebar: true
-comments: false
-sharing: true
-footer: true
 ha_category:
  - Light
 ha_iot_class: Assumed State
--- a/source/_components/awair.markdown
+++ b/source/_components/awair.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Awair Air Quality Monitor"
 description: "Instructions on how to setup Awair devices in Home Assistant."
-date: 2018-11-18 20:41
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: awair.jpg
 ha_category:
  - Health
--- a/source/_components/aws.markdown
+++ b/source/_components/aws.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Amazon Web Services"
 description: "Instructions on how to integrate Amazon Web Services with Home Assistant."
-date: 2019-03-21 00:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: aws.png
 ha_category:
  - Notifications
--- a/source/_components/axis.markdown
+++ b/source/_components/axis.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Axis"
 description: "Integration between network devices from Axis Communications with Home Assistant."
-date: 2017-04-30 23:04
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: axis.png
 ha_category:
  - Camera
--- a/source/_components/azure_event_hub.markdown
+++ b/source/_components/azure_event_hub.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Azure Event Hub"
 description: "Setup for Azure Event Hub integration"
-date: 2019-05-15 08:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: azure_event_hub.svg
 ha_category:
  - History
--- a/source/_components/baidu.markdown
+++ b/source/_components/baidu.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Baidu Text-to-Speech"
 description: "Instructions on how to setup Baidu TTS with Home Assistant."
-date: 2017-11-21 09:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: baiducloud.png
 ha_category:
  - Text-to-speech
--- a/source/_components/bayesian.markdown
+++ b/source/_components/bayesian.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Bayesian Binary Sensor"
 description: "Instructions on how to integrate threshold Bayesian sensors into Home Assistant."
-date: 2017-08-27 20:05
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: home-assistant.png
 ha_category:
  - Utility
--- a/source/_components/bbb_gpio.markdown
+++ b/source/_components/bbb_gpio.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "BeagleBone Black GPIO"
 description: "Instructions on how to integrate the GPIO capability of a BeagleBone Black into Home Assistant."
-date: 2017-01-14 10:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: beaglebone-black.png
 ha_category:
  - DIY
--- a/source/_components/bbox.markdown
+++ b/source/_components/bbox.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Bbox"
 description: "Instructions on how to integrate Bouygues Bbox routers into Home Assistant."
-date: 2016-10-22 01:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: bbox.png
 ha_category:
  - Network
--- a/source/_components/bh1750.markdown
+++ b/source/_components/bh1750.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "BH1750 Light sensor"
 description: "Instructions on how to integrate a BH1750 light sensor into Home Assistant."
-date: 2017-06-10 00:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: raspberry-pi.png
 ha_category:
  - DIY
--- a/source/_components/binary_sensor.knx.markdown
+++ b/source/_components/binary_sensor.knx.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "KNX Binary Sensor"
 description: "Instructions on how to setup the KNX binary sensors within Home Assistant."
-date: 2016-07-13 07:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: knx.png
 ha_category:
  - Binary Sensor
--- a/source/_components/binary_sensor.markdown
+++ b/source/_components/binary_sensor.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Binary Sensor"
 description: "Instructions on how-to setup binary sensors with Home Assistant."
-date: 2015-11-20 14:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: home-assistant.png
 ha_category:
  - Binary Sensor
--- a/source/_components/binary_sensor.modbus.markdown
+++ b/source/_components/binary_sensor.modbus.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Modbus Binary Sensor"
 description: "Instructions on how to set up Modbus binary sensors within Home Assistant."
-date: 2016-09-13 12:02
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: modbus.png
 ha_category:
  - Binary Sensor
--- a/source/_components/binary_sensor.mqtt.markdown
+++ b/source/_components/binary_sensor.mqtt.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "MQTT Binary Sensor"
 description: "Instructions on how to integrate MQTT binary sensors within Home Assistant."
-date: 2015-05-30 23:21
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: mqtt.png
 ha_category:
  - Binary Sensor
--- a/source/_components/binary_sensor.mysensors.markdown
+++ b/source/_components/binary_sensor.mysensors.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "MySensors Binary Sensor"
 description: "Instructions on how to integrate MySensors binary sensors into Home Assistant."
-date: 2016-04-13 14:20 +0100
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: mysensors.png
 ha_category:
  - DIY
--- a/source/_components/binary_sensor.rest.markdown
+++ b/source/_components/binary_sensor.rest.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "RESTful Binary Sensor"
 description: "Instructions on how to integrate REST binary sensors into Home Assistant."
-date: 2015-12-17 19:10
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: restful.png
 ha_category:
  - Binary Sensor
--- a/source/_components/binary_sensor.rflink.markdown
+++ b/source/_components/binary_sensor.rflink.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "RFLink Binary Sensor"
 description: "Instructions on how to integrate RFLink binary sensors into Home Assistant."
-date: 2018-10-04
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: rflink.png
 ha_category:
  - Binary Sensor
--- a/source/_components/binary_sensor.rfxtrx.markdown
+++ b/source/_components/binary_sensor.rfxtrx.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "RFXtrx Binary Sensor"
 description: "Instructions on how to integrate RFXtrx binary sensors into Home Assistant."
-date: 2017-03-26 12:45
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: rfxtrx.png
 ha_category:
  - Binary Sensor
--- a/source/_components/binary_sensor.template.markdown
+++ b/source/_components/binary_sensor.template.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Template Binary Sensor"
 description: "Instructions on how to integrate Template Binary Sensors into Home Assistant."
-date: 2016-02-25 15:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 ha_category:
  - Binary Sensor
 ha_release: 0.12
--- a/source/_components/binary_sensor.xiaomi_aqara.markdown
+++ b/source/_components/binary_sensor.xiaomi_aqara.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Xiaomi Binary Sensor"
 description: "Instructions on how to setup the Xiaomi binary sensors within Home Assistant."
-date: 2017-07-21 16:34
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: xiaomi.png
 ha_category:
  - Binary Sensor
--- a/source/_components/bitcoin.markdown
+++ b/source/_components/bitcoin.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Bitcoin"
 description: "Instructions on how to integrate Bitcoin data within Home Assistant."
-date: 2015-05-08 17:15
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: bitcoin.png
 ha_category:
  - Finance
--- a/source/_components/bizkaibus.markdown
+++ b/source/_components/bizkaibus.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Bizkaibus next bus tracking sensor"
 description: "Instructions on how to integrate timetable data for traveling on Bizkaibus within Home Assistant."
-date: 2019-04-22 14:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: bizkaibus.png
 ha_category: 
  - Transport
--- a/source/_components/blackbird.markdown
+++ b/source/_components/blackbird.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Blackbird 8x8 HDMI Matrix Switch"
 description: "Instructions on how to integrate Monoprice Blackbird 4k 8x8 HDBaseT Matrix Switch into Home Assistant."
-date: 2018-03-29 16:35
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: monoprice.svg
 ha_category:
  - Media Player
--- a/source/_components/blink.markdown
+++ b/source/_components/blink.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Blink"
 description: "Instructions for how to integrate Blink camera/security system within Home Assistant."
-date: 2017-03-05 22:13
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: blink.png
 ha_category:
  - Hub
@ -160,7 +154,7 @@ The following are some examples showing how to correctly make service calls usin

 ### Snap Picture and Save Locally

-This example script shows how to take a picture with your camera, named `My Camera` in your Blink app (this is **not necessarily** the friendly name in home-assistant).  After snapping a picture, the image will then be saved to a local directory called `/tmp/my_image.jpg`.  Note that this example makes use of services found in the [camera integration](https://www.home-assistant.io/components/camera#service-snapshot)
+This example script shows how to take a picture with your camera, named `My Camera` in your Blink app (this is **not necessarily** the friendly name in home-assistant).  After snapping a picture, the image will then be saved to a local directory called `/tmp/my_image.jpg`.  Note that this example makes use of services found in the [camera integration](/components/camera#service-snapshot)

 ```yaml
 alias: Blink Snap Picture
@ -178,9 +172,9 @@ sequence:

 ### Arm Blink When Away

-This example automation will arm your blink sync module to detect motion on any of your blink cameras that have motion detection enabled.  By default, Blink enables motion detection on all cameras so, unless you've changed anything in your app, you're all set.  If you want to manually enable motion detection for individual cameras, you can utilize the [appropriate camera service](https://www.home-assistant.io/components/camera#service-enable_motion_detection) but pelase note that motion will only be captured if the sync module is armed.
+This example automation will arm your blink sync module to detect motion on any of your blink cameras that have motion detection enabled.  By default, Blink enables motion detection on all cameras so, unless you've changed anything in your app, you're all set.  If you want to manually enable motion detection for individual cameras, you can utilize the [appropriate camera service](/components/camera#service-enable_motion_detection) but pelase note that motion will only be captured if the sync module is armed.

-Here, this example assumes your blink module is named `My Sync Module` and that you have [device trackers](https://www.home-assistant.io/components/device_tracker) set up for presence detection.
+Here, this example assumes your blink module is named `My Sync Module` and that you have [device trackers](/components/device_tracker) set up for presence detection.

 ```yaml
 - id: arm_blink_when_away
@ -214,7 +208,7 @@ Similar to the previous example, this automation will disarm blink when arriving

 When motion is detected, you can use the Blink Home-Assistant integration to save the last recorded video locally, rather than relying on Blink's servers to save your data.

-Again, this example assumes your camera's name (in the blink app) is `My Camera` and your sync module name is `My Sync Module`.  The file will be saved to `/tmp/videos/blink_video_{YYYMMDD_HHmmSS}.mp4` where `{YYYYMMDD_HHmmSS}` will be a timestamp create via the use of [templating](https://www.home-assistant.io/docs/configuration/templating/).
+Again, this example assumes your camera's name (in the blink app) is `My Camera` and your sync module name is `My Sync Module`.  The file will be saved to `/tmp/videos/blink_video_{YYYMMDD_HHmmSS}.mp4` where `{YYYYMMDD_HHmmSS}` will be a timestamp create via the use of [templating](/docs/configuration/templating/).

 {% raw %}
 ```yaml
--- a/source/_components/blinksticklight.markdown
+++ b/source/_components/blinksticklight.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Blinkstick Light"
 description: "Instructions on how to setup Blinkstick lights within Home Assistant."
-date: 2015-10-08 10:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: blinkstick.png
 ha_category:
  - DIY
--- a/source/_components/blinkt.markdown
+++ b/source/_components/blinkt.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Blinkt! Light"
 description: "Instructions on how to setup Blinkt! RGB LED lights within Home Assistant."
-date: 2017-04-30 9:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: raspberry-pi.png
 ha_category:
  - DIY
--- a/source/_components/blockchain.markdown
+++ b/source/_components/blockchain.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Blockchain.info"
 description: "Instructions on how to integrate Blockchain.info data within Home Assistant."
-date: 2017-06-01 16:20
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: blockchain.png
 ha_category:
  - Finance
--- a/source/_components/bloomsky.markdown
+++ b/source/_components/bloomsky.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "BloomSky"
 description: "Instructions on how to integrate the BloomSky within Home Assistant."
-date: 2016-02-03 20:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: bloomsky.png
 ha_category:
  - Environment
--- a/source/_components/bluesound.markdown
+++ b/source/_components/bluesound.markdown
@ -1,12 +1,6 @@
 ---
-layout: page
 title: "Bluesound"
 description: "Instructions on how to integrate Bluesound devices into Home Assistant."
-date: 2017-04-21 19:00
-sidebar: true
-comments: false
-sharing: true
-footer: true
 logo: bluesound.png
 ha_category:
  - Media Player
--- a/Show More
+++ b/Show More