checklist for a blog post referencing an external digital object (image, pdf)

checklist for a blog post referencing items from Digital Collections

• fetch origin from spec-lumber repository in GitHub Desktop
• create new markdown file in Visual Studio Code
• add frontmatter to post
• add external digital objects to post
• preview your post
• push changes (this is a 3-step process)
  • stage
  • commit
  • push

---

Step 1: fetch origin from spec-lumber repository in GitHub Desktop

1. Open GitHub Desktop
2. Set "Current Repository" to "spec-lumber"
3. click "fetch origin"

Step 2: open Visual Studio Code

1. open GitHub Desktop and click "Open in Visual Studio Code." This will open the spec-lumber repository in Visual Studio Code

Step 3: open terminal

1. in Visual Studio Code, click on "Terminal" and "New Terminal" in the top menu
   • NOTE: make sure the terminal is set to "bash." The terminal should look similar to this:

If your terminal does NOT look like this, try the following:

• make sure you're viewing the "Terminal tab" (view tabs at top left of screenshot)
• make sure your terminal is using Bash. You can view different terminal types where it says "1: bash" in the screenshot and use the drop down menu to select the correct terminal.

Step 4: create new markdown file in Visual Studio Code

1. in Visual Studio Code, type rake new_post title="title of post" into the terminal and hit the Enter key. A new post should be created in the _posts folder (which you can find in the left-hand navigation menu in Visual Studio Code)
   • NOTE: the "date" field at the top of the blog post is what dictates when the post goes live on Harvester. The file name (left hand menu) includes the date, but has no effect on when the post goes live. BEST PRACTICE is to match these two dates to whenever you want the post to go live. To change the file name, right-click on the file name (left hand menu) and click "Rename."

Step 5: add frontmatter to post

1. in Visual Studio Code, open the new post you just created. Add the top fields as applicable.
   • NOTE: the cover-image should just include a link to the object, not the object page
   • NOTE: check out Creating a Series and Adding a Post to a Series if your post is part of a series
   • NOTE: tags and categories must be formatted as follows, or it will break:

Step 6: add external digital objects to post

1. use the following include for an external digital object:
   • {% include feature/image.html objectid="link to object" link="link to page" caption="caption" %}

Step 7: preview your post

1. when the content of your post has been written in Visual Studio Code, you can preview the post by typing bundle exec jekyll s -i into the terminal
   • NOTE: the date field at the top must be set for the present day or before. If the date is set for the future, you won't be able to view the post in the preview.

NOTE: if you receive a terminal error like this, it means there is an error in the code that is preventing it from fully parsing. The error will tell you which file, line, and column to look in, so you can narrow your search for the error. Here is the terminal error it will show you:

Here is the error (should be ["category"] with a closing bracket.

Step 8: stage your changes

1. Go to the Source Control view in Visual Studio Code

2. click on the "+" (plus) symbol to stage your changes

Step 9: commit your changes

1. once your changes are staged, add a descriptive message about what your changes are. Then click on the "checkmark" to commit your changes to your local GitHub repository on your local machine

Step 10: push your changes

1. open GitHub Desktop. You should see your descriptive message on the bottom left. If you've committed changes by accident, you can undo your commit here. If you want to push your commit, click on "Push Origin" at the top. This will push your commits to the cloud GitHub Repo, and will make your changes live on the Harvester website in approx. 5-10 minutes, or whenever the post is scheduled.