Structured Data RDFa Lite Jekyll theme

This Jekyll theme (live demo) provides structured data markup in the form of RDFa Lite for maximum human readability and smaller files (less repetition than JSON-LD, microdata, or full RDFa. Additionally, for best practices purposes it is based on HTML5 Boilerplate (v7.0.1), hence some additional directories (styles, scripts, html5-boilerplate-docs, .colophon) and files (.editorconfig, .htaccess, 404.html, site.webmanifest, robots.txt, humans.txt, browserconfig.xml).

The favicon.ico, icon.png, tile.png, and tile-wide.png files are images provided by HTML5 Boilerplate and left as-is so that you can get an idea for the sizes involved. They should, of course, be replaced ASAP with images appropriate to YOUR site.

The structured data schemas currently implemented are WebPage (AboutPage, ContactPage), Blog, BlogPosting, and Event.

In future, I plan to - implement schemas: Review, Book, HowTo, and CollectionPage (ImageGallery). - integrate responsiveness - better (actually) utilize SASS. - implement breadcrumbs

Installation

Add this line to your Jekyll site's Gemfile (note the version of paginate-v2, as of early 2019 there is a problem:

gem "structRDFaL"
gem 'jekyll-paginate-v2', '2.0.0'

And add this line to your Jekyll site's _config.yml:

theme: structRDFaL

And then execute:

$ bundle

Or install it yourself as:

$ gem install structRDFaL

Usage

_layouts

_includes

assets

Everything in the assets directory should be moved out to the root directory of your site where they are EXPECTED (.colophon is optional and just for your information). The images are there mostly for your sizing reference when you create your own. Obviously, customize away, nothing needs to remain as-is.

There is only a slight (real) difference between HTML5 Boilerplate's 404.html and the one that Jekyll generates when you create a new instantiation, so what you want to do there is entirely up to you.

Actually, eventform.html and contactform.html are forms that I use on my sites to capture data from the public, feel free to mod and use if you're incorporating Events or don't have any other contact type plans. Also tag.html and category.html are used in conjunction with catag-old.html

_sass

I'm just learning Sass, so the only thing in _sass directory is the pieces for normalize-scss, read about it in the .colophon

_config.yml

The jekyll-paginate-v2 plugin is expected * in the configuring of paginate, to handle multi-word tags and categories, use

autopages:
  categories:
    slugify:
      mode: pretty
  tags:
    slugify:
      mode: pretty

These are OPTIONAL

Per Page Frontmatter Options

Read the comments in the default.html layout for more options.

Contributing

Bug reports and pull requests are welcome on GitHub at github.com/arghc/structRDFaL. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The theme is available as open source under the terms of the MIT License.