CV-olio

CV-olio is a Jekyll template for a two-page CV and portfolio website that runs completely without JavaScript or external dependencies. It takes YAML configuration and Markdown portfolio entries and generates a static, responsive site that can even be distributed on a USB stick.

What is CV-olio?

CV-olio is a Jekyll-based template that produces a simple two-page CV and portfolio website. The site is built from a _config.yml file for global settings and individual Markdown files for portfolio items, each with YAML front matter. The output is static HTML and CSS with no JavaScript, no CSS frameworks, and no external dependencies, so it works in all modern browsers and even offline. The project is maintained on GitHub by the user gisforgabriel and includes a live demo hosted on Netlify.

Key Features

• No JavaScript or dependencies — The site uses only HTML and CSS, so it runs anywhere without a build step or internet connection.
• Embedded fonts and favicon — The Lora and Muli fonts are encoded directly in the CSS, and the favicon can be base64-embedded via /_includes/favicon.html.
• Inline SVG icons — Icons come from the Entypo set as inline SVG instead of icon fonts, so they scale cleanly.
• Golden ratio proportions — The layout applies the golden ratio to spacing and dimensions where appropriate for visual balance.
• Responsive design — The layout adapts to different viewport sizes without any CSS framework.
• Print-optimised CV — A custom print stylesheet formats the CV page for clean paper output.
• Optional schema.org and SEO — You can add structured data and search-engine optimised meta tags through configuration.
• Customisable background pattern — The pattern-style, pattern-foreground, pattern-background, and pattern-size options in _config.yml control an optional tiled background.

Who is it for?

CV-olio suits developers and technical professionals who want a static, self-contained CV site they can host on GitHub Pages or any static host. It is also ideal for designers who want a minimal portfolio without JavaScript overhead, and for anyone who prefers a print-friendly resume that matches their online presence. Because it has no dependencies, it is a practical choice for distributing a résumé on a USB stick or in an offline environment.

What can you do with CV-olio?

• Job seekers: publish a clean, print-ready CV alongside a portfolio of work samples.
• Freelancers: create a lightweight personal brand page that loads fast and needs no maintenance beyond editing Markdown files.
• Offline use: build the site and carry it on a USB stick to demonstrate work without an internet connection.

How does CV-olio work?

You customise the template by editing _config.yml — setting your name in owner, your GitHub username in github, the site url, and visual options like the background pattern. Portfolio items are Markdown files with YAML front matter that define the title, employer, image, link, and display order; the text under the YAML becomes the project description. The skill option exists but is not yet functional. After editing, run jekyll build (or rely on GitHub Pages) to produce the static site.

FAQ

Does CV-olio require JavaScript?

No. The template is intentionally free of JavaScript, so the generated site works with scripting disabled and is more secure and faster to load.

How do I add a portfolio item?

Create a new Markdown file with YAML front matter containing fields like title, employer, image, link, and display-order. The file's Markdown body becomes the item's description. Images go in the /_images directory.

Can I use a different favicon?

Yes. Edit /_includes/favicon.html to either use a base64-encoded favicon embedded in the CSS or link to an external favicon file.

Is CV-olio responsive?

Yes, the layout is responsive and adapts to different screen sizes without using any CSS framework.

What does the skill option do?

The skill option in portfolio YAML is intended to list skills associated with a project, but according to the README it is not yet working.