docs: add homepage announcement support + announce v1.1 RC

json-api · dgeb · Dec 3, 2018 · Oct 7, 2018 · Oct 20, 2018 · Oct 22, 2018
commit de11f01de7c8ef16a0ecebd5aacd8419510b0081
diff --git a/_config.yml b/_config.yml
@@ -32,7 +32,7 @@ kramdown:
   math_engine: mathjax # cannot customize
   syntax_highligher: rouge # cannot customize
 
-gems:
+plugins:
   - jekyll-redirect-from
 
 exclude:
@@ -79,6 +79,10 @@ defaults:
 
 latest_version: 1.0
 excerpt_separator: ""
+announcement: |
+  **[JSON:API v1.1 RC1](/format/1.1/) has been published!** Please review and
+  try out this upcoming version of the spec before its planned release date of
+  January 31, 2019.
 
 navigation:
 - title: JSON API

diff --git a/_layouts/page.html b/_layouts/page.html
@@ -33,6 +33,11 @@ <h2>A specification for building APIs in JSON</h2>
               <a href="{{link.url}}" title="{{link.title}}">{{link.title}}</a>
             {% endfor %}
           </div>
+          {% if site.announcement %}
+          <div class="announcement">
+            {{ site.announcement|markdownify }}
+          </div>
+          {% endif %}
         </div>
       </header>
     {% endif %}

diff --git a/stylesheets/all.css b/stylesheets/all.css
diff --git a/stylesheets/all.css.map b/stylesheets/all.css.map
diff --git a/stylesheets/all.sass b/stylesheets/all.sass
@@ -199,7 +199,7 @@ address
 
 header
   .content
-    padding: 29px $page-padding 41px
+    padding: 32px $page-padding 41px
     background: $color-masthead
     border-bottom: 1px solid $color-light-rule
 
@@ -215,7 +215,7 @@ header
 
   h2
     text-align: center
-    margin: 15px 0 40px 0
+    margin: 17px 0 37px 0
     padding: 0
     left: 0
     font-size: 124%
@@ -238,6 +238,18 @@ header
     text-decoration: none
     text-align: center
 
+  .announcement
+    margin: 22px auto 0
+    max-width: 38em
+    text-align: center
+    position: relative
+    top: 15px // intentionally eat into parent's padding-bottom
+    color: $color-main
+
+    *
+      color: inherit
+      margin: 0
+
   @media screen and (max-width: $mobile-breakpoint)
     .content
       padding-top: 20px