Merge pull request #480 from thostetler/add-some-seo

SEO Improvements

Gemfile

@@ -0,0 +1,9 @@
+source "https://rubygems.org"
+
+# Use the latest version.
+gem "jekyll"
+
+group :jekyll_plugins do
+   gem "jekyll-last-modified-at"
+   gem "jekyll-seo-tag"
+end

README.md

@@ -53,7 +53,7 @@ All the blogs are kept under the folder `blog/_posts/`. The following rules must
 
 For more information on formatting within jekyll you can read [here](http://jekyllrb.com/docs/posts/), or any other places that has information about markdown. Markdown can also render HTML if you prefer to write using that.
 
-If you wish to see the content you are writing while working in markdown, the recommended tool as of October 2017 is 
+If you wish to see the content you are writing while working in markdown, the recommended tool as of October 2017 is
 [grip](https://github.com/joeyespo/grip).  Other ones we have considered/used in the past are [dillinger.io](http://dillinger.io/) or some programs such as [haroopad](http://pad.haroopress.com/).
 
 If making a pull request, follow the rules described in `CONTRIBUTING.md`.
@@ -67,6 +67,7 @@ The help pages are static web pages built using Jekyll (written in Ruby) and tak
 
 After installing Jekyll, run the following commands to preview the site:
 
+* install gems with `bundle install` (you may need to run `bundle update` first to update the Gemfile.lock file
 * build with `jekyll build`
 * serve the project with the command `jekyll serve`
 

_config.yml

@@ -3,8 +3,14 @@ title: ADS news, blogs, and help pages
 url: https://ui.adsabs.harvard.edu
 email: [email protected]
 description: All your questions will be answered here.
-twitter_username: adsabs
-github_username: adsabs
+
+# Social
+twitter:
+  username: adsabs
+github:
+  username: adsabs
+logo: /help/common/images/transparent_logo.svg
+
 permalink: /:categories/:title
 # Build settings
 markdown: kramdown
@@ -14,5 +20,18 @@ kramdown:
   input: GFM
 
 sass:
-  style: :compressed
+  style: compressed
   sass_dir: _sass
+
+plugins:
+  - jekyll-seo-tag
+  - jekyll-last-modified-at
+
+last-modified-at:
+  date-format: '%Y-%m-%dT%H:%M:%S%:z'
+
+defaults:
+  - scope:
+      path: ''
+    values:
+      image: /help/common/images/transparent_logo.svg

_includes/head_default.html

@@ -7,14 +7,7 @@
     content="q68EGUOrG2HGZ62jIdD4ILfyPYZtDK6amNJbkrav_DA"
   />
 
-  <title>
-    {% if page.title %}{{ page.title }}{% else %} ADS {{ include.subtitle }} {%
-    endif %}
-  </title>
-  <meta name="description" content="{{ site.description }}" />
-
   <!-- Disqus tags -->
-  <meta property="og:description" content="{% if page.summary %}{{ page.summary | strip_html | strip_newlines | truncate: 200 | escape }}{% else %}{{ page.title | strip_html | strip_newlines | truncate: 200 | escape }}{% endif %}">
   <meta property="og:image" content="{% if page.thumbnail %}{{ page.thumbnail | prepend: '/' | prepend: site.image_base | prepend: site.baseurl | prepend: site.url }}{% endif %}">
 
   <link
@@ -95,4 +88,6 @@
       }
     </style>
   </noscript>
+  <meta http-equiv="Last-Modified" content="{{ page.last_modified_at }}" />
+  {% seo %}
 </head>

about/css/main.scss

@@ -1,48 +1,37 @@
 ---
-# Only the main Sass file needs front matter (the dashes are enough)
 ---
-@charset "utf-8";
-
-
+@charset "UTF-8";
 
 // Our variables
 $base-font-family: Helvetica, Arial, sans-serif;
-$base-font-size:   16px;
-$small-font-size:  $base-font-size * 0.875;
+$base-font-size: 16px;
+$small-font-size: $base-font-size * 0.875;
 $base-line-height: 1.6;
 
-$spacing-unit:     30px;
+$spacing-unit: 30px;
 
-$brand-color:       #1c459b;
-$bright-brand:     lighten($brand-color, 20);
+$brand-color: #1C459b;
+$bright-brand: lighten($brand-color, 20);
 $brand-color-muted: lighten($bright-brand, 15);
 
-
-$grey-color:       #555;
-$grey-color-light: #eee;
-$grey-color-dark:  #333;
-
-$text-color:       lighten($grey-color-dark, 14%);
-
+$grey-color: #555;
+$grey-color-light: lighten($grey-color, 15%);
+$grey-color-dark: #333;
+$text-color: lighten($grey-color-dark, 14%);
 $background-color: #fff;
 
 $code-color: #F8F8F8;
 
+$on-palm: 600px;
+$on-laptop: 800px;
 
+$nav-color: #fff;
+$nav-header-color: desaturate($brand-color, 30);
+$nav-text-color: $text-color;
 
-
-$on-palm:          600px;
-$on-laptop:        800px;
-
-$nav-color:        #fff;
-$nav-header-color:  desaturate($brand-color, 30);
-$nav-text-color:  $text-color;
-
-
-/* ==========================================================================
-   .default-layout is a plain layout, just used for job announcements right now
-   ========================================================================== */
-
+// ==========================================================================
+// .default-layout is a plain layout, just used for job announcements right now
+// ==========================================================================
 .default-layout h1 {
   font-weight: bold;
 }
@@ -51,9 +40,5 @@ $nav-text-color:  $text-color;
   padding-bottom: 5rem !important;
 }
 
-
-// Import partials from `sass_dir` (defaults to `_sass`)
-@import
-        "bootstrap",
-        "layout",
-        "sidebar";
+// Import partials from "sass_dir" (defaults to "_sass")
+@import "bootstrap", "layout", "sidebar";

help/common/css/styles.scss

@@ -1,7 +1,5 @@
 ---
-# Only the main Sass file needs front matter (the dashes are enough)
 ---
-
 @charset "utf-8";
 
 // Our variables