Add project summaries to homepage; Refactor h2 headings to h1 partly so Markdown renders better; Refactor `url_image` setting to `image`; Fix `#top` hash location when accessing home from another page; Improve SEO; Update README

README.md

@@ -65,19 +65,20 @@ To create a new publication:
 
     hugo new publication/my-paper-name.md
 
-Then edit the default variables at the top of `content/publication/my-paper-name.md` to include the details of your publication. The `url_` variables (except `url_image`) are used to generate links associated with your publication, such as for viewing PDFs of papers. Here is an example:
+Then edit the default variables at the top of `content/publication/my-paper-name.md` to include the details of your publication. The `url_` variables are used to generate links associated with your publication, such as for viewing PDFs of papers. Here is an example:
 
 ```
 +++
 abstract = "An abstract..."
 authors = ["First author's name", "Second author's name"]
 date = "2013-07-01"
+image = ""
+image_preview = ""
 math = false
 publication = "The publishing part of the citation goes here. You may use *Markdown* for italics etc."
 title = "A publication title, such as title of a paper"
 url_code = ""
 url_dataset = ""
-url_image = ""
 url_pdf = "pdf/my-paper-name.pdf"
 url_project = ""
 url_slides = ""
@@ -97,7 +98,7 @@ You can also associate custom link buttons with the publication by adding the fo
     url = "http://www.example.org"
 ```
 
-Note that the `url_image` variable is a placeholder that may be used if you wish to modify the publication list to show thumbnails either from images in your `static/img/` folder (which is deployed as `http://your-URL.com/img/`), or URLs of web images.
+Note that the `image` variables are just placeholders that may be used to reference associated images. If desired, you can modify the publication detail and list pages to show the respective images. These images should be referenced similarly to the above process for PDFs, but using the `static/img/` folder.
 
 ### Post an article
 
