dieghernan / chulapa

A full flexible Jekyll Theme for GitHub Pages

Chulapa

A full flexible Jekyll theme for Github Pages

Notable features

• Bootstrap 4 - Fully responsive
• Fontawesome 6 - v5 also supported. v4 is supported via shims but would be deprecated at some point
• 3 different navbar styles
• Atom and RSS 2.0 feed
• Internal search by Algolia, Lunr or Google Custom Search
• Comments by Disqus and Giscus
• Masonry gallery
• Video support - self-hosted or from core providers: Youtube, Vimeo, DailyMotion...
• Structured data for better SEO
• Code highlight - +20 Pygment styles
• Mathjax inside
• Google Analytics
• Twitter/X Cards and Open Graph data valid for Facebook, LinkedIn and WhatsApp
• 14+ preinstalled skins
• Powerful look-and-feel customization with a dedicated sandbox
• Archive, cloud tag and index special layouts
• Do you like breadcrumbs? We have it.
• Multiple authors with location, picture and social links. Travel blogs and colaborative sites welcome!

A great alternative for blogs, news, portfolios and personal sites. Want to know more? Go to Docs.

Installation

Sample _config file here.

There are three possible ways for installing Chulapa:

A. Use our Github Template

Recommended if your are starting from scratch.

Create a Github account, click this link and quickstart your site!

B. Remote theme method

Recommended if you are migrating a previous site.

If you prefer not to use the template, you can use the jekyll-remote-theme method. Just follow these steps:

1. Create a new GitHub repository or go to an existing one

2. Add this line to your _config.yml:

   remote_theme: dieghernan/chulapa
   
   ... more config options

3. Remove other remote_theme/theme instances of your _config.yml file.

C. Gem-based method 💎

With Gem-based themes, directories such as the assets, _layouts, _includes, and _sass are stored in the theme's gem, hidden from your immediate view. This allows for easier installation and updating as you don't have to manage any of the theme files.

To install as a Gem-based theme:

1. Add the following to your Gemfile:

   gem "chulapa-jekyll"

2. Fetch and update bundled gems by running the following Bundler command:

   bundle

3. Set the theme in your project's Jekyll _config.yml file:

   theme: chulapa-jekyll

To update the theme run bundle update.

Configuration and Layouts

You have available an extensive documentation here

Performance

License

The MIT License

Attributions

Chulapa is a font owned by the City Council of Madrid designed and produced by Joancarles Casasín y Pablo Gámez on a previous design of Silvia Fernández Palomar licensed under Creative Commons CC BY, Versión 4.0. This theme incorporates a modification of this work in order to provide support to the english language.

Bootstrap v.4.5 is released under the MIT license and is copyright 2020 Twitter.

Fontawesome 6.x is free, open source, and GPL friendly - License (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License).

This theme incorporates some pieces of code from Minimal Mistakes, Copyright (c) 2013-2020 Michael Rose and contributors distributed under the terms of the MIT license.

This theme incorporates Pygments CSS Themes, developed by jwarby distributed under the terms of The Unlicense.

This theme incorporates Ferpal Sans developed by Silvia Ferpal and it's free for personal use.

This theme incorporates Jekyll Pure Liquid Table of Contents, Copyright © 2017 Vladimir "allejo" Jimenez distributed under the terms of the MIT license.

This theme incorporates Compress HTML in Jekyll, Copyright (c) 2014 Anatol Broder distributed under the terms of the MIT license.

This theme incorporates Lunr, Copyright (c) 2013 Oliver Nightingale. Lunr is distributed under the terms of the MIT License.

This theme uses graphic resources from Unplash.

This theme uses graphic resources from Pexels.

This theme uses graphic resources from Lorem Picsum.

chulapa's Issues

cloudtag broken in Jekyll >= 4.1.0

Discussed in #28

^{Originally posted by cargocultprogramming June 17, 2023}
I'm playing around with vanilla version of chulapa (changed the skin etc. but nothing major), but the /tags page has issues for me. Seems there is never a tag.name assigned. If I add a print statement to the tag in cloudtag.html like this:

{% assign grouptag = alldocs | map: 'tags' | join: ',' | split: ',' | group_by: tag | sort: 'size' | reverse %} {%- for tag in grouptag -%} {{ tag }} {%- if forloop.first -%} {%- assign sizemax = tag.size -%} {%- elsif forloop.last -%} {% assign mid = tag.size | plus: sizemax | divided_by: 2 %} {%- endif -%} {%- endfor -%}

I get the following:

{"name"=>"", "items"=>["starter", "syntax", "kramdown", "starter", "syntax", "markdown", "skin", "bootstrap", "current-theme", "header-hero", "image", "demo", "landscape", "trips", "downtown", "project-links", "wikipedia", "image", "example", "demo", "layout", "guest-author", "image", "landscape", "trips", "downtown", "edinburgh", "kramdown", "bootstrap", "wikipedia", "demo", "image", "urban art", "street", "downtown", "image", "random", "manuscript", "markdown", "exciting-stuff", "wikipedia", "manuscript", "random", "diary", "school", "manuscript", "random", "exciting-stuff", "wikipedia", "pirates", "random", "wikipedia", "random", "exciting-stuff"], "size"=>54}

The rest of the page shows tags.size correctly, but nothing else obviously since tag.name is empty.

Seems something goes wrong in the grouptag assignment but I cannot figure it out. Any ideas?

Documentation on template elements

I really like your Jekyll templates and the fact that you provide them for free. Thanks a lot! I also like all the examples you show for the different skin styles, such as at Lymcha skin

However, I would really like to use some of the elements that you show there, such as
Buttons, Indicators, Buttons, Tables, etc

But I cannot find an example page showing these. Can you please share the markdown pages behind all these elements?

Thanks a lot!

YouTube : Without channel logo and video title.

Is your feature request related to a problem? Please describe.

I just want a clean YouTube Video embedded with lazy YouTube video loading.

---

Describe the solution you'd like

I found a repo that applies that feature and it looks neat too.

---

Describe alternatives you've considered

Applying the code used in there

---

Additional context

The repo link :
https://github.com/alfurka/jekyll-embed-youtube-lazy-load

Collection Cards should follow the applied theme.

Is your feature request related to a problem?

The collection cards should follow the applied theme.

---

Describe the solution you'd like

The card layout of a collection should follow the applied theme, instead it is still displayed in white background and the title and date doesn't really stand out from the white background so it's not quite visible.

---

Additional context

Collection Cards background screenshot: