Sources of the GitOps project's website (https://josecastillolema.github.io/). Built with Jekyll and Chirpy theme as a static site.

The site is generated locally and then the site static files are pushed to GitHub because the site depends on a custom remote_include plugin (see below) which is not supported by GitHub Pages.

Chirpy theme

Click Use this template button for the quickest method of getting started with the Chirpy Jekyll theme. See the Chirpy documentation for configuration details.

Customizations

It is possible to override the theme defaults with your own customizations:

• Custom home page with year summary table and year headers
  • _layouts/home.html
• Custom remote_include plugin that replaces the archived jekyll-remote-include gem. Fetches raw markdown from GitHub and rewrites relative links to point to the GitHub repository (blob URLs for links, raw URLs for images). Also strips the first # Title heading from the fetched content to avoid duplication with the post's own title.
  • _plugins/remote_include_rewrite.rb
• Frontmatter image_link support (replaces preview image lightbox with custom URL) and :octocat: emoji
  • _plugins/octocat_emoji.rb
• Prevent preview image stretching, disable avatar zoom on hover, expand TOC by default, extend TOC to support h5/h6 headings, and bold h5/h6 in post content
  • _includes/metadata-hook.html
• TOC support for page layouts (Chirpy only supports TOC on posts by default). Adds TOC panel and mobile popup to pages with toc: true.
  • _layouts/page.html
  • _includes/js-selector.html
• Fix Atom feed icon/logo using absolute URLs so RSS readers (e.g., Feedly) can resolve the favicon. Chirpy's default template uses site.baseurl which produces relative paths.
  • assets/feed.xml

Troubleshooting

If you have a question about using Jekyll, start a discussion on the Jekyll Forum or StackOverflow. Other resources:

• Ruby 101
• Setting up a Jekyll site with GitHub Pages
• Configuring GitHub Metadata to work properly when developing locally and avoid No GitHub API authentication could be found. Some fields may be missing or have incorrect data. warnings.