summaryrefslogtreecommitdiffstats
path: root/examples/blog/README.md
diff options
context:
space:
mode:
authorWilliam McGann <contact@WilliamMcGann.com>2014-04-12 16:04:17 -0400
committerspf13 <steve.francia@gmail.com>2014-04-26 23:05:41 -0600
commit96b6ae81eb48cd250c507e6c200a16b91a054eb7 (patch)
treef749ebd5963991144e9a8890b2f640e5c35f5fa6 /examples/blog/README.md
parentb52e94638122061d3045605d9bf81f8c15e02752 (diff)
Adding example blog
Diffstat (limited to 'examples/blog/README.md')
-rw-r--r--examples/blog/README.md42
1 files changed, 42 insertions, 0 deletions
diff --git a/examples/blog/README.md b/examples/blog/README.md
new file mode 100644
index 000000000..731839781
--- /dev/null
+++ b/examples/blog/README.md
@@ -0,0 +1,42 @@
+Hugo Example Blog
+=================
+
+This repository provides a fully-working example of a [Hugo](https://github.com/spf13/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](http://getbootstrap.com/) ready
+ - Currently using the Yeti theme from http://bootswatch.com/
+
+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](http://hugo.spf13.com/overview/installing) in a way that best suits your environment and comfort level.
+
+Edit `config.yaml` 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.yaml` 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 -w`. 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](http://hugo.spf13.com/overview/introduction)
+or browse around the files in this repository. Have fun! \ No newline at end of file