News and Updates

Let’s welcome the February’17 Edition of the Planet Jekyll’s Showcase that highlights the latest (and greatest) static websites built with the Jekyll machinery. New websites (with sources) include:

• Neovim // Literally the future of vim
• Leaflet // A JavaScript library for interactive maps
• Babel // A JavaScript compiler. Use next generation JavaScript, today
• MarkSheet // Free HTML & CSS Tutorial (4 Sections, 9 Chapters, 50 Lessons)
• HTML Reference // Learn by example: free guide to HTML
• CSS Reference // Free visual guide to the most popular CSS properties
• Vienna.html // (Static) Website Meetup in Austria
• Ruby Habits Vienna // Learning Group in Austria
• Open Source Guides // Learn how to launch and grow your project
• Scorsese - (Museum) Audio Guide // Australian Centre for the Moving Image (ACMI)

Any site missing? Add your site! Happy Publishing w/ Jekyll ‘n’ friends. Cheers.

Let’s welcome the February’17 Edition of the Dr. Jekyll’s Themes of the Month series that highlights ready-to-fork - or (new!) ready-to-bundle - static (web)site themes. New themes include:

Console by Jae Hee Lee • Emping by Rahmat Subekti • Chalk by Nielsen Ramon • Papyrus by Hugo Sereno Ferreira • Alembic by David Darnes • Clean by Siddhant Goel • Lagrange by Paul Le • Kikofri by Johan T Katiska • Whiteglass by Chayoung You • Blade by Mateus Medeiros • Surgeon Tux by Lahiru Pathirage • Be Nice 17 by Viet Anh Nguyen • Schemadoc by Gerald Bauer • Octopod’s Bootflat by Stefan Haslinger

In the Pages series by GitHub Inc:

Architect by Jason Long et al • Cayman by Jason Long et al • Dinky by Diana Mounter et al • Hacker by Jason Costello et al • Leap Day by Matt Graham et al • Merlot by Cameron McEfee et al • Midnight by Matt Graham et al • Minimal by Steve Smith et al • Modernist by Steve Smith et al • Slate by Jason Costello et al • Tactile by Jason Long et al • Time Machine by Jon Rohan et al

In the series by CloudCannon:

Cause by Mike Neumegen et al • Edition by Ross Phillips et al • Frisco by Mike Neumegen et al • Hydra by Mike Neumegen et al • Justice by Ross Phillips et al • Malt by Mike Neumegen et al • Urban by George Phillips et al

Special thanks to Jae Hee Lee, Rahmat Subekti, Nielsen Ramon, Hugo Sereno Ferreira, David Darnes, Siddhant Goel, Paul Le, Johan T Katiska, Chayoung You, Mateus Medeiros, Lahiru Pathirage and Viet Anh Nguyen for adding the new themes.

Find all themes at the Dr. Jekyll’s Themes directory. Any theme missing? Add your theme! Happy Publishing with Jekyll ‘n’ friends. Cheers.

Welcome back. The Planet Jekyll Plugin of the Month series presents a new addon for your (static) web pages every month.

What’s the jemoji gem?

Let’s thank Ben Balter, Parker Moore and friends who have created the jemoji gem that lets you add 500+ emojis, that is, simileys, thumbs ups (+1s) and much more to your pages using shortcodes.

To spice up your plain text use “shortcodes” that will get (auto-)converted to mini inline pictures. Example:

I give the jemoji plugin two :+1:!

resulting in:

I give the jemoji plugin two !

How are you feeling today?

To add a “classic” similey use any of the 20+ shortcodes. Example:

:smile: :laughing: :blush: :smiley: :relaxed: :smirk: :heart_eyes: :kissing_heart: :kissing_closed_eyes: :flushed: :relieved: :satisfied: :grin: :wink: :stuck_out_tongue_winking_eye: :stuck_out_tongue_closed_eyes: :grinning: :kissing: :kissing_smiling_eyes: :stuck_out_tongue: :sleeping: :worried: :frowning: :anguished: :open_mouth: :grimacing: :confused: :hushed: :expressionless: :unamused: :sweat_smile: :sweat: :disappointed_relieved: :weary: :pensive: :disappointed: :confounded: :fearful: :cold_sweat: :persevere: :cry: :sob: :joy: :astonished: :scream: :tired_face: :angry: :rage: :triumph: :sleepy: :yum: :mask: :sunglasses: :dizzy_face: :imp: :smiling_imp: :neutral_face: :innocent: :alien:

Cats, Cats, Cats

Or add some cats:

:smiley_cat: :smile_cat: :heart_eyes_cat: :kissing_cat: :smirk_cat: :scream_cat: :crying_cat_face: :joy_cat: :pouting_cat:

Or add some roses or tulips or on and on and on. See the Emoji Cheet Sheet for more than 500+ shortcodes.

How does it work?

The emoji plugin runs your text through a filter (that is, HTML::Pipeline::EmojiFilter) and replaces all known :shortcodes: with images (served from GitHub.com). Example:

:+1:

becomes (in HTML):

