Merge branch 'master' of github.com:squidfunk/mkdocs-material

docs/setup/setting-up-site-analytics.md

@@ -274,18 +274,39 @@ generated by users interacting with the feedback widget with the help of some
 
     ``` js
     var feedback = document.forms.feedback
+    feedback.hidden = false // (1)!
+
     feedback.addEventListener("submit", function(ev) {
       ev.preventDefault()
 
-      /* Retrieve page and feedback value */
-      var page = document.location.pathname
+      var page = document.location.pathname // (2)!
       var data = ev.submitter.getAttribute("data-md-value")
 
-      /* Send feedback value */
-      console.log(page, data)
+      console.log(page, data) // (3)!
+
+      feedback.firstElementChild.disabled = true // (4)!
+
+      var note = feedback.querySelector(
+        ".md-feedback__note [data-md-value='" + data + "']"
+      )
+      if (note)
+        note.hidden = false // (5)!
     })
     ```
 
+    1.  The feedback widget is hidden by default so that it does not appear when
+        people have JavaScript turned off. So, it needs to be turned on here.
+
+    2.  Retrieve page and feedback value.
+
+    3.  Replace this with the code that sends the data off to your analytics
+        provider.
+
+    4.  Disable the form after submission.
+
+    5.  Show the configured notes. Which one is shown depends on the user
+        feedback.
+
 === ":octicons-file-code-16: `mkdocs.yml`"
 
     ``` yaml

material/templates/partials/source-file.html

@@ -18,6 +18,7 @@
   </span>
 {% endmacro %}
 {% macro render_authors(authors) %}
+  {% set git_authors = config.plugins.get("git-authors") %}
   <span class="md-source-file__fact">
     <span class="md-icon" title="{{ lang.t('source.file.contributors') }}">
       {% if authors | length == 1 %}
@@ -28,9 +29,13 @@
     </span>
     <nav>
       {% for author in authors %}
+        {%- if git_authors.config.show_email_address %}
         <a href="mailto:{{ author.email }}">
           {{- author.name -}}
         </a>
+        {%- else -%}
+          {{- author.name -}}
+        {% endif -%}
         {%- if loop.revindex > 1 %}, {% endif -%}
       {% endfor %}
     </nav>

src/templates/partials/source-file.html

@@ -44,6 +44,7 @@
 
 <!-- Render authors -->
 {% macro render_authors(authors) %}
+  {% set git_authors = config.plugins.get("git-authors") %}
   <span class="md-source-file__fact">
     <span class="md-icon" title="{{ lang.t('source.file.contributors') }}">
       {% if authors | length == 1 %}
@@ -54,9 +55,13 @@
     </span>
     <nav>
       {% for author in authors %}
+        {%- if git_authors.config.show_email_address %}
         <a href="mailto:{{ author.email }}">
           {{- author.name -}}
         </a>
+        {%- else -%}
+          {{- author.name -}}
+        {% endif -%}
         {%- if loop.revindex > 1 %}, {% endif -%}
       {% endfor %}
     </nav>