Helvetic Resume

Helvetic Resume is a bold Jekyll theme inspired by Swiss design and the works of Massimo Vignelli. This theme lends itself well to sites heavy on written content.

• Mobile-first design ensures this theme performs fastest on mobile while scaling elegantly to desktop-size screens.
• Designed for blogs and sites heavy on written content, with bold typography styles, homepage summaries, and previous/next snippets.
• Multi-language support, comes preset in 4 languages.
• Supports a wide range of HTML elements and markdown.
• Flexible styles that can be reused for customization without adding additional CSS.
• Dynamically generated navigation links. See docs for adding pages with specific post category for-loops.

There are only three basic requirements to use this theme right away:

• Docker
• VS Code
• Devcontainers extension

If you have these three things, this project is like a yoghourt, just open the lid and it's ready to eat ;).

If you open the project and it doesn't ask you to open it in a container, look for the blue button in the lower left edge of the screen and select Reopen folder in container.

If you ever need to rebuild your container from scratch, just select Rebuild container without cache from Ctrl + Shift + P menu.

Assuming you've got Ruby and Bundler installed:

cd src
bundle install

Let the process finish and then run:

bundle exec jekyll serve

You can dockerise the app yourself by creating your own Dockerfile and or adapt and use the one in .devcontainer folder, then run it with your own compose.yaml or however you like best.

We've not provided any of them to avoid repetition and because this is an opinionated repo, but it should be very easy to make and it's your best option if you are not using VS Code.

Helvetic Resume comes preconfigured with jekyll-polyglot and jekyll-redirect-from plugins that render its multi-language capabilities.

To demonstrate them, this theme comes preset in four languages: English, Catalan, Spanish and Italian, but you can add or remove as many as you wish from _config.yml file.

You'll find the translations currently in use in _data folder. Lastly, we're using plugin jekyll-date-localization to localise dates. The plugin already has some languages, but if your language is not there, you can always add it to the _locales folder, the same way we've done with Catalan.

This theme has been designed with the utmost desire of being faithful to it's original counterpart, albeit upgraded to modern standards not only in terms of dependencies but also tastes. That's why we've put an amazing animation button to toggle between Dark and Light modes (thank you web.dev for it!).

Each time you press it, you'll not only be toggling from light to dark or vice versa, but also randomly changing between most of broccolini's designs for the Swiss theme. We've only discarded gray for a fresh alternative (we didn't like it ;P) and severely tweaked blue. The rest is kept as is, only adapting to the light/dark schemes.

theme_color: black	theme_color: red
theme_color: mint	theme_color: white
theme_color: blue	theme_color: magenta
theme_color: orange	theme_color: yellow

Your theme is setup just like a normal Jekyll site! To test your theme, just open it in a devcontainer or run bundle exec jekyll serve and open your browser at http://localhost:4000. This starts a Jekyll server using your theme. Add pages, documents, data, etc. like normal to test your theme's contents. As you make modifications to your theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal.

When your theme is released, only the files in src, tracked with Git will be released.

Bug reports and pull requests are welcome on GitHub at https://github.com/hipervincle/helvetic-resume. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

Theme switch: web.dev

Favicon: narak0rn

The theme is available as open source under the terms of the MIT License.