ritterim/rimdev-blog

The technical blog for the Ritter Insurance Marketing development department.

rimdev.io

Photography by JJ Walck

Setup

1. Install latest version of node (if not already installed)
2. Clone repository
3. cd into repository
4. npm install
5. To run: npm run start

Creating posts

• Browse to src/content/posts/
• Create a new markdown file
  • Filename should follow this convention: YYYY-MM-DD-POST-TITLE.md
  • Required Frontmatter:
    • title - name of the post
    • slug - permalink for the post
    • date - post date
    • authors - array of authors
    • tags - array of tags
    • categories - array of categories
    • twitter_text - text that will display when shared to twitter
    • image - post header image
    • image_url - url where image is sourced from
    • image_credit - owner of the image

Adding an image

Add images to the public/images/ directory. Inside posts you can include these by linking just off of images/.

Example Markdown File

When you create a new post, you need to fill the post information in the front-matter, follow this example:

---
title: "How to use"
authors: 
- <Your name here>
date: 2015-08-03 03:32:44
image: "/images/my-great-image.jpg"
image_url: <url/page associated with image>
image_credit: <name for image credit>
tags:
- jekyll
- template
categories:
- I love Jekyll
twitter_text: "How to install and use this template"
---

If the page has no image, image: can be omitted entirely. A default system image will be used. If image_credit: is specified, then image_url: should also be specified.

TAGS: Check existing Tags here before creating new ones

CC Attribution blog images

Using a Creative Commons image requiring attribution?

image: https://farm5.staticflickr.com/4103/5029857600_d8ed3aaa06_b_d.jpg
image_url: https://www.flickr.com/photos/khawkins04/
image_credit: Ken Hawkins

Author pages

Author pages are located in src/content/authors

---
name: Bill Boga
slug: bill-boga
image: /images/default/annex-billboga.jpg
avatar: https://avatars2.githubusercontent.com/u/3382469?v=3
title: Senior Software Developer
desc: Polyglot with focus on C#. Also enjoy building and tinkering with hardware.
twitter: billbogaiv
github: billbogaiv
---

Pets Page

Pets can be added by adding a 500x500px photo to public/images/pets/ and adding information to the src/data/pets.json file.

rimdev-blog's Issues

Middleware Mondays : Maintenance Window Middleware

Write a middleware that allows you to put your site into maintenance mode.

Potential features:

• FileProvider (server static offline/maintenance page)
• Redirect to Path (Mvc)
• Read a remote page, pull in the the html, then write it to the response in place of any url?

Also, the middleware should return a 503 HTTP status code according to this article.

https://yoast.com/http-503-site-maintenance-seo/

Feed is Broken

http://www.feedvalidator.org/check.cgi?url=https%3A%2F%2Frimdev.io%2Ffeed.xml

Using Windows Azure Blob Storage To Secure Global Stuntman Users

Using SAS to secure a global configuration of Stuntman users.

1. Create Json
2. Upload to Blob Storate
3. Generate URL
4. Use URL with Stuntman

Avatar Issues

I noticed two things about avatars:

• Avatars don't show up for single author posts
• Avatars are a little big (imho)

Enhance JSON-LD Data

Currently our JSON-LD data is anemic.

{"@context": "http://schema.org",
"@type": "WebSite",
"name": "RIMdev Technical Blog",
"headline": "RIMdev Technical Blog",
"description": "A blog from the Ritter Insurance Marketing Software development department, a.k.a. RIMdev",
"url": "https://rimdev.io/"}

Should probably be richer. Here is Jimmy Bogard's version of JSON-LD.

