github/hugo
1
0
Fork 0
mirror of https://github.com/gohugoio/hugo.git synced 2025-03-20 10:53:48 +00:00
Code Issues Projects Releases Packages Wiki Activity

Tighten README for the sloppy reader

Browse source 
Tighten README for the sloppy reader

Tighten README for the sloppy reader

Fixing heads

tigheten markdown

tighten markdown

tighten markdown

tinker with headings

tinker with wording

fixing period spacing

moving the any dir stuff into the feature section

tweak overview

tweak overview

fixed option too

fix break:
This commit is contained in:
Mary Anthony 2015-01-31 21:00:18 -08:00 committed by Anthony Fok
parent 8b95cab94c
commit df734bc18a
1 changed files with 48 additions and 62 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

102
README.md
View file

@ -1,92 +1,79 @@
# Hugo # Hugo
A Fast and Flexible Static Site Generator built with love by [spf13](http://spf13.com/) A Fast and Flexible Static Site Generator built with love by [spf13](http://spf13.com/) and [friends](https://github.com/spf13/hugo/graphs/contributors) in Go.
and [friends](https://github.com/spf13/hugo/graphs/contributors) in Go.
[![Build Status](https://travis-ci.org/spf13/hugo.png)](https://travis-ci.org/spf13/hugo) [![Build Status](https://travis-ci.org/spf13/hugo.png)](https://travis-ci.org/spf13/hugo) [![wercker status](https://app.wercker.com/status/1a0de7d703ce3b80527f00f675e1eb32 "wercker status")](https://app.wercker.com/project/bykey/1a0de7d703ce3b80527f00f675e1eb32) [![Build status](https://ci.appveyor.com/api/projects/status/n2mo912b8s2505e8/branch/master?svg=true)](https://ci.appveyor.com/project/spf13/hugo/branch/master)
[![wercker status](https://app.wercker.com/status/1a0de7d703ce3b80527f00f675e1eb32 "wercker status")](https://app.wercker.com/project/bykey/1a0de7d703ce3b80527f00f675e1eb32)
[![Build status](https://ci.appveyor.com/api/projects/status/n2mo912b8s2505e8/branch/master?svg=true)](https://ci.appveyor.com/project/spf13/hugo/branch/master)
## Overview ## Overview
Hugo is a static site generator written in Go. It is optimized for Hugo is a static site generator written in Go. It is optimized for speed, easy use and configurability. Hugo takes a directory with content and templates and renders them into a full HTML website.
speed, easy use and configurability. Hugo takes a directory with content and
templates and renders them into a full HTML website.
Hugo makes use of Markdown files with front matter for meta data. Hugo relies on Markdown files with front matter for meta data. And you can run Hugo from any directory. This works well for shared hosts and other systems where you don't have a privileged account.
A typical website of moderate size can be Hugo renders a typical website of moderate size in a fraction of a second. A good rule of thumb is that each piece of content renders in around 1 millisecond.
rendered in a fraction of a second. A good rule of thumb is that Hugo
takes around 1 millisecond for each piece of content.
It is written to work well with any Hugo is meant to work well for any kind of website including blogs, tumbles and docs.
kind of website including blogs, tumbles and docs.
#### Supported Architectures
Currently Hugo exists for Windows, Linux, FreeBSD and OS X for x64 and i386 architectures.
**Complete documentation is available at [Hugo Documentation](http://gohugo.io/).** **Complete documentation is available at [Hugo Documentation](http://gohugo.io/).**
# Getting Started ## Choose How to Install
## Installing Hugo If you want to use Hugo as your site generator, simply install the Hugo binaries. The Hugo binaries have no external dependencies.
Hugo is written in Go with support for Windows, Linux, FreeBSD and OS X. To contribute to the Hugo source code or documentation, you should fork the Hugo GitHub project and clone it to your local machine.
The latest release can be found at [Hugo Releases](https://github.com/spf13/hugo/releases). Finally, you can install the Hugo source code with `go`, build the binaries yourself, and run Hugo that way. Building the binaries is an easy task for an experienced `go` getter.
We currently build for Windows, Linux, FreeBSD and OS X for x64
and i386 architectures.
### Installing Hugo (binary) ### Install Hugo as Your Site Generator (Binary Install)
Use the [installation instructions in the Hugo documentation](http://gohugo.io/overview/installing/).
Installation is very easy. Simply download the appropriate version for your ### Clone the Hugo Project (Contributor)
platform from [Hugo Releases](https://github.com/spf13/hugo/releases). 1. Make sure your local environment has the following software installed:
Once downloaded, it can be run from anywhere. You don't need to install * Git
it into a global location. This works well for shared hosts and other systems * Go 1.3+ (Go 1.4+ on Windows, see Go [Issue #8090](https://code.google.com/p/go/issues/detail?id=8090))
where you don't have a privileged account. * Mercurial
* Bazaar
2. Fork the Hugo project on Github.
3. Clone your fork.
Ideally, you should install it somewhere in your path for easy use. `/usr/local/bin` `git clone https://github.com/YOURNAME/hugo`
is the most probable location. 4. Change into the `hugo` directory.
*The Hugo executable has no external dependencies.* `cd hugo`
5. Install the Hugo project’s package dependencies.
### Installing from source `go get`
6. Use a symbolic link to add Hugo to your `$GOPATH`.
#### Dependencies `ln -s /path/to/your/hugo $GOPATH/src/github.com/spf13/hugo`
* Git Go expects all of your libraries to be found in`$GOPATH`.
* Go 1.3+ (Go 1.4+ on Windows, see Go [Issue #8090](https://code.google.com/p/go/issues/detail?id=8090))
* Mercurial
* Bazaar
#### Clone locally (for contributors): ### Build and Install the Binaries from Source (Advanced Install)
git clone https://github.com/spf13/hugo Add Hugo and its package dependencies to your go `src` directory.
cd hugo
go get
Because Go expects all of your libraries to be found in either `$GOROOT` or `$GOPATH`,
it's helpful to symlink the project to one of the following paths:
* `ln -s /path/to/your/hugo $GOPATH/src/github.com/spf13/hugo`
* `ln -s /path/to/your/hugo $GOROOT/src/pkg/github.com/spf13/hugo`
#### Get directly from GitHub:
If you only want to build from source, it's even easier:
go get -v github.com/spf13/hugo go get -v github.com/spf13/hugo
Once completed, your may find your new `hugo` (or `hugo.exe`) executable Once the `get` completes, you should find your new `hugo` (or `hugo.exe`) executable sitting inside `$GOPATH/bin/`.
sitting inside `$GOPATH/bin/`.
You may also run `go get` with the `-u` option to update Hugo’s dependencies: To update Hugo’s dependencies, use `go get` with the `-u` option.
go get -u -v github.com/spf13/hugo go get -u -v github.com/spf13/hugo
#### Building Hugo ## Contributing Code
Contributors should build Hugo and test their changes before submitting a code change.
### Building Hugo with Your Changes
cd /path/to/hugo cd /path/to/hugo
go build -o hugo main.go go build -o hugo main.go
mv hugo /usr/local/bin/ mv hugo /usr/local/bin/
##### Adding compile information to Hugo ### Adding compile information to Hugo
When Hugo is built using the above steps, the `version` sub-command will include the `mdate` of the Hugo executable, similar to the following: When Hugo is built using the above steps, the `version` sub-command will include the `mdate` of the Hugo executable, similar to the following:
@ -114,13 +101,13 @@ Will result in:
Hugo Static Site Generator v0.13-DEV buildDate: 2014-10-16 Hugo Static Site Generator v0.13-DEV buildDate: 2014-10-16
Hugo Static Site Generator v0.13-DEV-24BBFE7 buildDate: 2014-10-16 Hugo Static Site Generator v0.13-DEV-24BBFE7 buildDate: 2014-10-16
#### Running Hugo ### Running Hugo
cd /path/to/hugo cd /path/to/hugo
go install github.com/spf13/hugo/hugolib go install github.com/spf13/hugo/hugolib
go run main.go go run main.go
#### Contribution Guidelines ## Contribution Guidelines
We welcome your contributions. To make the process as seamless as possible, we ask for the following: We welcome your contributions. To make the process as seamless as possible, we ask for the following:
@ -128,8 +115,7 @@ We welcome your contributions. To make the process as seamless as possible, we
* When you're ready to create a pull request, be sure to: * When you're ready to create a pull request, be sure to:
* Have test cases for the new code. If you have questions about how to do it, please ask in your pull request. * Have test cases for the new code. If you have questions about how to do it, please ask in your pull request.
* Run `go fmt` * Run `go fmt`
* Squash your commits into a single commit. `git rebase -i`. It's okay to force update your pull request. * Squash your commits into a single commit. `git rebase -i`. It's okay to force update your pull request. * Make sure `go test ./...` passes, and `go build` completes. Our Travis CI loop will catch most things that are missing. The exception: Windows. We run on Windows from time to time, but if you have access, please check on a Windows machine too.
* Make sure `go test ./...` passes, and `go build` completes. Our Travis CI loop will catch most things that are missing. The exception: Windows. We run on Windows from time to time, but if you have access, please check on a Windows machine too.
**Complete documentation is available at [Hugo Documentation](http://gohugo.io/).** **Complete documentation is available at [Hugo Documentation](http://gohugo.io/).**