@@ -144,10 +145,21 @@ Then you can re-build and view the updated website with the `hugo` and `hugo ser
 
 It is possible to carry out many customizations without touching any files in `themes/academic`, making it easier to upgrade the theme in the future.
 
+### Custom theme color (CSS) or JavaScript (JS)
+
 You can link custom CSS and JS assets (relative to your root `static/css` and `static/js` respectively) from your `config.toml` using `custom_css = ["custom.css"]` or `custom_js  = ["custom.js"]`.
 
 For example, lets make a green theme. First, define `custom_css = ["green.css"]` in `config.toml`. Then we can download the example [green theme](https://gist.github.com/gcushen/d5525a4506b9ccf83f2bce592a895495) and save it as `static/css/green.css`, relative to your website root (i.e. **not** in the `themes` directory).
 
+### Permalinks
+
+*Permalinks*, or *permanent links*, are URLs to individual pages and posts on your website. They are permanent web addresses which can be used to link to your content. Using Hugo's *permalinks* option these can be easily customized. For example, the blog post URL can be changed to the form *yourURL/2016/05/01/my-post-slug* by adding the following near the top of your `config.toml` (before `[params]` settings):
+
+    [permalinks]
+        post = "/:year/:month/:day/:slug"
+
+Where `:slug` defaults to the filename of the post, excluding the file extension. However, slug may be overridden on a per post basis if desired, simply by setting `slug = "my-short-post-title"` in your post preamble.
+
 ## Upgrading
 
 Feel free to *star* the project on [Github](https://github.com/gcushen/hugo-academic/) and monitor the commits for updates.

archetypes/post.md

@@ -1,3 +1,5 @@
 +++
+image = ""
+image_preview = ""
 tags = []
 +++

archetypes/project.md

@@ -1,8 +1,8 @@
 +++
 tags = []
 summary = ""
-img = ""
-img_preview = ""
+image = ""
+image_preview = ""
 client_name = ""
 external_link = ""
 +++

archetypes/publication.md

@@ -1,9 +1,10 @@
 +++
 abstract = ""
 authors = [""]
+image = ""
+image_preview = ""
 publication = ""
 url_pdf = ""
-url_image = ""
 url_code = ""
 url_dataset = ""
 url_project = ""

exampleSite/content/home/about.md

@@ -6,7 +6,7 @@ section_id = 0
 weight = 0
 +++
 
-## Biography
+# Biography
 
 Lena Smith is a professor of artificial intelligence at the Stanford AI Lab. Her research interests include distributed robotics, mobile computing and programmable matter. She leads the Robotic Neurobiology group, which develops self-reconfiguring robots, systems of self-organizing robots, and mobile sensor networks.
 

exampleSite/content/post/math-example.md

@@ -8,9 +8,36 @@ math = true
 
 Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis posuere tellus ac convallis placerat. Proin tincidunt magna sed ex sollicitudin condimentum. Sed ac faucibus dolor, scelerisque sollicitudin nisi. Cras purus urna, suscipit quis sapien eu, pulvinar tempor diam. Quisque risus orci, mollis id ante sit amet, gravida egestas nisl. Sed ac tempus magna. Proin in dui enim. Donec condimentum, sem id dapibus fringilla, tellus enim condimentum arcu, nec volutpat est felis vel metus. Vestibulum sit amet erat at nulla eleifend gravida.
 
-An example mathematical expression rendered from $\rm \LaTeX$ math code:
+## An example mathematical expression rendered from $\rm \LaTeX$ math code
+
+LaTeX:
+
+```TeX
+$$\left [ – \frac{\hbar^2}{2 m} \frac{\partial^2}{\partial x^2} + V \right ] \Psi = i \hbar \frac{\partial}{\partial t} \Psi$$
+```
+
+Result:
+
 $$\left [ – \frac{\hbar^2}{2 m} \frac{\partial^2}{\partial x^2} + V \right ] \Psi = i \hbar \frac{\partial}{\partial t} \Psi$$
 
+### An example of a table created using *Markdown*
+
+Code:
+
+```Markdown
+| Command           | Description                    |
+| ------------------| ------------------------------ |
+| `hugo`            | Build your website.            |
+| `hugo serve -w`   | View your website.             |
+```
+
+Result:
+
+| Command           | Description                    |
+| ------------------| ------------------------------ |
+| `hugo`            | Build your website.            |
+| `hugo serve -w`   | View your website.             |
+
 Nullam vel molestie justo. Curabitur vitae efficitur leo. In hac habitasse platea dictumst. Sed pulvinar mauris dui, eget varius purus congue ac. Nulla euismod, lorem vel elementum dapibus, nunc justo porta mi, sed tempus est est vel tellus. Nam et enim eleifend, laoreet sem sit amet, elementum sem. Morbi ut leo congue, maximus velit ut, finibus arcu. In et libero cursus, rutrum risus non, molestie leo. Nullam congue quam et volutpat malesuada. Sed risus tortor, pulvinar et dictum nec, sodales non mi. Phasellus lacinia commodo laoreet. Nam mollis, erat in feugiat consectetur, purus eros egestas tellus, in auctor urna odio at nibh. Mauris imperdiet nisi ac magna convallis, at rhoncus ligula cursus.
 
 Cras aliquam rhoncus ipsum, in hendrerit nunc mattis vitae. Duis vitae efficitur metus, ac tempus leo. Cras nec fringilla lacus. Quisque sit amet risus at ipsum pharetra commodo. Sed aliquam mauris at consequat eleifend. Praesent porta, augue sed viverra bibendum, neque ante euismod ante, in vehicula justo lorem ac eros. Suspendisse augue libero, venenatis eget tincidunt ut, malesuada at lorem. Donec vitae bibendum arcu. Aenean maximus nulla non pretium iaculis. Quisque imperdiet, nulla in pulvinar aliquet, velit quam ultrices quam, sit amet fringilla leo sem vel nunc. Mauris in lacinia lacus.

exampleSite/content/project/deep-learning.md

@@ -1,9 +1,9 @@
 +++
 client_name = ""
 date = "2016-04-27"
-img = ""
-img_preview = ""
-summary = ""
+image = ""
+image_preview = ""
+summary = "Lorem ipsum dolor sit amet, consectetur adipiscing elit."
 tags = []
 title = "Deep Learning"
 external_link = ""

exampleSite/content/project/example-external-project.md

@@ -1,11 +1,11 @@
 +++
 client_name = ""
 date = "2016-04-27"
-img = ""
-img_preview = ""
-summary = ""
+image = ""
+image_preview = ""
+summary = "An example of linking directly to an external project website using `external_link`."
 tags = []
-title = "Example External Project"
+title = "External Project"
 external_link = "http://example.org"
 
 +++

exampleSite/content/publication/clothing-search.md

@@ -2,19 +2,20 @@
 abstract = "We present a mobile visual clothing search system whereby a smart phone user can either choose a social networking photo or take a new photo of a person wearing clothing of interest and search for similar clothing in a retail database. From the query image, the person is detected, clothing is segmented, and clothing features are extracted and quantized. The information is sent from the phone client to a server, where the feature vector of the query image is used to retrieve similar clothing products from online databases. The phone's GPS location is used to re-rank results by retail store location. State of the art work focuses primarily on the recognition of a diverse range of clothing offline and pays little attention to practical applications. Evaluated on a challenging dataset, the system is relatively fast and achieves promising results."
 authors = ["GA Cushen", "MS Nixon"]
 date = "2013-07-01"
+image = ""
+image_preview = ""
 math = true
 publication = "In *IEEE International Conference on Multimedia and Expo Workshops (ICMEW)*"
 title = "Mobile visual clothing search"
 url_code = "#"
 url_dataset = "#"
-url_image = ""
 url_pdf = "http://eprints.soton.ac.uk/352095/1/Cushen-IMV2013.pdf"
-url_project = "/project/deep-learning/"
+url_project = "project/deep-learning/"
 url_slides = "#"
 url_video = "#"
 
 [[url_custom]]
-name = " Custom Link"
+name = "Custom Link"
 url = "http://www.example.org"
 
 +++

exampleSite/content/publication/person-re-identification.md

@@ -2,14 +2,15 @@
 abstract = "Person re-identification is a critical security task for recognizing a person across spatially disjoint sensors. Previous work can be computationally intensive and is mainly based on low-level cues extracted from RGB data and implemented on a PC for a fixed sensor network (such as traditional CCTV). We present a practical and efficient framework for mobile devices (such as smart phones and robots) where high-level semantic soft biometrics are extracted from RGB and depth data. By combining these cues, our approach attempts to provide robustness to noise, illumination, and minor variations in clothing. This mobile approach may be particularly useful for the identification of persons in areas ill-served by fixed sensors or for tasks where the sensor position and direction need to dynamically adapt to a target. Results on the BIWI dataset are preliminary but encouraging. Further evaluation and demonstration of the system will be available on our website."
 authors = ["GA Cushen"]
 date = "2015-09-01"
+image = ""
+image_preview = ""
 math = true
 publication = "In *Signal Image Technology & Internet Systems (SITIS)*"
 title = "A Person Re-Identification System For Mobile Devices"
 url_code = ""
 url_dataset = ""
-url_image = ""
 url_pdf = "http://arxiv.org/pdf/1512.04133v1"
-url_project = "/project/deep-learning/"
+url_project = "project/deep-learning/"
 url_slides = ""
 url_video = ""
 

layouts/index.html

@@ -4,7 +4,6 @@
 <!-- Flag for jQuery -->
 <span id="homepage" style="display: none"></span>
 
-
 <!-- Biography Section -->
 {{ range where .Data.Pages "Type" "home" }}
 {{ if eq .Title "about" }}
@@ -24,15 +23,15 @@
     <div class="container">
         <div class="row">
             <div class="col-xs-12 col-md-4">
-                <h2>Recent Publications</h2>
+                <h1>Recent Publications</h1>
                 <p><a href="{{ .Site.BaseURL }}publication/">More Publications <i class="fa fa-angle-double-right" style="padding-left: 5px;"></i></a></p>
             </div>
             <div class="col-xs-12 col-md-8">
                 <ul class="fa-ul">
                     {{ range $index, $page := first 10 (where .Data.Pages "Type" "publication") }}
-                    <li>
+                    <li itemscope itemtype="http://schema.org/CreativeWork">
                         <i class="fa-li fa fa-file-text-o pub-icon" aria-hidden="true"></i>
-                        <span style="padding-right: 8px">{{ .Title }}</span>
+                        <span itemprop="name">{{ .Title }}</span>
                         <p>{{ partial "publication_links" (dict "content" $page "is_list" 1) }}</p>
                     </li>
                     {{ end }}
@@ -51,7 +50,7 @@
     <div class="container">
         <div class="row">
             <div class="col-xs-12 col-md-4">
-                <h2>Posts</h2>
+                <h1>Posts</h1>
                 <p><a href="{{ .Site.BaseURL }}post/">More Posts <i class="fa fa-angle-double-right" style="padding-left: 5px;"></i></a></p>
             </div>
             <div class="col-xs-12 col-md-8">
@@ -85,19 +84,34 @@
     <div class="container">
         <div class="row">
             <div class="col-xs-12 col-md-4">
-                <h2>Projects</h2>
+                <h1>Projects</h1>
             </div>
             <div class="col-xs-12 col-md-8">
                 <ul class="fa-ul">
-                {{ range where .Data.Pages "Type" "project" }}
+                    {{ range where .Data.Pages "Type" "project" }}
                     <li>
+                        <span class="project-title">
                         {{ if .Content }}<a href="{{ .Permalink }}">{{ else }}{{ with .Params.external_link }}<a href="{{ . }}">{{ end }}{{ end }}
                         <i class="fa-li fa fa-files-o pub-icon" aria-hidden="true"></i>
-                        <span style="padding-right: 8px">{{ .Title }}</span>
+                        {{ .Title }}
                         {{ if .Content }}</a >{{ else }}{{ with .Params.external_link }}</a>{{ end }}{{ end }}
-                        {{ with .Params.summary }}<p>{{ . }}</p>{{ end }}
+                        </span>
+
+                        {{ with .Params.summary }}<p class="project-summary">{{ . }}</p>{{ end }}
+
+                        {{ if isset .Params "tags" }}
+                        {{ $tagsLen := len .Params.tags }}
+                        {{ if gt $tagsLen 0 }}
+                        <div class="project-tags">
+                            <i class="fa fa-tags"></i>
+                            {{ range $k, $v := .Params.tags }}
+                            {{ . }}{{ if lt $k (sub $tagsLen 1) }}, {{ end }}
+                            {{ end }}
+                        </div>
+                        {{ end }}
+                        {{ end }}
                     </li>
-                {{ end }}
+                    {{ end }}
                 </ul>
             </div>
         </div>
@@ -114,7 +128,7 @@
     <div class="container">
         <div class="row">
             <div class="col-xs-12 col-md-4">
-                <h2>{{ title $page.Title }}</h2>
+                <h1>{{ title $page.Title }}</h1>
             </div>
             <div class="col-xs-12 col-md-8">
                 {{ $page.Content }}
@@ -131,7 +145,7 @@
     <div class="container">
         <div class="row">
             <div class="col-xs-12 col-md-4">
-                <h2>Contact</h2>
+                <h1>Contact</h1>
             </div>
             <div class="col-xs-12 col-md-8">
                 {{ partial "home_contact.html" . }}

layouts/partials/home_biography.html

@@ -1,10 +1,10 @@
-<div class="row">
+<div class="row" itemprop="author" itemscope itemtype="http://schema.org/Person">
     <div class="col-xs-12 col-md-4">
         <div id="profile">
 
-            <div class="portrait"></div>
+            <div class="portrait" itemprop="image"></div>
 
-            <div class="portrait-title" itemprop="author" itemscope itemtype="http://schema.org/Person">
+            <div class="portrait-title">
                 <h2 itemprop="name">{{ .Site.Params.name }}</h2>
                 <h3 itemprop="jobTitle">{{ .Site.Params.role }}</h3>
                 <h3 itemprop="worksFor">{{ .Site.Params.organization }}</h3>
@@ -29,7 +29,7 @@
 
     <div class="visible-sm visible-xs"></div>
 
-    <div class="col-xs-12 col-md-8">
+    <div class="col-xs-12 col-md-8" itemprop="description">
 
         {{ .Content }}
 

layouts/section/post.html

@@ -2,6 +2,8 @@
 {{ partial "navbar.html" . }}
 <div class="container">
 
+    <h1>Posts</h1>
+
     {{ $paginator := .Paginate .Data.Pages }}
     {{ range $paginator.Pages }}
     <div>

layouts/section/publication.html

@@ -3,7 +3,7 @@
 <div class="container">
     <div class="row">
         <div class="col-md-12">
-            <h2>Publications</h2>
+            <h1>Publications</h1>
 
             {{ range .Data.Pages.GroupByDate "2006" }}
             <div class="row" id="pub_list">

static/css/hugo-academic.css

@@ -55,10 +55,9 @@ h1, h2, h3, h4, h5, h6, .navbar-default {
     text-rendering: optimizeLegibility;
 }
 
-h2 {
+h1 {
     margin-bottom: 21px;
     font-size: 48px;
-    font-weight: 400;
 }
 
 h3 {
@@ -203,6 +202,33 @@ ul.share li i {
     font-style: italic;
 }
 
+/*************************************************
+ *  Projects
+ **************************************************/
+
+section#projects.home-section li {
+    margin-bottom: 20px;
+}
+
+section#projects.home-section li:last-of-type {
+    margin-bottom: 0;
+}
+
+section#projects.home-section .project-title {
+    display: inline-block;
+    margin-bottom: 6px;
+}
+
+section#projects.home-section .project-summary {
+    font-size: 16px;
+    margin-bottom: 6px;
+}
+
+section#projects.home-section .project-tags {
+    font-size: 14px;
+    color: #9c9c9c;
+}
+
 /*************************************************
  *  Contact
  **************************************************/

static/js/hugo-academic.js

@@ -98,6 +98,11 @@
     // Enable smooth scrolling with mouse wheel
     smoothScroll(1.3, 220);
 
+    // When accessing homepage from another page and `#top` hash is set, show top of page (no hash).
+    if (window.location.hash == "#top") {
+      window.location.hash = ""
+    }
+
   });
 
 })(jQuery);