OHBM ComCom blog content transfer to Squarespace

Prerequisite

You will need a Squarespace account and ask an admin for the "Website Editor" permission to add or edit posts. Join #website channel on Slack and notify Sin or Alfie to get started!

This guide also assumes you have access to the Transfer Checklist spreadsheet. Check #website channel's description on Slack!

Transferring a post

1. Each row contains a link to the original blog page and the matching GitHub repository folder. Open them.
2. Create a new Squarespace blog page by clicking "+" button under Pages > Blog > Blog Content.
3. Copy title from the metadata.json file in the folder.
   • Copying from the original blog may carry over additional HTML that we do not want.
4. Add images. They can be downloaded in order from the GitHub folder.
   • Some images may be missing or wrong. You will have to find the right images from the original blog or the Internet Archive.
   • For common images (like logos), avoid uploading duplicates. Try searching the image library ("Select from Library").
   • Captions can be copied from text.html and styled manually or just copied from the original blog.
     • Tip: Ctrl+Shift+V pastes text without formatting.
5. Add text. Insert code blocks between images and copy lines of HTML from text.html.
   • Check the style guide for more details like how to put text beside images!
   • Tables will need to be recreated in HTML or Markdown. If you are not sure how, skip it and write a TODO note in the spreadsheet's "Notes" column.
6. Compare with the original and make changes if necessary.
   • Feel free to improve upon the original if you can. Note what you did in the "Notes" column.
   • If you can't fix some discrepancy, note it in the "Notes" column.
7. When you are done, open settings (click on the date above title).
   • Content > Featured Image: Use "Search for Images" to choose a preview image among post images.
     • If the post has no image, you can default to a common logo.
   • Options > Status: Set "Needs Review".

The whole process takes ~15 min on average. Video guide:

transferring.webm

Reviewing a post

1. Open the post with EDIT. Do NOT review using Squarespace's side preview because it breaks some code!
2. Text: Check spaces/line breaks and general style consistency.
3. Image: Check that all images are present.
4. Add "By " or "Author: " before the author name in the text when appropriate for clarity.
5. If everything looks good, open settings (click on date above title).
   • Content > Excerpt: Copy "Author: ..." from the text without formatting (Ctrl+Shift+V)
   • Content > Post URL: Copy the original URL name from the spreadsheet (blog/article-name).
   • Options > Status: Set "Published". Change the date to original's date in the past. Time can be whatever.
     • Selecting a date from many months ago can be frustrating with Squarespace's UI. Use this bookmarklet tool to go faster!
   • Options > Categories: For posts that are part of a series, add appropriate categories.
     • Award winner interviews, Keynote interviews...
     • SIGs: OHBM ComCom, OHBM OSSIG...

Style guide

Text

• Title: Default heading and font, no all caps
• Author: Paragraph 1, no all caps
• Subtitle: Paragraph 2 (color 3, dark blue)
• Section header: Heading 4
• Main text: Paragraph 2 (default)
  • Use natural margin between paragraphs rather than double line break.
  • No indentation on paragraphs, just new line (this doesn't necessarily need to be consistent across sections)
• Image captions: Paragraph 3 (automatically applied now)

Image

There are 2 ways of adding text beside an image:

• Set the image to "Card" design and add text as the image subtitle. This keeps the image's original size.
• Create a code/text block, then drag the block to the image's side. This lets you resize the image by dragging the border between blocks.

TODO

• Organize by date
• Re-link all https://www.ohbmbrainmappingblog.com links