hugo/examples/blog/README.md

43 lines
2 KiB
Markdown
Raw Normal View History

2014-04-12 20:04:17 +00:00
Hugo Example Blog
=================
This repository provides a fully-working example of a [Hugo](https://github.com/gohugoio/hugo)-powered blog. Many
2014-04-12 20:04:17 +00:00
Hugo-specific features are used as a way to see them in action, and hopefully ease the learning curve for creating your
very own site with Hugo.
Features
--------
- Recent Posts at main index
- Indexes for `tags` and `categories`
- Post information block, with links for all `tags` and `categories` post belongs to
2019-06-12 10:29:19 +00:00
- [Bootstrap 3](https://getbootstrap.com/) ready
- Currently using the [Yeti](https://bootswatch.com/yeti/) theme from https://bootswatch.com/
2014-04-12 20:04:17 +00:00
Common things that should be added in the near future *(pull requests are welcome!)*:
- Disqus integration
- More content types to demonstrate different layout methods
- About Me
- Contact
Getting Started
---------------
To get started, you should simply fork or clone this repository! That's definitely an important first step.
2014-04-12 20:04:17 +00:00
2019-06-12 10:29:19 +00:00
[Install Hugo](https://gohugo.io/getting-started/installing) in a way that best suits your environment and comfort level.
2014-04-12 20:04:17 +00:00
Edit `config.toml` and change the default properties to suit your own information. This is not required to run the
2014-04-12 20:04:17 +00:00
example, but this is the global configuration file and you're going to need to use it eventually. Start here!
In a command prompt or terminal, navigate to the path that contains your `config.toml` file and run `hugo`. That's it!
2014-04-12 20:04:17 +00:00
You should now have a `public` directory with a complete blog! Open `public/index.html` in your browser and bask.
2015-12-24 22:04:58 +00:00
If that wasn't amazing enough, from the same terminal, run `hugo server`. This will watch your directories for changes
2014-04-12 20:04:17 +00:00
and rebuild the site immediately, *and* it will make these changes available at http://localhost:1313/ so you can view
your finished site in your browser. Go on, try it. This is one of the best ways to preview your site while working on it.
2019-06-12 10:29:19 +00:00
To further learn Hugo and learn more, read through the Hugo [documentation](https://gohugo.io/getting-started/)
or browse around the files in this repository. Have fun!