html search: show warning if [role=main] element not found

sphinx-doc · Feb 22, 2020 · 73fd75f · 73fd75f
1 parent 792b578
commit 73fd75f
Showing 1 changed file with 3 additions and 1 deletion.
diff --git a/sphinx/themes/basic/static/searchtools.js b/sphinx/themes/basic/static/searchtools.js
@@ -64,7 +64,9 @@ var Search = {
       $(htmlElement).find('.headerlink').remove();
       docContent = $(htmlElement).find('[role=main]')[0];
       if(docContent === undefined) {
-        return "";
+          console.warn("Content block not found. Sphinx search tries to obtain it " +
+                       "via '[role=main]'. Could you check your theme or template.");
+          return "";
       }
       return docContent.textContent || docContent.innerText;
   },