Retro guide

_config.yml

@@ -7,9 +7,11 @@ they have helped us."
 
 baseurl: "/practitioners-guides"
 url: "https://scottlogic.github.io"
-sl_url: "https://www.scottlogic.com"
 GitHub_url: "https://github.com/ScottLogic/practitioners-guides"
-
+canonical:
+  url: https://www.scottlogic.com/practitioners-guides
+scottlogic:
+  url: https://www.scottlogic.com
 markdown: GFM
 theme: null
 plugins:
@@ -29,6 +31,15 @@ collections:
     permalink: /:collection/:path/
     sort_by: date
 
+defaults:
+- scope:
+    path: ''
+    type: posts
+  values:
+    summary: "a quick summary of your post"
+    author: "the name of the author's account"
+    layout: post
+
 exclude:
   - .sass-cache/
   - .jekyll-cache/

_data/authors.yml

@@ -0,0 +1,13 @@
+authors:
+  cpratt:
+    name: 'Catherine Pratt'
+    picture: picture.jpg
+    author-summary: "I'm a Delivery Principal at Scott Logic."
+  mcline:
+    name: "Matt Cline"
+    picture: mcline.jpg
+    author-summary: "I am a Lead Developer and Scrum Master at Scott Logic with a keen interest in Agile Software Development and supporting Agile teams. My background is in fullstack development across .NET and Java applications with frontends in React and Angular."
+  abennamane:
+    name: 'Atika Bennamane'
+    picture: abennamane.jpg
+    author-summary: "I'm a Design Principal at Scott Logic."

_includes/author_summary.html

@@ -0,0 +1,15 @@
+{% assign author-id = include.author-id %}
+{% assign author = site.data.authors.authors[author-id] %}
+<div class="author-information cell">
+  <img src="{{ site.baseurl }}/authors/{{ author-id }}/assets/{{ author.picture }}" alt="{{ author.name }}"/>
+  {{ author.name }}
+</div>
+<div class="cell">
+  {{ author.author-summary }}
+  {% if  author.twitter-url %}
+      {% assign twitter-url-split = author.twitter-url | split: '/' %}
+      <div class="author-social-media-link">
+          <a rel="author" href="{{ author.twitter-url}}">@{{ twitter-url-split[3] }}</a>
+      </div>
+  {% endif %}
+</div>

_includes/format_date.html

@@ -0,0 +1,15 @@
+{% assign date = include.date | date: "%s" %}
+{% assign days = date | date: "%-d" %}
+{% case days %}
+  {% when "1" or "21" or "31" %}{{ days }}<sup>st</sup>&nbsp;
+  {% when "2" or "22" %}{{ days }}<sup>nd</sup>&nbsp;
+  {% when "3" or "23" %}{{ days }}<sup>rd</sup>&nbsp;
+  {% else %}{{ days }}<sup>th</sup>&nbsp;
+{% endcase %}
+{% assign year = date | date: "%Y" %}
+{% assign currentYear = 'now' | date: "%Y" %}
+{% if year == currentYear  %}
+  {{ date | date: "%b" }}
+{% else %}
+  {{ date | date: "%b %Y" }}
+{% endif %}

_includes/post_colour.html

@@ -0,0 +1,11 @@
+{% if include.post.colour %}
+  {{ include.post.colour }}
+{% else %}
+  {% assign colourIndex = include.post.title | size | modulo:4 %}
+  {% case colourIndex %}
+    {% when 0 %}teal
+    {% when 1 %}orange
+    {% when 2 %}pink
+    {% when 3 %}yellow
+  {% endcase %}
+{% endif %}

_includes/post_colour_hex.html

@@ -0,0 +1,11 @@
+{% if include.post.colour %}
+  {{ include.post.colour }}
+{% else %}
+  {% assign colourIndex = include.post.title | size | modulo:4 %}
+  {% case colourIndex %}
+    {% when 0 %}#2bb3bb
+    {% when 1 %}#ef8547
+    {% when 2 %}#c41565
+    {% when 3 %}#f8be4f
+  {% endcase %}
+{% endif %}

_includes/post_index.html

@@ -0,0 +1,20 @@
+<div class="post-index grid-container">
+  <h1 class="super-title"><a href="{{ site.github.url }}">Practitioner's Guides</a></h1>
+  <div class="cell grid-x">
+    <div class="cell large-7 large-offset-1">
+      <p>The Practitioner's Guides are designed to be small practical guides for IT professionals - authored by the team at [Scott Logic](https://www.scottlogic.com/). We draw on our collective experience to tackle topics that we don't feel are addressed elsewhere. Our hope is that these little 'value adds' will help you just as much as they have helped us.</p>
+
+      <p>Topics covered include:</p>
+      <ul>
+        {% for item in site.pages %}
+        <li>- {{item.title}}</li>
+        {% endfor %}
+      </ul>
+      <p>The Practitioners Guides site is an ongoing project, where we expect new guides to be published on a somewhat regular basis, watch this space!</p>
+
+      <p>If you're interested in finding out more, or want to get involved, please visit the [GitHub project](https://github.com/ScottLogic/practitioners-guides).</p>
+    </div>
+  </div>
+</div>
+
+{% include site-footer.html %}

_includes/post_metadata.html

@@ -0,0 +1,18 @@
+{% assign post = include.post %}
+{% assign allContributors = post.contributors | join: '|' | prepend: '|' | prepend: post.author | split: '|' %}
+<div>
+  <span>
+    {% for contributorId in allContributors %}
+      {% assign contributor = site.data.authors.authors[contributorId] %}
+      <a href="{{ site.baseurl }}/{{ contributorId }}">{{ contributor.name }}</a>{% unless forloop.last %}, {% endunless %}
+    {% endfor %}
+    <span> &middot;</span>
+  </span>
+  <span class="timestamp" date-published="{{ post.date }}">
+    {% include format_date.html date=post.date %}
+  </span>
+  {% unless post.layout == 'video_post' %}
+  <span>&middot;</span>
+  <span>{% include reading_time.html post=post %}</span>
+  {% endunless %}
+</div>

_includes/post_shape.html

@@ -0,0 +1,5 @@
+{% if include.post.header-shape %}
+  {{ include.post.header-shape }}
+{% else %}
+  shape{{ include.post.title | size | modulo:5 }}
+{% endif %}