github/hugo
1
0
Fork 0
mirror of https://github.com/gohugoio/hugo.git synced 2024-12-29 01:34:12 +00:00
Code Issues Projects Releases Packages Wiki Activity
hugo/examples/blog
History
Albert Nigmatzianov f21e2f25c9 all: Unify case of config variable names 
All config variables starts with low-case and uses camelCase.

If there is abbreviation at the beginning of the name, the whole
abbreviation will be written in low-case.
If there is abbreviation at the end of the name, the
whole abbreviation will be written in upper-case.
For example, rssURI.
2016-10-24 20:56:00 +02:00
..
content/post
layouts
static
.gitignore
config.toml
README.md

README.md

Hugo Example Blog

This repository provides a fully-working example of a Hugo-powered blog. Many 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
  • Bootstrap 3 ready

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.

Install Hugo in a way that best suits your environment and comfort level.

Edit config.toml and change the default properties to suit your own information. This is not required to run the 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! You should now have a public directory with a complete blog! Open public/index.html in your browser and bask.

If that wasn't amazing enough, from the same terminal, run hugo server. This will watch your directories for changes 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.

To further learn Hugo and learn more, read through the Hugo documentation or browse around the files in this repository. Have fun!