set up hash redirects for all old components sections

Author: chrisvfritz

_config.yml

@@ -187,4 +187,3 @@ alias:
   examples/svg.html: v2/examples/svg.html
   examples/todomvc.html: v2/examples/todomvc.html
   examples/tree-view.html: v2/examples/tree-view.html
-

src/v2/guide/components.md

@@ -434,7 +434,7 @@ Now `v-model` should work perfectly with this component:
 
 That's all you need to know about custom component events for now, but once you've finished reading this page and feel comfortable with its content, we recommend coming back later to read the full guide on [Custom Events](components-custom-events.html).
 
-## Slots
+## Content Distribution with Slots
 
 Just like with HTML elements, it's often useful to be able to pass content to a component, like this:
 
@@ -564,6 +564,8 @@ In the example above, `currentTabComponent` can contain either:
 
 See [this fiddle](https://jsfiddle.net/chrisvfritz/o3nycadu/) to experiment with the full code, or [this version](https://jsfiddle.net/chrisvfritz/b2qj69o1/) for an example binding to a component's options object, instead of its registered name.
 
+That's all you need to know about dynamic components for now, but once you've finished reading this page and feel comfortable with its content, we recommend coming back later to read the full guide on [Dynamic & Async Components](components-dynamic-async.html).
+
 ## DOM Template Parsing Caveats
 
 Some HTML elements, such as `<ul>`, `<ol>`, `<table>` and `<select>` have restrictions on what elements can appear inside them, and some elements such as `<li>` and `<option>` can only appear inside certain other elements.

themes/vue/source/js/common.js

@@ -1,4 +1,5 @@
 (function () {
+  initHashLevelRedirects()
   initMobileMenu()
   initVideoModal()
   if (PAGE_TYPE) {
@@ -8,6 +9,95 @@
     initLocationHashFuzzyMatching()
   }
 
+  // Most redirects should be specified in Hexo's
+  // _config.yml. However, it can't handle hash-level
+  // redirects, such as:
+  //
+  // /foo#hello -> /bar#hello
+  //
+  // For these cases where a section on one page has
+  // moved to a perhaps differently-named section on
+  // another page, we need this.
+  function initHashLevelRedirects() {
+    checkForHashRedirect(/components\.html$/, {
+      'What-are-Components': '/v2/guide/components.html',
+      'Using-Components': '/v2/guide/components-registration.html',
+      'Global-Registration':
+        '/v2/guide/components-registration.html#Global-Registration',
+      'Local-Registration':
+        '/v2/guide/components-registration.html#Local-Registration',
+      'Composing-Components':
+        '/v2/guide/components.html#Organizing-Components',
+      Props:
+        '/v2/guide/components.html#Passing-Data-to-Child-Components-with-Props',
+      'Passing-Data-with-Props':
+        '/v2/guide/components.html#Passing-Data-to-Child-Components-with-Props',
+      'camelCase-vs-kebab-case':
+        '/v2/guide/components-props.html#Prop-Casing-camelCase-vs-kebab-case',
+      'Dynamic-Props':
+        '/v2/guide/components-props.html#Static-and-Dynamic-Props',
+      'Literal-vs-Dynamic':
+        '/v2/guide/components-props.html#Static-and-Dynamic-Props',
+      'One-Way-Data-Flow':
+        '/v2/guide/components-props.html#One-Way-Data-Flow',
+      'Prop-Validation': '/v2/guide/components-props.html#Prop-Validation',
+      'Non-Prop-Attributes':
+        '/v2/guide/components-props.html#Non-Prop-Attributes',
+      'Replacing-Merging-with-Existing-Attributes':
+        '/v2/guide/components-props.html#Replacing-Merging-with-Existing-Attributes',
+      'Custom-Events':
+        '/v2/guide/components.html#Sending-Messages-to-Parents-with-Events',
+      'Using-v-on-with-Custom-Events':
+        '/v2/guide/components.html#Sending-Messages-to-Parents-with-Events',
+      'Binding-Native-Events-to-Components':
+        '/v2/guide/components-custom-events.html#Binding-Native-Events-to-Components',
+      'sync-Modifier':
+        '/v2/guide/components-custom-events.html#sync-Modifier',
+      'Form-Input-Components-using-Custom-Events':
+        '/v2/guide/components-custom-events.html#Binding-Native-Events-to-Components',
+      'Customizing-Component-v-model':
+        '/v2/guide/components-custom-events.html#Customizing-Component-v-model',
+      'Non-Parent-Child-Communication': '/v2/guide/state-management.html',
+      'Compilation-Scope':
+        '/v2/guide/components-slots.html#Compilation-Scope',
+      'Single-Slot': '/v2/guide/components-slots.html#Slot-Content',
+      'Named-Slots': '/v2/guide/components-slots.html#Named-Slots',
+      'Scoped-Slots': '/v2/guide/components-slots.html#Scoped-Slots',
+      'Dynamic-Components': '/v2/guide/components.html#Dynamic-Components',
+      'keep-alive':
+        '/v2/guide/components-dynamic-async.html#keep-alive-with-Dynamic-Components',
+      Misc: '/v2/guide/components-edge-cases.html',
+      'Authoring-Reusable-Components':
+        '/v2/guide/components.html#Organizing-Components',
+      'Child-Component-Refs':
+        '/v2/guide/components-edge-cases.html#Accessing-Child-Component-Instances-amp-Child-Elements',
+      'Async-Components':
+        '/v2/guide/components-dynamic-async.html#Async-Components',
+      'Advanced-Async-Components':
+        '/v2/guide/components-dynamic-async.html#Handling-Loading-State',
+      'Component-Naming-Conventions':
+        '/v2/guide/components-registration.html#Component-Names',
+      'Recursive-Components':
+        '/v2/guide/components-edge-cases.html#Recursive-Components',
+      'Circular-References-Between-Components':
+        '/v2/guide/components-edge-cases.html#Circular-References-Between-Components',
+      'Inline-Templates':
+        '/v2/guide/components-edge-cases.html#Inline-Templates',
+      'X-Templates': '/v2/guide/components-edge-cases.html#X-Templates',
+      'Cheap-Static-Components-with-v-once':
+        '/v2/guide/components-edge-cases.html#Cheap-Static-Components-with-v-once'
+    })
+    function checkForHashRedirect(pageRegex, redirects) {
+      // Abort if the current page doesn't match the page regex
+      if (!pageRegex.test(window.location.pathname)) return
+
+      var redirectPath = redirects[window.location.hash.slice(1)]
+      if (redirectPath) {
+        window.location.href = window.location.origin + redirectPath
+      }
+    }
+  }
+
   function initApiSpecLinks () {
     var apiContent = document.querySelector('.content.api')
     if (apiContent) {