Skip to content

checklist for a blog post with objects added to the Lumber collection

Jump to bottom
juliastone0729 edited this page Oct 26, 2023 · 50 revisions

checklist for a blog post with objects added to the Lumber collection

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: add digital objects to GitHub repository

  1. open Windows File Explorer
  2. add images to Documents/GitHub/spec-lumber/objects/archives folder

Step 3: add metadata to csv sheet

  1. add image metadata to the Lumber metadata csv Google sheet
    • NOTE: view this metadata guide if you're unsure how to fill out spreadsheet
    • NOTE: if your images are .tiff or anything other than .jpg, you must add the filename extension as .jpg in the metadata sheet because jpgs will be generated when you run the rake generate_derivatives command. Failing to do this can lead to broken images in the jekyll preview and live Harvester.
    • NOTE: file names cannot contain any spaces, or the rake generate_derivatives command will not work.
    • NOTE: file naming best practice includes only using lowercase letters, and using descriptive naming (i.e. pg83-folder2-item5).

Step 4: add csv sheet to GitHub repository

  1. open the Lumber metadata csv Google sheet and go to File/Download/comma-separated values (.csv) to download the Google sheet as a csv
  2. open Windows File Explorer and navigate to Documents/GitHub/spec-lumber/_data and replace the existing lumber.csv with the csv you just downloaded from Google sheets

Step 5: 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 6: 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 7: generate derivatives of digital objects

  1. in Visual Studio Code, type rake generate_derivatives into the terminal and hit Enter. This should create derivatives of the digital object(s) you put into the Documents/GitHub/spec-lumber/objects/archives folder.

Step 8: move derivatives to S: Drive

  1. move derivatives FROM Documents/GitHub/spec-lumber/objects TO Shared (S:) drive/Webpages/Library/spec/harvester/objects
    • NOTE: it's important to move derivatives into the correct folder, or it can lead to broken images. Use the color code:

Step 9: 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 10: add frontmatter to post

  1. in Visual Studio Code, open the new post you just created. Add the top fields as applicable.

Step 11: add digital objects to post

  1. to add images to the body of the post, use the following command and add the objectid from the Lumber csv spreadsheet: {% include feature/image.html objectid="lumber###" %}

Step 12 (optional): include images side-by-side

  1. to include images side-by-side, you can format the include command like this: {% include feature/image.html objectid="lumber###;lumber###;lumber###" %}

Step 13: preview your post

  1. when the content of your post has been written in Visual Studio Code, you can preview the post by typing rake dev into the terminal. Hold down command and click on the server address (e.g., http://127.0.0.1:4000) to open the site preview.
    • 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 14: stage your changes

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

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

Step 15: 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 16: 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.

Clone this wiki locally