Skip to content

Latest commit

 

History

History
62 lines (40 loc) · 2.1 KB

README.md

File metadata and controls

62 lines (40 loc) · 2.1 KB

concerto-signage.org

This repo contains the website powering https://www.concerto-signage.org.

The static-site is powered by Jekyll, and hosts content describing a mix of Concerto 1 and Concerto 2. It was migrated from a custom-built CMS Rails app built ~2010.

Developing

This project includes a Devcontainer configuration. Open the folder in VS Code and choose "Reopen in Container" to get a pre-configured environment with Ruby and Jekyll installed.

Once inside the container (or if you have Ruby and Bundler installed locally):

  1. Install dependencies:

    bundle install

  2. Run the development server:

    bundle exec jekyll serve

Writing Blog Posts

Author setup

Authors are defined in _data/authors.yml. Each entry maps a short key to a display name and optional Twitter/X handle:

bamnet:
  name: Brian Michalski
  twitter: bamnet

To add yourself, add a new entry to the file with your preferred key and full name. Set twitter: 0 if you don't have a Twitter/X handle (this prevents the jekyll-seo-tag plugin from generating a bogus twitter:creator meta tag).

Use your key in post frontmatter:

author: bamnet

Social sharing

Every blog post automatically gets Open Graph and Twitter Card meta tags for rich link previews, powered by the jekyll-seo-tag plugin. The defaults are:

  • Image: /assets/images/blog_banner_1b.jpg (the blog banner)
  • Title/Description: pulled from the post's title and first paragraph

To customize a post's social preview, add optional frontmatter:

description: "A short summary for link previews and search results."
image: /assets/images/my-custom-image.jpg

Custom images should be 1200x630px (1.91:1 ratio). This is the recommended size for both Open Graph (Facebook, LinkedIn, Slack) and Twitter/X large image cards. Smaller images will work but may appear cropped or blurry on high-DPI screens.

Deploying

Deployments are handled via GitHub Actions. Commits to the master branch trigger the .github/workflows/deploy.yml workflow, which builds the site and deploys it to GitHub Pages.