Add meta tag configuration, closes #1874

assets/js/search-bar.js

@@ -40,6 +40,16 @@ export function focusSearchInput () {
 function addEventListeners () {
   const searchInput = qs(SEARCH_INPUT_SELECTOR)
 
+  if (document.querySelector('meta[name="exdoc:autocomplete"][content="off"]')) {
+    searchInput.addEventListener('keydown', event => {
+      if (event.key === 'Enter') {
+        handleAutocompleteFormSubmission(event)
+      }
+    })
+
+    return true
+  }
+
   searchInput.addEventListener('keydown', event => {
     const macOS = isMacOS()
 
@@ -117,7 +127,9 @@ function handleAutocompleteFormSubmission (event) {
   if (autocompleteSuggestion) {
     anchor.setAttribute('href', autocompleteSuggestion.link)
   } else {
-    anchor.setAttribute('href', `search.html?q=${encodeURIComponent(searchInput.value)}`)
+    const meta = document.querySelector('meta[name="exdoc:full-text-search-url"]')
+    const url = meta ? meta.getAttribute('content') : 'search.html?q='
+    anchor.setAttribute('href', `${url}${encodeURIComponent(searchInput.value)}`)
   }
 
   anchor.click()

lib/mix/tasks/docs.ex

@@ -276,6 +276,17 @@ defmodule Mix.Tasks.Docs do
   custom group will be listed under the default "Functions" and "Callbacks"
   group respectively.
 
+  ## Meta-tags configuration
+
+  It is also possible to configure some of ExDoc behaviour using meta tags.
+  These meta tags can be inserted using `before_closing_head_tag`.
+
+    * `exdoc:autocomplete` - when set to "off", it disables autocompletion.
+
+    * `exdoc:full-text-search-url` - the URL to use when performing full text
+      search. The search string will be prepended to the URL as a parameter.
+      It defaults to ExDoc's auto-generated search page.
+
   ## Nesting
 
   ExDoc also allows module names in the sidebar to appear nested under a given