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.

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

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. Includes a post-render hook that strips raw {% remote_include %} tags from post content so the search index shows clean text.
  • _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, bold h5/h6 in post content, keyboard shortcut / to open the search box (Escape to close it), hide line numbers on shell code blocks and align with plaintext output blocks, merge consecutive output blocks into preceding code blocks (hide header and gap), hide "Plaintext" label on untagged code blocks, and hide literal {content} placeholder in search results for image-only posts
  • _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
• Custom locale override adding "Series" and "Talks" sidebar tab labels (Chirpy only ships with Home, Categories, Tags, Archives, About)
  • _data/locales/en.yml
• 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

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.