Retro guide

_config.yml

@@ -29,6 +29,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 authers 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 %}

_includes/post_summary_list.html

@@ -0,0 +1,15 @@
+{% assign posts = include.posts %}
+{% assign paginated = include.paginated %}
+{% assign hideCategory = include.hideCategory %}
+<div class="post-summary-list">
+    {% comment %} This container is used by jScroll. When the next page is fetched, the contents of this div are added to the bottom of the page {% endcomment %}
+    <div class="content">
+        {% for post in posts %}
+        {% include post_summary.html post=post hideCategory=hideCategory %}
+        {% endfor %}
+
+        {% if paginated %}
+        {% include pagination.html %}
+        {% endif %}
+    </div>
+</div>

_includes/post_summary_social.html

@@ -0,0 +1,12 @@
+{% capture url %}{{ site.canonical.url }}{{ post.url }}{% endcapture %}
+<span class="post-summary-social">
+  <span class="clap" data-url="{{ url }}" style="display: none">
+    <svg xmlns="http://www.w3.org/2000/svg" width="17" height="17" viewBox="0 0 60 60" >
+      <g class="flat">
+        <path d="M37.1910045 6.68944619C37.7313574 6.14566353 38.4431784 5.8737722 39.155207 5.8737722 39.967916 5.8737722 40.7808327 6.22800418 41.3380002 6.93667712 42.2214969 8.06039707 42.0666359 9.69111808 41.0600392 10.7042842L39.777765 11.9949843C39.5801407 12.1276907 39.3877061 12.2695925 39.2075193 12.430303 39.0619998 11.5985371 38.7167801 10.7954023 38.1668781 10.0961338 37.4907623 9.23636364 36.588375 8.62424242 35.5772114 8.31410658L37.1910045 6.68944619zM28.5289586 3.66394984C29.0691039 3.12016719 29.7811325 2.84827586 30.4931611 2.84827586 31.3060777 2.84848485 32.1187868 3.20271682 32.6759543 3.91138976 33.559451 5.03510972 33.40459 6.66562173 32.3979933 7.67878788L17.6760235 22.3467085 17.6276554 20.6499478C17.6149925 19.014629 16.8595779 17.554441 15.6854573 16.5945664L28.5289586 3.66394984zM.624996757 36.9889537C.491717597 36.554099.508245877 35.7327064.906400646 35.2666667L3.45579518 32.2829676C3.45662553 32.2819923 4.33763118 25.8376176 6.09881213 12.9498433 6.09881213 11.4271682 7.33624726 10.1814002 8.84873717 10.1814002 10.3612271 10.1814002 11.5988698 11.4271682 11.5988698 12.9498433L11.6704878 15.4649948C9.18191673 15.8089864 7.24428555 17.9170324 7.14921001 20.492581L4.62804751 38.9475444 3.8946373 39.8060606C3.04504924 39.4926018 2.3776139 39.1458968 1.89233128 38.7659456 1.16440735 38.1960189.758275917 37.4238085.624996757 36.9889537z"/>
+        <path d="M49.6070811,36.8942529 L42.4182909,44.1316614 C36.2784454,50.3128527 29.8604313,55.2743992 24.2225349,56.5113898 C24.0512744,56.5492163 23.8901857,56.6217346 23.7511014,56.7293626 L20.5013032,59.2417973 C20.2908084,59.4045977 20.1673015,59.6181154 19.5026647,59.6181154 C18.8380279,59.6181154 13.0160695,55.8303982 10.3595306,53.2846814 C7.96626306,50.9912532 3.77432047,43.9549368 4.44453927,43.0079415 L6.99372621,40.0244514 C6.99469496,40.0233368 7.87570061,33.578962 9.63674317,20.6913271 C9.63674317,19.168652 10.8743859,17.922675 12.3868758,17.922675 C13.8993657,17.922675 15.1368008,19.168652 15.1368008,20.6913271 L15.2667512,25.2522466 C15.2883404,26.0100313 15.907577,26.5034483 16.5519317,26.5034483 C16.8662207,26.5034483 17.1867374,26.3857889 17.4464306,26.1245559 L32.0670972,11.4054336 C32.6074501,10.861442 33.3190635,10.5897597 34.0312997,10.5897597 C34.8440088,10.5897597 35.6569254,10.9439916 36.214093,11.6526646 C37.0975897,12.7763845 36.942521,14.4071055 35.9359243,15.4202717 L25.8641449,25.5598746 C25.3412294,26.0865204 25.3412294,26.9398119 25.8641449,27.4660397 C26.1288202,27.7324974 26.4757006,27.8658307 26.822581,27.8658307 C27.1694614,27.8658307 27.5165494,27.7324974 27.7810172,27.4660397 L40.7291431,14.43093 C41.2692884,13.8869383 41.9811094,13.615256 42.6933456,13.615256 C43.5060547,13.615465 44.3189713,13.969697 44.8761389,14.6783699 C45.7596356,15.8018809 45.6045669,17.4326019 44.5979702,18.445768 L31.7106677,31.4198537 C31.1806943,31.953605 31.1806943,32.8183908 31.7106677,33.3521421 C31.9718141,33.615047 32.31392,33.7464995 32.656441,33.7464995 C32.9985469,33.7464995 33.3408603,33.615047 33.6020067,33.3521421 L43.7346096,23.1515152 C44.2749625,22.6075235 44.9867835,22.3358412 45.6988121,22.3358412 C46.5115212,22.3358412 47.3244378,22.6900731 47.8816054,23.3989551 C48.7651021,24.522466 48.6100334,26.153187 47.6034367,27.1663532 L37.5667397,37.2708464 C37.0245185,37.8165099 37.0245185,38.7017764 37.5667397,39.2474399 C37.8334909,39.5161964 38.161896,39.6422153 38.4900934,39.6422153 C38.8184984,39.6422153 39.1469035,39.5161964 39.3972552,39.2639498 L45.6195133,32.999791 C46.1802099,32.4353187 46.93085,32.1368861 47.678999,32.1368861 C48.2741552,32.1368861 48.8676508,32.3258098 49.361919,32.7197492 C50.682182,33.7717868 50.7639719,35.7297806 49.6070811,36.8942529 Z"/>
+      </g>
+    </svg>
+    <span class="count"></span>
+  </span>
+</span>