emmahsax

Jekyll Feed with Multiple Environments

What this will do is generate a two different feeds:

• A feed.xml for your local development, which will contain the values you specify for your development environment in your _config.yml.
• A feed.xml for your live site, which will have the values set in your _config.yml for your production environment.

This is necessary because without different values for title, description, etc, many feed readers will view the two feeds as the same, even if the post content is different This makes it difficult to test if your feed is working and updating locally.

You could add additional environments as well, such as development, test, staging, and production.

emmahsax

Blog Post Pagination with jekyll-paginate-v2

This uses the pagination provided here. See the pagination in action at https://emmasax.com/blog/.

Let's start with the basics. Here's what the Jekyll _config.yml should look like:

title: An Awesome Blog
description: My blog, which is awesome
url: https://an-awesome-blog.com

emmahsax

Opening External Links in New Tabs with Javascript

Here's the snippet of HTML that can be used to call this file:

<script src="/js/opening-external-links-in-new-tabs.js" type="text/javascript"></script>

And here's the JS file opening-external-links-in-new-tabs.js:

emmahsax

Turn UTC Dates to Local Timezone with Javascript

Here's the snippet of HTML that can be used to call this file:

<script src="/js/turn-utc-dates-to-local-timezone.js" type="text/javascript"></script>

And here's the JS file turn-utc-dates-to-local-timezone.js:

emmahsax

CircleCI Configuration to Ignore a Branch

This file live in the .circleci/ directory of your project, named config.yml:

version: 2.1
jobs:
  skip:
    working_directory: ~/PROJECT_DIRECTORY # If we leave this out, the build will break with missing required arguments
 docker: [ image: circleci/ruby:2.6.5 ] # This doesn't really matter, but just choose any docker image

emmahsax

Fixing Git History

There are two files that I tend to use to fix up some screwed up git history. None of these files should be used on huge repositories where a lot of people have forks and clones. Running any of these files completely rewrites history and will change the git SHA of all of the later commits.

I've used this first file when I've accidentally committed a bunch of past commits with the wrong email (think work vs. personal emails). To use it:

1. Make a backup branch: git branch default_branch_backup
2. Make sure you're back on the default branch: git checkout default_branch
3. Run the script: email_switch.sh
4. Wait patiently...

emmahsax

Static Site URLs and Links

Documentation to make it easier to debug linking to images, resources, CSS, and JS within a static site that's generated via Jekyll.

• When calling CSS and JS from the ./_includes and ./_layouts directories
  • Hosting Pages in the Root Directory
  • Hosting Pages in a Sub-Directory
• When linking to images and resources from HTML/Markdown pages
  • Hosting Pages in the Root Directory
• Hosting Pages in a Sub-Directory

emmahsax

Personal Git Aliases

A list of git aliases I use on my machines to make working with GitHub and GitLab a little bit faster.

For more information, see my Ruby command-line gem: emmahsax/git_helper.

alias gadd='git add -A'
alias gaddp='git add -p'
alias gcam='git commit -am'

emmahsax

Switching from master Branch to main Branch

From the terminal, run this:

git checkout master
git branch -m master main
git fetch
git branch --unset-upstream
git branch -u origin/main

emmahsax

Turn Seconds into Human-Readable Time with Ruby

If you have an integer which is an amount of seconds, you can easily turn it into the form

X days, Y hours, Z minutes, Q seconds

Here's a little method that will do all of that!