• Ruby 2.5.0 or later (ruby -v)
• Bundler (gem install bundler)

$ bundle install

$ bundle exec jekyll serve

… and visit at localhost:4000.

$ bundle exec jekyll serve --drafts

$ gem pristine --all --no-extensions

To stay in sync with GitHub Pages run:

$ bundle update github-pages

In order to keep the outline of a post semantic in terms of accessibility, no heading level should be omitted. In case a visually smaller heading is wanted you can use heading classes:

## Looks like heading 3
{: .h3}

Unless you link to an external image add your photos to this location (create subfolders for year and month):

tropy.github.io
└── assets
    └── images
        └── blog

You can specify one (high-res) image in the post’s front matter that will be rendered on top of the post’s content (but it is not rendered in the post excerpts).

The post image can be used as a large preview image in tweets instead of the smaller Tropy icon. As Twitter crops preview images it is not recommended to use them for artwork, add artwork as image to your tweet instead of the preview.

Both a low-res (e.g. image.png) and a high-res (e.g. image@2x.png) version must exist.

---
image: /path/to/[email protected]
twitter:
  card: summary_large_image
---

Use a liquid tag to embed images with multiple resolutions (specify @2x version only):

{% include image src="/path/to/[email protected]" alt="" %}

Use a liquid tag for images with captions (specify @2x version for responsive images):

{% include figure src="/path/to/[email protected]" alt="" caption="Example" %}

Heads up: use single quotes inside captions: caption="<a href='…'>Source</a>"

You can add a shadow and rounded corners to images and figures by adding the screenshot class:

{% include image src="…" alt="…" class="screenshot" %}

If all you want is a border, you can add the border class instead:

{% include image src="…" alt="…" class="border" %}

Push to GitHub and your changes are live.

The file _includes/third-party-notices.html is automatically generated and should not be changed by hand. To update, checkout [tropy/tropy] and point Tropy's legal script to the includes folder:

npm run legal -- -o ../tropy.github.io/_includes