ELLO 👋 JEKYLL: A vCard-style Jekyll Theme

Ello is a simple animated Jekyll vCard-style theme by Randall, optimized for use with GitHub Pages (but can be used wherever Jekyll can be installed).

Utilizing this theme you can create a simple vCard-style web site with embedded h-card and Schema data; which can then serve as a centralized location with all your contact data.

You can also look my personal GitHub Pages site, which uses this theme but has several modifications.

My GitHub Pages site: https://ran-dall.github.io/

My GitHub Pages site repo: https://github.com/ran-dall/ran-dall.github.io

Add this line to your Jekyll site's Gemfile:

gem "ello-jekyll-vcard-theme"

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

theme: ello-jekyll-vcard-theme

And then execute:

$ bundle

Or install it yourself as:

$ gem install ello-jekyll-vcard-theme

Use main.yaml to update the information on the contact-box area with whatever you wish to display.

Use details.yaml to list all the profiles you want to link to from your site. Currently, there can be up to 24 contact links; but it's something you can modify on line 216.

If you install this theme as a remote-theme for GitHub Pages or as a gem (GitHub Pages or not), you'll be required to make your own index.html, _data/main.yaml, and data/details.yaml files. You can use the files included in this repository (which initially came from my GitHub Pages site) as a working example of what's required.

If you would like to use the Jekyll SEO tag to add relevant JSON-LD data; you must add the required {% seo %} in the header.

If you plan on using this theme on GitHub Pages, it is prefered you use is as a 'remote theme.' To do so, you must declare ello-jekyll-vcard-theme in your _config.yaml file as a remote-theme as described in this blog post.

The h-card Mircoformat2 format is a simple specification which updates the hcard Microformat specification, which focused on bringing vCards to the web. Aside from publishing information about a person, when combined with XFN, h-card has some of the basic functionality required to declare relationships to achieve social-network-portability.

The details.yaml file, has an assigned h-card area embedded with the specific h-card options in each contact entry.

• http://microformats.org/wiki/h-card
  • The h-card web page
• http://microformats.org/wiki/hcard
  • The hcard web page

• https://indiewebify.me/validate-h-card/?url=https%3A%2F%2Fran-dall.github.io%2Fello-jekyll%2F
• https://pin13.net/mf2/?url=https%3A%2F%2Fran-dall.github.io%2Fello-jekyll%2F

• http://microformats.org/wiki/microformats2
  • The microformats2 web page
• https://developer.mozilla.org/en-US/docs/Web/HTML/microformats
  • Mozilla's knowledge base article describing microformats
• http://microformats.org/wiki/hcard-supporting-user-profiles
  • A page abouthcard's social-network-portability features
• https://stackoverflow.com/questions/25840618/social-media-profiles-in-h-card-html-microformats
  • An experimental idea to implement Social Media Network names into h-card
• http://xmlns.com/foaf/spec/
  • The FOAF web page
• http://microformats.org/wiki/xfn-to-foaf
  • Information on XFN to FOAF

If you wish to display a Favicon, you may do so by simply adding a .png image to the root of the site.

• hi - The main message displayed on the top of the contact-box. In the example provided, I'm using a secondary site.data.details.name variable to input my name; which can be further modified in the details.yaml file.

• message - The secondary message displayed on the mid-section of the contact-box.

• cta-button - The call-to-action message displayed on the button, which is then displayed in the contact-box.

• cta-title - The message displayed when the contact-box is active.

• name - Your name (only required if you're using the site.data.details.name variable)

• avatar - Your GitHub avatar. Reference the jekyll-avatar repo for more information on how to use.

• contact - Enter your information in the following format:

  • profile - Name of the Network, which will be displayed
  • network - Slug (short-name) of the Network, which is used to assign styles. See note below.
  • user-id - Your User-ID on the Network, which will be displayed as a subtitle.
  • link - Link to your profile on Network, which will be linked to the box.
  • icon - Link from Font-Awesome Icon Library, which will be displayed.
  • h-card
    • class - a h-card formatted class
    • secondary-class - a h-card formatted secondary class or value
    • rel - can be used to add XFN rel attributes

It's important to note that Google strongly discourages hidden data, but in case you do want to embed some extra info; you may do so by adding it to the includes/hidden.html file. You can see the example file that's included in this repo for a working example.

Currently ONLY the following Networks are supported (#HEX included):

• icloud: #A3AAAE - iCloud's color
• s(ecure)-email: #0091FF - Criptext's color
• headmaster: #ff5555 - Headmaster's Color (...my Medium publication)
• work: #bd93f9 - Conjured's Color (...where I work)
• google: #4285f4
• keybase: #4c8eff
• github: #6e5494
• gitlab: #fc6d26
• bitbucket: #205081
• medium: #00ab6c
• dribbble: #ea4c89
• behance: #1769ff
• telegram: #0088CC
• linkedin: #0077B5
• angellist: #000
• facebook: #3b5998
• twitter: #1da1f2

To add more Networks, you must also add the network in _sass/components/contact-box.scss. On line 262, you should see the top of the currently supported Networks listed. You can add the network anywhere you desire in the following format...

  &.<slug-from-details-yaml> {
    @include icon-styles($<network-variable-from-details-yaml>)
  }

Currently, there can be up to 24 contact links; but it's something you can modify on line 216.

You are more than welcome to add more with Jekyll's override feature for Gem themes and/or contribute the modification to this theme's GitHub repository.

Bug reports and pull requests are welcome on GitHub at https://github.com/ran-dall/ello-jekyll. 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.

To set up your environment to develop this theme, run bundle install.

Your theme is setup just like a normal Jekyll site! To test your theme, run bundle exec jekyll serve and open your browser at http://localhost:4000. This starts a Jekyll server using your theme. Add pages, documents, data, etc. like normal to test your theme's contents. As you make modifications to your theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal.

When your theme is released, only the files in _layouts, _includes, _sass and assets tracked with Git will be bundled. To add a custom directory to your theme-gem, please edit the regexp in vcard.gemspec accordingly.

The theme is available as open source under the terms of the Mozilla Public License 2.0.