Rusty Typewriter
  1. Home
    2. »
  2. Posts
    3. »

Getting Started

#starter
#guide

This post will guide you in setting up your very own Hugo site with this theme. It covers the essential parts: installation, basic usage and recommended next steps. After setting up the basics, feel free to also take a look at other posts!

Installation

This guide is a shorter version of Hugo’s quick start (you may even say it’s a quicker start). If you face any problems or want more comprehensive content, make sure to check it out!

Requirements

Setup Locally

  1. Create a new Hugo site
hugo new site my-blog
  1. Change the working dir to the newly created one
cd my-blog
  1. Install the theme from by cloning the GIT repository
git clone https://github.com/math-queiroz/rusty-typewriter themes/rusty-typewriter
  1. Create some pages with the desired content
hugo new content content/posts/first-post.md
  1. Test your site locally
hugo server -D
  1. Congrats! You just got your site up and running locally. Now get to configure and customize it!

Going Public

Since after build you get just plain static site files (HTML, CSS and JS), there are plenty of pipelines to deploy, places to host and ways to publish your site. If you’re interested in the most common ones for Hugo, you can find them listed and documented in here.

Basic Usage

Now that you have a site, the standard workflow for managing content is simply given by:

  1. Create the content page with hugo new content content/posts/post-name.md
  2. Edit the created file with the intended content
  3. Update the repository and publish the alterations

Also, make sure to give the content management docs a read.

Next Steps

At last, if you need directions as to where to go next:

  • Tweak the hugo.toml config file based on the boilerplate one;
  • Get ricing styling your themed site from the customization reference;
  • Make sure to leave a star at the theme repo and support my work if you enjoy it!