/hugo-artists-theme

Port of Travis Neilson's (DevTips) awesome Artists Theme to Hugo

Primary LanguageCSSThe UnlicenseUnlicense

Artists Theme

The Artists Theme is a one page portfolio for freelancers based on the original Jekyll theme by Travis Neilson aka DevTips and his many contributors. It's the result of a longer video series made by him that is showing the whole developement process from the first designs to the final Jekyll theme. Consider to subscribe to his YouTube channel.

This Hugo theme features several content sections, like an about section showing the level of your skills, a responsive portfolio with hover effects, a gallery to present your client's opinions and a contact form.

Hugo Artists Theme screenshot

Contents

Installation

Inside the folder of your Hugo site run:

$ mkdir themes
$ cd themes
$ git clone https://github.com/digitalcraftsman/hugo-artists-theme

For more information read the official setup guide of Hugo.

Getting started

After installing the Artists Theme successfully it requires a just a few more steps to get your site finally running.

The config file

Take a look inside the exampleSite folder of this theme. You'll find a file called config.toml. To use it, copy the config.toml in the root folder of your Hugo site. Feel free to customize this theme as you like.

Change the hero background

The hero acts as an eye-catcher for your site. So consider to give him a nice background. You just need to replace the hero-bg.jpg at static/img with your own background image. But it's important that you keep the original filename.

Add your own logo

Go to static/img and replace the logo.svg with your own file. If you don't want to use an svg you also need to change the source name inside the all.css stylesheet here and here.

Introduce yourself

In the next step, replace the image of Travis in the about section with one of yours. Therefore search the avatar.jpg under static/img. But keep the original filename here too.

Furthermore, you can show your visitors your skills and capabilities. Add as many skills as you like by copying the snippet below:

[[params.about.skills]]
   name = "Communication"
   value = 9

To rate your skill level, use a value between 0 and 10.

Create your portfolio

Adding a new project is very simple. Firstly, you need to define a new project in your data/work.toml with the following code snippet:

# Section title
title = "Work"

[[projects]]
    name = "TYPO International Design Talks"
    folder = "proj-1"

The folder attribute defines a project-specific subfolder for your images. You will use it at the end of this section.

Beside the data/work.toml, there is under content another subfolder called work which hosts the files that will appear as your projects in the work section. Copy the whole folder into the content directory at the root of your Hugo site.

Such a project file might look like this one written in Markdown:

![Typo International](img/work/proj-1/img1.jpg)

TYPO: International Design Talks is an annual event held in Berlin, London, and San Francisco. This promotional project is developed to market the event for the designindustry. The use of patterns, sophisticated color scheme and typography are applied for the print and mobile application.

![Typo International](img/work/proj-1/img2.jpg)
![Typo International](img/work/proj-1/img3.jpg)
![Typo International](img/work/proj-1/img4.jpg)
![Typo International](img/work/proj-1/img5.jpg)

The paths to your images are relative to the base url. Store those under static/img/work/<folder>/. <folder> is a the attribute from the data/work.toml that you defined for the images above. Create at least a thumb.jpg for the preview in the portfolio grid.

What your clients think

For a new quote, copy the code below into your data/clients.toml:

# Section title
title = "Clients"

[[list]]
    avatar = "face-aaroni.jpg"
    name   = "Scott Summers"
    title  = "Director of Design, OnToText Ind."
    quote  = "**While we all felt that Travis was a great** asset to our team — and really worked hard to understand our products from the point of view of the customer — we also all agree he should shower more often."
    logo   = "logo1.png"

Store both the client's avatar and logo at static/img/clients

Add social networks

You can link some of your social networks in this theme too. Therefore copy the this snippet:

[[params.contact.social]]
      icon = "twitter"
      link = "//twitter.com/devtipsshow"

The following social network icons are available:

twitter, facebook, github, pinterest google-plus, linkedin youtube, instagram, dribbble, behance, soundcloud and vine.

Make the contact form working

Since this page will be static, you can use formspree.io as proxy to send the actual email. Each month, visitors can send you up to one thousand emails without incurring extra charges. Begin the setup by following the steps below:

  1. Enter your email address under 'email' in the config.toml
  2. Upload the generated site to your server
  3. Send a dummy email yourself to confirm your account
  4. Click the confirm link in the email from formspree.io
  5. You're done. Happy mailing!

Nearly finished

In order to see your site in action, run Hugo's built-in local server.

$ hugo server -w

Now enter localhost:1313 in the address bar of your browser.

Contributing

Did you found a bug or got an idea for a new feature? Feel free to use the issue tracker to let me know. Or make directly a pull request.

License

This theme is released under the Unlincense License. For more information read the License.

Annotations

A big thank you to these creators for contributing sample projects for the "work" section:

Also thanks to Steve Francia for creating Hugo and the awesome community around the project.