github/hugo
1
0
Fork 0
mirror of https://github.com/gohugoio/hugo.git synced 2024-11-21 20:46:30 -05:00
Code Issues Projects Releases Packages Wiki Activity

Merge commit '807c551922707fc5ae0eb26e8f01638c0c63fdb3'

Browse source
This commit is contained in:
Bjørn Erik Pedersen 2018-09-23 23:48:53 +02:00
commit bc57f5c36e
No known key found for this signature in database
GPG key ID: 330E6E2BD4859D8F
9 changed files with 24 additions and 233 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
docs/content/en/content-management/comments.md
View file

@ -60,6 +60,7 @@ There are a few alternatives to commenting on static sites for those who do not
* [isso](http://posativ.org/isso/) (Self-hosted, Python) * [isso](http://posativ.org/isso/) (Self-hosted, Python)
* [Tutorial on Implementing Isso with Hugo][issotutorial] * [Tutorial on Implementing Isso with Hugo][issotutorial]
* [Utterances](https://utteranc.es/) (Open source, Github comments widget built on Github issues) * [Utterances](https://utteranc.es/) (Open source, Github comments widget built on Github issues)
* [Remark](https://github.com/umputun/remark) (Open source, Golang, Easy to run docker)
<!-- I don't think this is worth including in the documentation since it seems that Steve is no longer supporting or developing this project. rdwatters - 2017-02-29.--> <!-- I don't think this is worth including in the documentation since it seems that Steve is no longer supporting or developing this project. rdwatters - 2017-02-29.-->
<!-- * [Kaiju](https://github.com/spf13/kaiju) --> <!-- * [Kaiju](https://github.com/spf13/kaiju) -->

4
docs/content/en/getting-started/code-toggle.md
View file

@ -15,6 +15,10 @@ toc: true
This is an example for the Config Toggle shortcode. This is an example for the Config Toggle shortcode.
Its purpose is to let users choose a Config language by clicking on its corresponding tab. Upon doing so, every Code toggler on the page will be switched to the target language. Also, target language will be saved in user's `localStorage` so when they go to a different pages, Code Toggler display their last "toggled" config language. Its purpose is to let users choose a Config language by clicking on its corresponding tab. Upon doing so, every Code toggler on the page will be switched to the target language. Also, target language will be saved in user's `localStorage` so when they go to a different pages, Code Toggler display their last "toggled" config language.
{{% note %}}
The `code-toggler` shortcode is not an internal Hugo shortcode. This page's purpose is to test out a custom feature that we use throughout this site. See: https://github.com/gohugoio/gohugoioTheme/blob/master/layouts/shortcodes/code-toggle.html
{{% /note %}}
## That Config Toggler ## That Config Toggler
{{< code-toggle file="config">}} {{< code-toggle file="config">}}

2
docs/content/en/getting-started/configuration.md
View file

@ -358,7 +358,7 @@ The above will try first to extract the value for `.Lastmod` starting with the `
`:filename` `:filename`
: Fetches the date from the content file's filename. For example, `218-02-22-mypage.md` will extract the date `218-02-22`. Also, if `slug` is not set, `mypage` will be used as the value for `.Slug`. : Fetches the date from the content file's filename. For example, `2018-02-22-mypage.md` will extract the date `2018-02-22`. Also, if `slug` is not set, `mypage` will be used as the value for `.Slug`.
An example: An example:

20
docs/content/en/getting-started/installing.md
View file

@ -75,22 +75,18 @@ scoop install hugo
#### Prerequisite Tools #### Prerequisite Tools
* [Git][installgit] * [Git][installgit]
* [Go (latest or previous version)][installgo] * [Go (at least Go 1.11)](https://golang.org/dl/)
#### Vendored Dependencies
Hugo uses [dep][] to vendor dependencies, but we don't commit the vendored packages themselves to the Hugo git repository. Therefore, a simple `go get` is *not* supported because the command is not vendor aware.
The simplest way is to use [mage][] (a Make alternative for Go projects.)
#### Fetch from GitHub #### Fetch from GitHub
Since Hugo 0.48, Hugo uses the Go Modules support built into Go 1.11 to build. The easiest way to get started is to clone Hugo in a directory outside of the GOPATH, as in the following example:
{{< code file="from-gh.sh" >}} {{< code file="from-gh.sh" >}}
go get github.com/magefile/mage mkdir $HOME/src
go get -d github.com/gohugoio/hugo cd $HOME/src
cd ${GOPATH:-$HOME/go}/src/github.com/gohugoio/hugo git clone https://github.com/gohugoio/hugo.git
mage vendor cd hugo
HUGO_BUILD_TAGS=extended mage install go install
{{< /code >}} {{< /code >}}
Remove `HUGO_BUILD_TAGS=extended` if you do not want Sass/SCSS support. Remove `HUGO_BUILD_TAGS=extended` if you do not want Sass/SCSS support.

2
docs/content/en/getting-started/quick-start.md
View file

@ -127,7 +127,7 @@ theme = "ananke"
Replace the `title` above with something more personal. Also, if you already have a domain ready, set the `baseURL`. Note that this value is not needed when running the local development server. Replace the `title` above with something more personal. Also, if you already have a domain ready, set the `baseURL`. Note that this value is not needed when running the local development server.
{{% note %}} {{% note %}}
**Tip:** Make the changes to the site configuration or any other file in your site while the Hugo server is running, and you will see the changes in the browser right away. **Tip:** Make the changes to the site configuration or any other file in your site while the Hugo server is running, and you will see the changes in the browser right away, though you may need to [clear your cache](https://kb.iu.edu/d/ahic).
{{% /note %}} {{% /note %}}

2
docs/content/en/hosting-and-deployment/deployment-with-wercker.md
View file

@ -128,7 +128,7 @@ git push -u origin master
## Set Up Wercker ## Set Up Wercker
To sign up for a free Wercker account, go to <https://wercker.com> and click the **Sign Up** button on the top right of the home screen. To sign up for a free Wercker account, go to <https://www.wercker.com> and click the **Sign Up** button on the top right of the home screen.
![][3] ![][3]

7
docs/data/homepagetweets.toml
View file

@ -1,3 +1,10 @@
[[tweet]]
name = "Joshua Steven‏‏"
twitter_handle = "@jscarto"
quote = "Can't overstate how much I enjoy <a href='https://twitter.com/gohugoio' target='_blank'>@GoHugoIO</a>. My site is relatively small, but *18 ms* to build the whole thing made template development and proofing a breeze."
link = "https://twitter.com/jscarto/status/1039648827815485440"
date = 2018-09-12T00:00:00Z
[[tweet]] [[tweet]]
name = "Jens Munch" name = "Jens Munch"
twitter_handle = "@jensamunch" twitter_handle = "@jensamunch"

217
docs/data/references.toml
View file

@ -1,217 +0,0 @@
[[quotes]]
name = "Joshua Steven‏‏"
twitter_handle = "@jscarto"
quote = "Can't overstate how much I enjoy @GoHugoIO. My site is relatively small, but *18 ms* to build the whole thing made template development and proofing a breeze."
link = "https://twitter.com/jscarto/status/1039648827815485440"
date = 2018-09-12T00:00:00Z
[[quotes]]
name = "Execute‏‏"
twitter_handle = "@executerun"
quote = "Hah, #gohugo. I was working with #gohugo on #linux but now I realised how easy is to set-up it on #windows. Just need to add binary to #path!"
link = "https://twitter.com/executerun/status/809753145270272005"
date = 2016-12-16T00:00:00Z
[[quotes]]
name = "Janez Čadež‏"
twitter_handle = "@jamziSLO"
quote = "Building @garazaFRI website in #hugo. This static site generator is soooo damn fast!"
link = "https://twitter.com/jamziSLO/status/817720283977183234"
date = 2017-01-07T00:00:00Z
[[quotes]]
name = "Hans Beck"
twitter_handle = "@EnrichedGamesHB"
quote = "Diving deeper into @GoHugoIO . A lot of docs there, top work! But I've the impressed that #gohugo is far easier than its feels from the docs!"
link = "https://twitter.com/EnrichedGamesHB/status/836854762440130560"
date = 2017-03-01T00:00:00Z
[[quotes]]
name = "Alan Richardson"
twitter_handle = "@eviltester"
quote = "I migrated the <a href='https://twitter.com/BlackOpsTesting'> @BlackOpsTesting </a> .com website from docpad to Hugo last weekend. http://gohugo.io/ Super Fast HTML Generation <a href='https://twitter.com/spf13'> @spf13 </a>"
link = "https://twitter.com/eviltester/status/553520335115808768"
date = 2015-01-09T00:00:00Z
[[quotes]]
name = "Baron Schwartz"
twitter_handle = "@xaprb"
quote = "Hugo is impressively capable. It's a static site generator by <a href='https://twitter.com/spf13'> @spf13 </a> written in <a href='https://twitter.com/hashtag/golang?src=hash'> #golang </a> . Just upgraded to latest release; very powerful. "
link = "https://twitter.com/xaprb/status/556894866488455169"
date = 2015-01-18T00:00:00Z
[[quotes]]
name = "Dave Cottlehuber"
twitter_handle = "@dch__"
quote = "I just fell in love with #hugo, a static site/blog engine written by @spf13 in #golang + stellar docs"
link = "https://twitter.com/dch__/status/460158115498176512"
date = 2014-04-26T00:00:00Z
[[quotes]]
name = "David Caunt"
twitter_handle = "@dcaunt"
quote = "I had a play with Hugo and it was good, uses Markdown files for content"
link = "https://twitter.com/dcaunt/statuses/406466996277374976"
date = 2013-11-29T00:00:00Z
[[quotes]]
name = "David Gay"
twitter_handle = "@oddshocks"
quote = "Hugo is super-rad."
link = "https://twitter.com/oddshocks/statuses/405083217893421056"
date = 2013-11-25T00:00:00Z
[[quotes]]
name = "Diti"
twitter_handle = "@DitiPengi"
quote = "The dev version of Hugo is AWESOME! &lt;3 I promise, I will try to learn go ASAP and help contribute to the project! Just too great!"
link = "https://twitter.com/DitiPengi/status/472470974051676160"
date = 2014-05-30T00:00:00Z
[[quotes]]
name = "Douglas Stephen "
twitter_handle = "@DougStephenJr"
quote = "Even as a long-time Octopress fan, I’ve gotta admit that this project Hugo looks very very cool"
link = "https://twitter.com/DougStephenJr/statuses/364512471660249088"
date = 2013-08-05T00:00:00Z
[[quotes]]
name = "Hugo Rodger-Brown"
twitter_handle = "@hugorodgerbrown"
quote = "Finally someone builds me my own static site generator"
link = "https://twitter.com/hugorodgerbrown/statuses/364417910153818112"
date = 2013-05-08T00:00:00Z
[[quotes]]
name = "Hugo Roy"
twitter_handle = "@hugoroyd"
quote = "Finally the answer to the question my parents have been asking: What does Hugo do?"
link = "https://twitter.com/hugoroyd/status/501704796727173120"
date = 2014-08-19T00:00:00Z
[[quotes]]
name = "Daniel Miessler"
twitter_handle = "@DanielMiessler"
quote = "Websites for named vulnerabilities should run on static site generator platforms like Hugo. Read-only + burst traffic = static."
link = "https://twitter.com/DanielMiessler/status/704703841673957376"
date = 2016-03-01T00:00:00Z
[[quotes]]
name = "Javier Segura"
twitter_handle = "@jsegura"
quote = "Another site generated with Hugo here! I'm getting in love with it."
link = "https://twitter.com/jsegura/status/465978434154659841"
date = 2014-05-12T00:00:00Z
[[quotes]]
name = "Jim Biancolo"
twitter_handle = "@jimbiancolo"
quote = "I’m loving the static site generator renaissance we are currently enjoying. Hugo is new, looks great, written in Go"
link = "https://twitter.com/jimbiancolo/statuses/408678420348813314"
date = 2013-05-12T00:00:00Z
[[quotes]]
name = "Jip J. Dekker"
twitter_handle = "@jipjdekker"
quote = "Building a personal website in Hugo. Works like a charm. And written in @golang!"
link = "https://twitter.com/jipjdekker/status/413783548735152131"
date = 2013-12-19T00:00:00Z
[[quotes]]
name = "Jose Gonzalvo"
twitter_handle = "@jgonzalvo"
quote = "Checking out Hugo; Loving it so far. Like Jekyll but not so blog-oriented and written in go"
link = "https://twitter.com/jgonzalvo/statuses/408177855819173888"
date = 2013-12-04T00:00:00Z
[[quotes]]
name = "Josh Matz"
twitter_handle = "@joshmatz"
quote = "A static site generator without the long build times? Yes, please!"
link = "https://twitter.com/joshmatz/statuses/364437436870696960"
date = 2013-08-05T00:00:00Z
[[quotes]]
name = "Kieran Healy"
twitter_handle = "@kjhealy"
quote = "OK, so in today's speed battle of static site generators, @spf13's hugo is kicking everyone's ass, by miles."
link = "https://twitter.com/kjhealy/status/437349384809115648"
date = 2014-02-22T00:00:00Z
[[quotes]]
name = "Ludovic Chabant"
twitter_handle = "@ludovicchabant"
quote = "Good work on Hugo, I’m impressed with the speed!"
link = "https://twitter.com/ludovicchabant/statuses/408806199602053120"
date = 2013-12-06T00:00:00Z
[[quotes]]
name = "Luke Holder"
twitter_handle = "@lukeholder"
quote = "this is AWESOME. a single little executable and so fast."
link = "https://twitter.com/lukeholder/status/430352287936946176"
date = 2014-02-03T00:00:00Z
[[quotes]]
name = "Markus Eliasson"
twitter_handle = "@markuseliasson"
quote = "Hugo is fast, dead simple to setup and well documented"
link = "https://twitter.com/markuseliasson/status/501594865877008384"
date = 2014-08-19T00:00:00Z
[[quotes]]
name = "mercime"
twitter_handle = "@mercime_one"
quote = "Hugo: Makes the Web Fun Again"
link = "https://twitter.com/mercime_one/status/500547145087205377"
date = 2014-08-16T00:00:00Z
[[quotes]]
name = "Michael Whatcott"
twitter_handle = "@mdwhatcott"
quote = "One more satisfied #Hugo blogger. Thanks @spf13 and friends!"
link = "https://twitter.com/mdwhatcott/status/469980686531571712"
date = 2014-05-23T00:00:00Z
[[quotes]]
name = "Nathan Toups"
twitter_handle = "@rojoroboto"
quote = "I love Hugo! My site is generated with it now http://rjrbt.io"
link = "https://twitter.com/rojoroboto/status/423439915620106242"
date = 2014-01-15T00:00:00Z
[[quotes]]
name = "Ruben Solvang"
twitter_handle = "@messo85"
quote = "#Hugo is the new @jekyllrb / @middlemanapp! Faster, easier and runs everywhere."
link = "https://twitter.com/messo85/status/472825062027182081"
date = 2014-05-31T00:00:00Z
[[quotes]]
name = "Ryan Martinsen"
twitter_handle = "@popthestack"
quote = "Also, I re-launched my blog (it looks the same as before) using Hugo, a *fast* static engine. Very happy with it. <a href='http://gohugo.io/'>gohugo.io</a>"
link = "https://twitter.com/popthestack/status/549972754125307904"
date = 2014-12-30T00:00:00Z
[[quotes]]
name = "The Lone Cuber"
twitter_handle = "@TheLoneCuber"
quote = "Jekyll is dead to me these days though... long live Hugo! Hugo is *by far* the best in its field. Thanks for making it happen."
link = "https://twitter.com/TheLoneCuber/status/495716684456398848"
date = 2014-08-02T00:00:00Z
[[quotes]]
name = "The Lone Cuber"
twitter_handle = "@TheLoneCuber"
quote = "Finally, a publishing platform that's a joy to use. #NoMoreBarriers"
link = "https://twitter.com/TheLoneCuber/status/495731334711488512"
date = 2014-08-02T00:00:00Z
[[quotes]]
name = "WorkHTML"
twitter_handle = "@workhtml"
quote = "<a href='https://twitter.com/hashtag/Hugo?src=hash'> #Hugo </a> A very good alternative for <a href='https://twitter.com/hashtag/wordpress?src=hash'> #wordpress </a> !!! A fast and modern static website engine <a href='http://gohugo.io/'> gohugo.io </a>"
link = "https://twitter.com/workhtml/status/563064361301053440"
date = 2015-02-04T00:00:00Z

2
docs/netlify.toml
View file

@ -1,6 +1,6 @@
[build] [build]
publish = "public" publish = "public"
command = "hugo --minify" command = "hugo"
[context.production.environment] [context.production.environment]
HUGO_VERSION = "0.48" HUGO_VERSION = "0.48"