Hephaestus is a portfolio theme for zola. It uses bulma css and supports using icons from ion-icon.

• Installation
• Options
  • Navigation Bar
  • Education
  • Projects
  • Skills
  • Social Links

First, you will download the theme into your themes directory:

$ cd themes
$ git clone https://github.com/BConquest/hephaestus

Second, you will enable the theme in your config.toml directory:

theme = "hephaestus"

To edit the navigation bar you will need to edit your config.toml to include:

menu = [
{ text = "foo", link = "/foo"},
{ text = "bar", link = "/bar"},
]

You can have as many items as you want to have and the links can be to anything.

To edit the education that is displayed you will need to create a directory in content. In the _index.md the frontmatter needs to include:

title = "foo"
template = "education.html"

[extra]
author = "Name"

For every educational level you want to add you will need to create a new markdown file that includes the frontmatter:

title = "place of education"

[extra]
image = "image-location"
link = "link to school"
+++

Any content that is typed will be rendered underneath these two items.

To edit the projects that are displayed you will need to create a directory in content. In the _index.md the frontmatter needs to include:

title = "foo"
template = "projects.html"

[extra]
author = "bar"

Then for every project you want to add you will need to format the *.md as:

+++
title = "foo"

[extra]
image = "/image_location"
link = "link to project"
technologies = ["bar", "baz"]
+++

Description of project named foo.

To edit the skills that you want to display it is important to note that there are two types of skills that can be displayed (lan, and tools). To format the look you will need to create a directory in content that includes the frontmatter of:

title = "foo"
template = "skills.html"
page_template = "skills.html"

[extra]
author = "author-name"
image = "image-location"

lan = [
{ lang = "language", expr = "num between 1-5", image = "image-location", comfort = "word to describe comfort"},
]

tools = [
{ tool = "tool-name", expr = "num between 1-5", image = "tool-image"},
]

To edit the social links that appear in the footer of the page, you need to edit your config.toml to include:

social = [
{ user = "username", link = "link", icon = "icon-name from ion-icon"},
]