Cvless is a theme for static websites built with Jekyll. It aims for simplicity and readability by following best practices of graphic design, such as the use of high contrast, law of proximity, and of course, responsive layout. Its typography is based on the Piazzolla type system, which performs extremely well over a wide range of font sizes.
The main aesthetic feature of the theme is the use of particles.js to decorate the home page and the 404 page. In addition to these pages, the theme includes a well-designed CV page. Printing the CV page from browser automatically adapts the layout for a more traditional appearance. This means you no longer have to maintain a separate CV for offline distribution. Finally, the theme offers a simple and easily extensible blog.
Light and dark modes are available. The theme initializes based on system preferences and stores the user's preference for the duration of the session.
See the demo to get a better sense of what the theme looks like.
- Clone this repository.
- Rename it to
[username].github.io
. - Start editing!
Configuration primarily occurs in four files. First, _config.yml
, which contains site variables such as title, tagline, url, and repository address, as well as the author's name and email address for inclusion in blog posts. There is also a variable that specifies a photo for inclusion in the homepage. This is optional and can be removed.
Second, you should update icon links in _includes/particles-home.html
and add/remove icons as needed. You might want to add icons that are not included by default. For more information on how to do this, see this blog post.
Third, you should customize the file _includes/contact.html
by inputting your contact details and adding/removing lines as needed. This information is prepended to your CV. It is possible to customize the icons that appear in this file: for more information, see the blog post above.
Fourth, you might want to edit the style variables specified in _sass/_variables.scss
. These allow you to customize the theme's color scheme and typefaces. There are many resources on the web to learn the principles of good web design. I personally recommend Matthew Butterick's Practical Typography, which also covers websites.
In addition to these files, you can customize favicons in the assets
folder. For that, favicon.io is an excellent tool. You can also change the particles.js configurations in assets/json
. The particles.js homepage features an interactive tool from which you can export a new configuration.
The theme draws in one way or another from the following projects:
If you find any problem using this theme, please open an issue.