<img class="emoji" 
     title=":+1:" 
     alt=":+1:"
     src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f44d.png" 
     height="20" width="20" 
     align="absmiddle">

resulting in:

Yes, Works with GitHub Pages

Last but not least - the good news - the jemoji gem is an official white-listed GitHub Pages plugin. To use it add the following to your site’s _config.yml file:

gems:
- jemoji

That’s it. Happy Publishing with Jekyll.

Bonus: Can You Crack the Emoji Code?

Easy -

Hard -

What does it mean?!

Learn More

• home :: jekyll/jemoji
• gem :: jemoji
• rdoc :: jemoji

Welcome. The Planet Jekyll Plugin of the Month series presents a new addon for your (static) web pages every month.

What’s the jekyll-avatar gem?

Let’s thank Ben Balter who has created the jekyll-avatar gem that lets you add GitHub avatars, that is, user profile pics - to your pages.

Use the new avatar tag and pass in the user’s login. Example:

{% avatar benbalter %}

will result in:

or in HTML:

<img class="avatar avatar-small" 
     src="https://avatars3.githubusercontent.com/benbalter?v=3&amp;s=40" 
     alt="benbalter" 
     srcset="https://avatars3.githubusercontent.com/benbalter?v=3&amp;s=40 1x, 
             https://avatars3.githubusercontent.com/benbalter?v=3&amp;s=80 2x, 
             https://avatars3.githubusercontent.com/benbalter?v=3&amp;s=120 3x, 
             https://avatars3.githubusercontent.com/benbalter?v=3&amp;s=160 4x" 
     width="40" height="40" />

Big, Bigger, Biggest

Use the size argument to make the avatar bigger. Example:

{% avatar benbalter size=80 %}
{% avatar benbalter size=100 %}
{% avatar benbalter size=150 %}

will result in:

All Together

If you have a list of users e.g. speakers, members, etc. use a loop. Example:

{% for member in site.data.members %}
    {% avatar user=member.github size=50 %}
{% endfor %}

(Source: viennahtml.github.io/_includes/members.html)

resulting in:

and many more ;-)

Yes, Works with GitHub Pages

Last but not least - the good news - the jekyll-avatar gem is an official white-listed GitHub Pages plugin. To use it add the following to your site’s _config.yml file:

gems:
- jekyll-avatar

That’s it. Happy Publishing with Jekyll.

Bonus: Build the next Meetup.com - Example: Vienna.html (Static) Meetup Site

Why not build your next meetup site with Jekyll? See the Vienna.html meetup site as a (real-world) live example ;-) - Site Sources, Members Page, Speakers Page, etc.

Learn More

• home :: benbalter/jekyll-avatar
• gem :: jekyll-avatar
• rdoc :: jekyll-avatar

Let’s welcome the October’16 Edition of the Planet Jekyll’s Showcase that highlights the latest (and greatest) static sites built with the Jekyll machinery. New websites (with sources) include:

• Hyde Press Bookshelf // Free Books about Jekyll ‘n’ Friends
• World Classics // The World’s Greatest (Literature) Books in .txt
• Zen of Book Designs / Epsilon (Franklin) // One Book, Many Designs - Add Your Design!
• Markdown Tutorial // Lessons for Writers
• Bootstrap Expo // Beautiful and inspiring uses of Bootstrap
• Font Library // Over 800 Google Fonts, Let’s Organize Them!
• Brick // Google Web Fonts Alternative
• Static Map Maker // Bing, Google, Mapbox, ‘n’ More
• Postgres Guide // Guide to the world’s most advanced open source database
• Octopod // Podcast publishing extension for Jekyll

Any site missing? Add your site! Happy Jekylling. Cheers.

Let’s welcome the September’16 Edition of the Planet Jekyll’s Showcase that highlights the latest (and greatest) static sites built with the Jekyll machinery. New websites (with sources) include:

• Ruby Language // Official Site of the Ruby Programming Language
• Riding Rails Weblog // Official Ruby on Rails Weblog
• Yarn Package Manager // Fast, Reliable, and Secure Dependency Management
• Travis Foundation // Working towards a better open source community
• Docker: Welcome to the Docs // Build, Ship, Run. An open platform for distributed apps for devs and sysadmins
• Elixir School // Lessons about the Elixir programming language
• Swift Weekly Brief // A community-driven weekly newsletter about Swift.org
• csv,conf,v2 // A community conference for data makers everywhere, again!
• Climate Treaty Texts from Paris COP21 // Making the texts of the international climate change conference easy to find, understand and use
• Raw Funk Maharishi // Bringing the weird grooves since 2013 (Music Band)

Any site missing? Add your site! Happy Jekylling. Cheers.

Let’s welcome the August’15 Edition of the Dr. Jekyll’s Themes of the Month series that highlights ready-to-fork static site themes. New themes include:

• Leonids by RenYuan Zou
• Video by Max White
• Centrarium by Ben Centra
• Mickey by Vincent Chan
• Material Design Lite (MDL) by Oscar Cortez
• Henry’s Starter (Minimal) by Gerald Bauer

