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

Squashed 'docs/' changes from 6b00298bb..e5e98b950

Browse source 
e5e98b950 Update code-toggle.md
340c9c623 Update 'Fetch from Github' installation instructions in line with Github README
d9f06c23c Add tip about clearing browser cache (#608)
7c9df4731 Adding Remark as additional Comments Alternatives for hugo (#607)
b1ce8bf02 Revert "Temp change of baseURL"
fdbc582ff Temp change of baseURL
5ec663bd6 Fix wrong date in frontmatter config example (#602)
0b3022eb1 Fix broken link to https://www.wercker.com (#603)
b4a7e31a6 Turn off minification
bfcc1ac21 Add a Tweet
8be09c0b4 Remove unused data file

git-subtree-dir: docs
git-subtree-split: e5e98b950ca631c3135ac2f4446c79d71d2196be
This commit is contained in:
Bjørn Erik Pedersen 2018-09-23 23:48:53 +02:00
parent 13e64d7276
commit 807c551922
9 changed files with 24 additions and 233 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
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)
* [Tutorial on Implementing Isso with Hugo][issotutorial]
* [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.-->
<!-- * [Kaiju](https://github.com/spf13/kaiju) -->

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

@ -15,6 +15,10 @@ toc: true
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.
{{% 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
{{< code-toggle file="config">}}

2
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`
: 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:

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

@ -75,22 +75,18 @@ scoop install hugo
#### Prerequisite Tools
* [Git][installgit]
* [Go (latest or previous version)][installgo]
#### 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.)
* [Go (at least Go 1.11)](https://golang.org/dl/)
#### 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" >}}
go get github.com/magefile/mage
go get -d github.com/gohugoio/hugo
cd ${GOPATH:-$HOME/go}/src/github.com/gohugoio/hugo
mage vendor
HUGO_BUILD_TAGS=extended mage install
mkdir $HOME/src
cd $HOME/src
git clone https://github.com/gohugoio/hugo.git
cd hugo
go install
{{< /code >}}
Remove `HUGO_BUILD_TAGS=extended` if you do not want Sass/SCSS support.

2
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.
{{% 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 %}}

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

@ -128,7 +128,7 @@ git push -u origin master
## 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]

7
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]]
name = "Jens Munch"
twitter_handle = "@jensamunch"

217
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
netlify.toml
View file

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