From 807c551922707fc5ae0eb26e8f01638c0c63fdb3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B8rn=20Erik=20Pedersen?= Date: Sun, 23 Sep 2018 23:48:53 +0200 Subject: [PATCH] Squashed 'docs/' changes from 6b00298bb..e5e98b950 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 --- content/en/content-management/comments.md | 1 + content/en/getting-started/code-toggle.md | 4 + content/en/getting-started/configuration.md | 2 +- content/en/getting-started/installing.md | 20 +- content/en/getting-started/quick-start.md | 2 +- .../deployment-with-wercker.md | 2 +- data/homepagetweets.toml | 7 + data/references.toml | 217 ------------------ netlify.toml | 2 +- 9 files changed, 24 insertions(+), 233 deletions(-) delete mode 100644 data/references.toml diff --git a/content/en/content-management/comments.md b/content/en/content-management/comments.md index 17914ba2c..dad5d0786 100644 --- a/content/en/content-management/comments.md +++ b/content/en/content-management/comments.md @@ -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) diff --git a/content/en/getting-started/code-toggle.md b/content/en/getting-started/code-toggle.md index b304d2c5b..51c887a47 100644 --- a/content/en/getting-started/code-toggle.md +++ b/content/en/getting-started/code-toggle.md @@ -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">}} diff --git a/content/en/getting-started/configuration.md b/content/en/getting-started/configuration.md index 3f36eb28c..f43c51b9b 100644 --- a/content/en/getting-started/configuration.md +++ b/content/en/getting-started/configuration.md @@ -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: diff --git a/content/en/getting-started/installing.md b/content/en/getting-started/installing.md index ccf96317b..b5b210d3e 100644 --- a/content/en/getting-started/installing.md +++ b/content/en/getting-started/installing.md @@ -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. diff --git a/content/en/getting-started/quick-start.md b/content/en/getting-started/quick-start.md index 59a8513c8..16b69d7c1 100644 --- a/content/en/getting-started/quick-start.md +++ b/content/en/getting-started/quick-start.md @@ -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 %}} diff --git a/content/en/hosting-and-deployment/deployment-with-wercker.md b/content/en/hosting-and-deployment/deployment-with-wercker.md index ac9d7a3e6..1fed46430 100644 --- a/content/en/hosting-and-deployment/deployment-with-wercker.md +++ b/content/en/hosting-and-deployment/deployment-with-wercker.md @@ -128,7 +128,7 @@ git push -u origin master ## Set Up Wercker -To sign up for a free Wercker account, go to and click the **Sign Up** button on the top right of the home screen. +To sign up for a free Wercker account, go to and click the **Sign Up** button on the top right of the home screen. ![][3] diff --git a/data/homepagetweets.toml b/data/homepagetweets.toml index e5dbbefac..01f8c2fc2 100644 --- a/data/homepagetweets.toml +++ b/data/homepagetweets.toml @@ -1,3 +1,10 @@ +[[tweet]] +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 + [[tweet]] name = "Jens Munch" twitter_handle = "@jensamunch" diff --git a/data/references.toml b/data/references.toml deleted file mode 100644 index 67f3763bb..000000000 --- a/data/references.toml +++ /dev/null @@ -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 @BlackOpsTesting .com website from docpad to Hugo last weekend. http://gohugo.io/ Super Fast HTML Generation @spf13 " -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 @spf13 written in #golang . 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! <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. gohugo.io" -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 = " #Hugo A very good alternative for #wordpress !!! A fast and modern static website engine gohugo.io " -link = "https://twitter.com/workhtml/status/563064361301053440" -date = 2015-02-04T00:00:00Z diff --git a/netlify.toml b/netlify.toml index 8033bcd56..86d67ce08 100644 --- a/netlify.toml +++ b/netlify.toml @@ -1,6 +1,6 @@ [build] publish = "public" -command = "hugo --minify" +command = "hugo" [context.production.environment] HUGO_VERSION = "0.48"