Special thanks to RenYuan Zou, Max White, Ben Centra, Vincent Chan and Oscar Cortez for adding the new themes.

Find all themes at the Dr. Jekyll’s Themes directory. Any theme missing? Add your theme! Happy Jekylling. Cheers.

Let’s welcome the mrhyde-tools gem that includes a command line tool, that is, mrhyde that lets you run static site quick starter wizard scripts. For example, use:

$ mrhyde new starter   # or
$ mrh n starter

to download and install (unzip/unpack) a theme archive and configure a static site ready-to-use e.g.:

Welcome, before setting up your site Mr. Hyde will ask you some questions.

Q: What's your site's title? [Your Site Title]:  Another Beautiful Static Site
Q: What's your name? [Henry Jekyll]: Edward Hyde
Q: Select your theme:
     1 - Starter
     2 - Bootstrap
     3 - Minimal
   Your choice (1-3)? [1]: 2

 Thanks! Ready-to-go. Stand back.

  Downloading Henry's Bootstrap Theme...
  Setting up Henry's Bootstrap Theme..
  ...
  Updating settings in _config.yml...
    title: "Another Beautiful Static Site"
    author.name: "Edward Hyde"
  ...
 Done.

Why not write your own Mr. Hyde wizard script? It’s just Ruby (with an added mini language) e.g.:

say "Welcome, before setting up your site Mr. Hyde will ask you some questions."

title = ask "What's your site's title", "Your Site Title"

name  = ask "What's your name", "Henry Jekyll"

theme = select "Select your theme", ["Starter", "Bootstrap", "Minimal"]

say "Thanks! Ready-to-go. Stand back."

install_theme theme

config do |c|
  c.title        = title
  c.author.name  = name
end

say "Done."

For more quick starter wizard scripts see the Mr. Hyde’s Scripts library. For more themes see the Dr. Jekyll’s Themes directory. Cheers.

Let’s welcome the drjekyll gem that includes a command line tool, that is, drjekyll that lets you manage static site theme packages. For example, use:

$ drjekyll list     # or
$ drj ls

to list all 100+ themes e.g. resulting in:

  1..Henry's Starter (Minimal) (starter | henrysstarterminimal) by Gerald Bauer - #white
  2..Henry's Minimal (minimial | henrysminimal) by Gerald Bauer - #white
  3..Henry's Bootstrap (bootstrap | henrysbootstrap) by Gerald Bauer - #bootstrap #sass #white
  4..Henry's Classics Book (classics | henrysclassicsbook) by Gerald Bauer - #books #white
  5..Poole (poole) by Mark Otto - #poole
  6..Poole's Hyde (pooleshyde) by Mark Otto - #poole
  7..Poole's Lanyon (pooleslanyon) by Mark Otto - #poole
  8..Beautiful Jekyll (beautifuljekyll) by Dean Attali
  ...

To download and unzip a theme archive use the “installation code”, for example, use:

$ drjekyll new starter   # or
$ drj new starter

to dowload and unzip the Henry’s Starter (Minimal) theme and so on. For more info see the drj/drjekyll project site. Cheers.

Let’s welcome Planet Jekyll’s Showcase that highlights the latest (and greatest) static sites built with the Jekyll machinery. New websites (with sources) include:

• Bootstrap // The World’s Most Popular Mobile-First and Responsive Front-End Framework
• Electron // Build Cross Platform Desktop Apps with Web Technologies
• Planet Ruby // All the News About Ruby, JRuby, Opal, Jekyll, Sinatra, etc.
• football.db // Free Open Public Domain Football Data
• Choose A License // What best describes your situation?
• Stack Exchange Blog // All Things About Stack Exchange (Development)
• PHP: The Right Way // A Quick Reference for Best Practices, Coding Standards, and Links to Tutorials around the Web
• Open Data Handbok // Guides, Case Studies and Resources for Government ‘n’ Civil Society on the What, Why ‘n’ How of Open Data
• and many more.

Any site missing? Add your site! Happy Jekylling. Cheers.

Let’s welcome the July’15 Edition of the Dr. Jekyll’s Themes of the Month series that highlights ready-to-fork static site themes. New themes include:

• Holo Alfa by Stijn van Cuijk
• { Personal } by Panos Sakkos
• Clean Dark by Pavel Makhov

Special thanks to Stijn van Cuijk, Panos Sakkos and Pavel Makhov for adding the new themes.

Find all themes at the Dr. Jekyll’s Themes directory. Any theme missing? Add your theme! Happy Jekylling. Cheers.

Still a little early - if you happen to be in Central Europe - Gerald Bauer is starting up Europe’s first Static Site (Jekyll) User Group in Vienna, Austria. The group name is Vienna.html in honor of the static nature of a Jekyll site.

Missing out? No worries - why not start your own YourCity.html group (e.g Berlin.html, Seattle.html, and so on.) Anyone?

If you’re interested in all things “Static is the new Dynamic” follow along on Twitter @viennahtml. Join us. Free. No database required. Cheers.