Merge https://github.com/gcushen/hugo-academic

.github/ISSUE_TEMPLATE/bug-report.md

@@ -0,0 +1,41 @@
+---
+name: "\U0001F41B Bug report"
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+Welcome to Academic's GitHub repo 👋
+
+We use GitHub only for bug reports and feature requests - it's our project management tool.
+
+For **help** and **questions**, please join our **[community chat](https://spectrum.chat/academic)** or use the **[forum](https://discourse.gohugo.io/c/themes)** 🚑.
+
+Also, you can search and browse the extensive [Academic](https://sourcethemes.com/academic/docs/) and [Hugo](https://gohugo.io/documentation/) **documentation**.
+
+For questions on _Blogdown_, please reach out to the [Blogdown community](https://github.com/rstudio/blogdown).
+
+### Describe the bug
+
+A clear and concise description of what the bug is.
+
+### To Reproduce
+
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. See error '...'
+
+### Expected behavior
+
+A clear and concise description of what you expected to happen.
+
+### Technical details:
+
+* Academic Version:
+* Hugo Version:
+* Browser/OS:
+
+If applicable, add screenshots to help explain the issue.

.github/ISSUE_TEMPLATE/feature-request.md

@@ -0,0 +1,22 @@
+---
+name: "\U0001F680 Feature request"
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+## Feature Request
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

README.md

@@ -83,7 +83,7 @@ You can choose from one of the following four methods to install:
 Prerequisites:
 
 * [Download and install Git](https://git-scm.com/downloads)
-* [Download and install Hugo Extended v0.55.6+](https://gohugo.io/getting-started/installing/#quick-install)
+* [Download and install Hugo Extended v0.58.3+](https://gohugo.io/getting-started/installing/#quick-install)
 
 Install:
 
@@ -106,7 +106,7 @@ Install:
 
 Prerequisites:
 
-* [Download and install Hugo Extended v0.55.6+](https://gohugo.io/getting-started/installing/#quick-install)
+* [Download and install Hugo Extended v0.58.3+](https://gohugo.io/getting-started/installing/#quick-install)
 
 Install:
 

assets/js/academic-search.js

@@ -14,11 +14,11 @@ let fuseOptions = {
   shouldSort: true,
   includeMatches: true,
   tokenize: true,
-  threshold: 0.0,
+  threshold: search_config.threshold,  // Set to ~0.3 for parsing diacritics and CJK languages.
   location: 0,
   distance: 100,
   maxPatternLength: 32,
-  minMatchCharLength: 2,
+  minMatchCharLength: search_config.minLength,  // Set to 1 for parsing CJK languages.
   keys: [
     {name:'title', weight:0.99}, /* 1.0 doesn't work o_O */
     {name:'summary', weight:0.6},
@@ -158,7 +158,7 @@ function render(template, data) {
 // If Academic's in-built search is enabled and Fuse loaded, then initialize it.
 if (typeof Fuse === 'function') {
 // Wait for Fuse to initialize.
-  $.getJSON(search_index_filename, function (search_index) {
+  $.getJSON(search_config.indexURI, function (search_index) {
     let fuse = new Fuse(search_index, fuseOptions);
 
     // On page load, check for search query in URL.

assets/js/academic.js

@@ -13,8 +13,12 @@
 
   // Dynamically get responsive navigation bar height for offsetting Scrollspy.
   function getNavBarHeight() {
-    let $navbar = $('.navbar');
+    let $navbar = $('#navbar-main');
+    let $navbar_collapse_show = $('#navbar-main .navbar-collapse.collapse.show');
     let navbar_offset = $navbar.innerHeight();
+    if ($navbar_collapse_show.length){
+      navbar_offset -= $navbar_collapse_show.innerHeight();
+    }
     console.debug('Navbar height: ' + navbar_offset);
     return navbar_offset;
   }
@@ -29,11 +33,12 @@
     // If `target` is undefined or HashChangeEvent object, set it to window's hash.
     // Decode the hash as browsers can encode non-ASCII characters (e.g. Chinese symbols).
     target = (typeof target === 'undefined' || typeof target === 'object') ? decodeURIComponent(window.location.hash) : target;
-    // Escape special chars from IDs, such as colons found in Markdown footnote links.
-    target = '#' + $.escapeSelector(target.substring(1));  // Previously, `target = target.replace(/:/g, '\\:');`
 
     // If target element exists, scroll to it taking into account fixed navigation bar offset.
     if($(target).length) {
+      // Escape special chars from IDs, such as colons found in Markdown footnote links.
+      target = '#' + $.escapeSelector(target.substring(1));  // Previously, `target = target.replace(/:/g, '\\:');`
+
       let elementOffset = Math.ceil($(target).offset().top - getNavBarHeight());  // Round up to highlight right ID!
       $('body').addClass('scrolling');
       $('html, body').animate({
@@ -42,7 +47,7 @@
         $('body').removeClass('scrolling');
       });
     }else{
-      console.warn('Cannot scroll to '+target+'. ID not found!');
+      console.debug('Cannot scroll to target `#'+target+'`. ID not found!');
     }
   }
 
@@ -95,19 +100,6 @@
     }
   });
 
-  /* ---------------------------------------------------------------------------
-   * Smooth scrolling for Back To Top link.
-   * --------------------------------------------------------------------------- */
-
-  $('#back_to_top').on('click', function(event) {
-    event.preventDefault();
-    $('html, body').animate({
-      'scrollTop': 0
-    }, 800, function() {
-      window.location.hash = "";
-    });
-  });
-
   /* ---------------------------------------------------------------------------
    * Hide mobile collapsable menu on clicking a link.
    * --------------------------------------------------------------------------- */
@@ -543,6 +535,16 @@
       // window.addEventListener('hashchange', filter_publications, false);
     }
 
+    // Scroll to top of page.
+    $('.back-to-top').click( function(event) {
+      event.preventDefault();
+      $('html, body').animate({
+        'scrollTop': 0
+      }, 800, function() {
+        window.location.hash = "";
+      });
+    });
+
     // Load citation modal on 'Cite' click.
     $('.js-cite-modal').click(function(e) {
       e.preventDefault();

assets/js/mathjax-config.js

@@ -0,0 +1,16 @@
+// MathJax Configuration
+//
+// v2 to v3 upgrade notes:
+// - The CommonHTML.linebreaks option is not yet implemented (but may be in a future release)
+// - The TeX.noUndefined.attributes option is not yet implemented (but may be in a future release)
+window.MathJax = {
+  tex: {
+    inlineMath: [['$', '$'], ['\\(', '\\)']],
+    displayMath: [['$$', '$$'], ['\\[', '\\]']],
+    processEscapes: false,
+    packages: {'[+]': ['noerrors']}
+  },
+  loader: {
+    load: ['[tex]/noerrors']
+  }
+};

assets/js/mathjax3-config.js

@@ -1,19 +0,0 @@
-window.MathJax = {
-  tex: {
-    inlineMath: [['$', '$'], ['\\(', '\\)']],
-    displayMath: [['$$', '$$'], ['\\[', '\\]']],
-    processEscapes: false,
-    autoload: {
-      color: [],
-      colorV2: ['color']
-    },
-    packages: {'[+]': ['noerrors']}
-  },
-  options: {
-    ignoreHtmlClass: 'tex2jax_ignore',
-    processHtmlClass: 'tex2jax_process'
-  },
-  loader: {
-    load: ['[tex]/noerrors']
-  }
-};

assets/sass/academic/_content.scss → assets/scss/academic/_content.scss

@@ -103,7 +103,6 @@ article {
 /* For article page only, not lists. */
 article .article-metadata {
   margin-bottom: 20px;
-  line-height: 30px; /* Match share bar line height. */
 }
 
 .article-metadata a {
@@ -157,24 +156,6 @@ article .article-metadata {
   margin-bottom: 0;
 }
 
-.article-widget {
-  padding-top: 1rem;
-}
-
-.article-widget h3 {
-  margin-top: 0;
-}
-
-.hr-light {
-  border-top: 1px solid rgba(0,0,0,.05);
-  margin-top: 0.5rem;
-  margin-bottom: 1rem;
-}
-
-#comments {
-  padding-top: 1rem;
-}
-
 /*************************************************
  *  Publications
  **************************************************/
@@ -210,19 +191,82 @@ article .article-metadata {
 }
 
 /*************************************************
- *  Author profile card
+ *  Content widgets
  **************************************************/
 
-.author-card {
-  margin-top: 1rem;
-  padding-top: 1rem;
+.content-widget-hr {
+  margin-top: 1.2rem;
+  padding-top: 1.2rem;
   border-top: 1px solid rgba(0,0,0,.05);
 }
 
-.dark .author-card {
+.dark .content-widget-hr {
   border-top: 1px solid rgba(255,255,255,.05);
 }
 
+/*************************************************
+ *  Tags
+ **************************************************/
+
+.article-tags {
+  margin-top: 1.2rem;
+}
+
+/*************************************************
+ *  Sharing
+ **************************************************/
+
+.share-box {
+  margin-top: 0.7rem;
+}
+
+ul.share {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex-direction: row;
+  flex-wrap: wrap;
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+ul.share li {
+  display: inline-flex;
+  margin-right: 8px;
+}
+
+ul.share li:last-of-type {
+  margin-right: 0;
+}
+
+ul.share li i {
+  display: block;
+  width: 30px;
+  height: 30px;
+  line-height: 30px;
+  font-size: 22px;
+  text-align: center;
+  transition: all 150ms ease-in-out;
+}
+
+ul.share li a {
+  text-decoration: none !important;
+  color: rgba(0, 0, 0, 0.84);
+}
+
+.dark ul.share li a {
+  color: rgba(255, 255, 255, 0.84);
+}
+
+ul.share li:hover i {
+  transform: scale(1.2)
+}
+
+/*************************************************
+ *  Author profile card
+ **************************************************/
+
 .author-card .portrait {
   width: 60px;
   height: 60px;
@@ -273,54 +317,21 @@ article .article-metadata {
 }
 
 /*************************************************
- *  Sharing
+ *  Comments
  **************************************************/
 
-.share-box {
-  float: right;
-}
-
-ul.share {
-  display: flex;
-  flex-direction: row;
-  flex-wrap: wrap;
-  list-style: none;
-  margin: 0;
-  padding: 0;
-}
-
-ul.share li {
-  display: inline-flex;
-  margin-right: 5px;
-}
-
-ul.share li:last-of-type {
-  margin-right: 0;
-}
-
-ul.share li i {
-  display: block;
-  width: 30px;
-  height: 30px;
-  line-height: 30px;
-  font-size: 16px;
-  text-align: center;
-  transition: all 150ms ease-in-out;
-  color: #fff;
+#comments {
+  padding-top: 1rem;
 }
 
-.dark ul.share li i {
-  color: rgb(68, 71, 90);
-}
+/*************************************************
+ *  Related content
+ **************************************************/
 
-ul.share li a {
-  background-color: #b5c6ce;
-  display: block;
-  border-radius: 50%;
-  text-decoration: none !important;
-  margin: 0;
+.article-widget {
+  padding-top: 1.2rem;  /* Match .content-widget-hr */
 }
 
-ul.share li:hover i {
-  transform: scale(1.4)
+.article-widget h3 {
+  margin-top: 0;
 }

assets/sass/academic/_dark.scss → assets/scss/academic/_dark.scss

@@ -51,10 +51,6 @@ body.dark,
   background-color: rgb(68, 71, 90) !important;
 }
 
-.dark ul.share li a {
-  background-color: $sta-primary;
-}
-
 .dark table table {
   background-color: rgb(40, 42, 54);
 }

assets/sass/academic/_root.scss → assets/scss/academic/_root.scss

@@ -135,13 +135,19 @@ video {
   margin: 0 auto;
 }
 
+// Center all figure images by default.
+figure img {
+  @extend .margin-auto;
+}
+
+// Center all figure captions by default.
 figcaption {
   display: block;
   margin-top: 0.75em;
-  line-height: 1.25;
-  font-size: 1rem;
   margin-bottom: 1.65rem;
-  font-family: $sta-font-heading, sans-serif;
+  line-height: 1.4;
+  font-size: 0.76rem;
+  text-align: center;
 }
 
 figcaption.numbered:before {
@@ -154,13 +160,6 @@ figcaption.numbered {
   counter-increment: captions;
 }
 
-figcaption h4 {
-  display: inline;
-  font-size: 1rem;
-  font-weight: 400;
-  margin: 0;
-}
-
 pre,
 code {
   font-family: $sta-font-mono, monospace;
@@ -350,7 +349,7 @@ footer p {
 }
 
 site-footer,
-footer a#back_to_top i {
+footer a.back-to-top i {
   color: rgba(0,0,0,0.54);
 }
 

assets/sass/academic/_widgets.scss → assets/scss/academic/_widgets.scss

@@ -55,15 +55,19 @@
   top: 100%;
 }*/
 
-/* Create the parallax scrolling effect */
-.parallax {
-  height: 100%;
-  background-attachment: fixed;
+/* Default background image properties for home sections. */
+.home-section.bg-image {
   background-position: center;
   background-repeat: no-repeat;
   background-size: cover;
 }
 
+/* Create a parallax-like scrolling effect. */
+.parallax {
+  height: 100%;
+  background-attachment: fixed;
+}
+
 .home-section:first-of-type {
   padding-top: 50px;
 }
@@ -290,6 +294,7 @@ ul.network-icon {
   justify-content: center;
   list-style: none;
   padding: 0;
+  margin: 0;
 }
 
 #profile .network-icon {

assets/scss/custom.scss

@@ -0,0 +1 @@
+// Override this file to add your own SCSS styling.

assets/sass/main.scss → assets/scss/main.scss

@@ -38,3 +38,4 @@ $sta-dark-home-section-even: {{ $scr.Get "dark_home_section_even" }};
 @import "bootstrap_variables";
 @import "vendor/bootstrap/bootstrap";
 @import "academic/academic";
+@import "custom";