{
    "@context": "https://schema.org",
    "@type": "Article",
    "publisher": {
        "@type": "Organization",
        "name": "Jimmy Bogard",
        "logo": "https://jimmybogardsblog.blob.core.windows.net/jimmybogardsblog/0/2017/settings.png"
    },
    "author": {
        "@type": "Person",
        "name": "Jimmy Bogard",
        "image": {
            "@type": "ImageObject",
            "url": "//www.gravatar.com/avatar/cc359c5ccf90d7a24b5976316797b5ec?s=250&d=mm&r=x",
            "width": 250,
            "height": 250
        },
        "url": "https://jimmybogard.com/author/jimmy/",
        "sameAs": [],
        "description": "Chief architect at Headspring, author of the MVC in Action books, international speaker and prolific OSS developer. Expert in distributed systems, REST, messaging, domain-driven design and CQRS. "
    },
    "headline": "Refactoring Towards Resilience: Evaluating Coupling",
    "url": "https://jimmybogard.com/refactoring-towards-resilience-evaluating-coupling/",
    "datePublished": "2017-02-14T21:25:46.000Z",
    "dateModified": "2017-02-14T21:25:46.000Z",
    "keywords": "Architecture, Distributed Systems",
    "description": "Other posts in this series: A primer Evaluating Stripe Options Evaluating SendGrid Options Evaluating RabbitMQ Options Evaluating Coupling So far, we've been looking at our options on how to coordinate various services, using Hohpe as our guide: Ignore Retry Undo Coordinate These options, valid as they are, make an assumption",
    "mainEntityOfPage": {
        "@type": "WebPage",
        "@id": "https://jimmybogard.com"
    }
}

Add Google Analytics

... unless it's already here, and I'm just not seeing it.

Text that happens to be a link is not rendered using an a tag

See http://rimdev.io/announcing-rimdev-releases/ -- the text https://github.com/ritterim/releases is not rendering as an a tag link.

Marketing Your OSS Project

Write about the experience of building and promoting stuntman.

Under The Decision Tree Series

Can start with three categories:

• News
• Posts
• Podcasts

Support Shell Session Styling

shell-session produces unreadable output for code snippets.

<div class="highlight">
  <pre>
    <code class="language-shell-session" data-lang="shell-session">
      <span class="go">&gt; node main.js \</span>
      <span class="go"> --sourceApp MySourceApp \</span>
      <span class="go"> --destApp MyDestinationApp \</span>
      <span class="go"> --subscription "My Subscription"</span>
    </code>
  </pre>
</div>

the css style is the issue.

.highlight .go {
    color: #444;
    background-color: #222;
}

add pets page

🔧 Enhancement Request

Create a pets page for anyone who would like their pet(s) posted. Similar to https://petsofnetlify.com/

• use fa-paw as a nav icon that links to this new page.
• same page structure (header, nav, footer)
• remember, this site uses semantic UI
  • https://semantic-ui.com/views/card.html#fluid-card
  • https://semantic-ui.com/views/card.html#column-count

Who is asking for the feature?

#frontend

What business problem is this hoping to solve?

nothing.

Modify Code Styling

I'd like to change the code styling to this.

.post-content p code, .post-content li code {
    padding: 3px 6px;
    color: #3085f4;
    background-color: #eee;
    border-radius: 4px;
}

CI build

Now that we have spellcheck baked in with #36, it would be useful to build and test PRs to highlight any spelling mistakes.

If this repo was public, I'd say lets just wire up Travis CI. Any reason not to make this repository public / open source this blog per #32?

Improve styling for <hr>

An <hr> tag can be generated in Markdown using:

---

Search is not working

When you click search it flashes with the search bar and then the whole screen goes white.

Not working in at least Brave or Chrome. I haven't tested it with other browsers.

Content dating does not work when JS errors occur

Screenshot showing invalid dater

We could visible:hidden the date-tag by default, and then remove the styling within the same JS-script that calculates the date.

Add Twitter Cards

MozBar says we don't have them

Make sure the Disqus Url is the correct one on the homepage

Support Mermaid Diagrams

http://kkpattern.github.io/2015/05/15/Embed-Chart-in-Jekyll.html

Switch to kramdown

"Starting May 1st, 2016, GitHub Pages will only support Kramdown, Jekyll's default Markdown engine." https://github.com/blog/2100-github-pages-now-faster-and-simpler-with-jekyll-3-0

Open source this blog?

Do we want to open source the blog and make it available for corrections, post suggestions as issues, etc?

As an example, Phil Haack has his blog as a public repository: https://github.com/Haacked/haacked.com / http://haacked.com/

Upgrade rimdev.io to Astro

💰 Refactor

🔧 Enhancement Request

Upgrade to Astro as a test bed to replace Hugo.

Benefits of refactor

Faster builds, moving technology forward.

remove decision tree menu link

💰 Refactor

Benefits of refactor

remove decision tree menu link from main nav, it hasn't been updated in 4 years.