From 8908667221a2ea9c1accd064ed5e96c9036dae74 Mon Sep 17 00:00:00 2001 From: "Daniel F. Dickinson" Date: Wed, 13 Apr 2022 11:40:47 -0400 Subject: [PATCH] Add git required FAQ & remove ZIP from Quick Start (#1713) * Update FAQ for the 'practical' requirement of Git Per Signed-off-by: Daniel F. Dickinson * Make git required for Quick Start guide As suggested in Closes #1712 Update FAQ for git 'effectively' required & remove ZIP section from Quick Start Signed-off-by: Daniel F. Dickinson --- content/en/getting-started/quick-start.md | 9 +-------- content/en/troubleshooting/faq.md | 11 +++++++++++ 2 files changed, 12 insertions(+), 8 deletions(-) diff --git a/content/en/getting-started/quick-start.md b/content/en/getting-started/quick-start.md index 662138ae6..d30ba3cfe 100644 --- a/content/en/getting-started/quick-start.md +++ b/content/en/getting-started/quick-start.md @@ -21,7 +21,7 @@ toc: true {{% note %}} This quick start uses `macOS` in the examples. For instructions about how to install Hugo on other operating systems, see [install](/getting-started/installing). -It is recommended to have [Git installed](https://git-scm.com/downloads) to run this tutorial. +It is required to have [Git installed](https://git-scm.com/downloads) to run this tutorial. For other approaches to learning Hugo (like books or video tutorials), refer to the [external learning resources](/getting-started/external-learning-resources/) page. {{% /note %}} @@ -68,13 +68,6 @@ git init git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke ``` -*Note for non-git users:* - - If you do not have git installed, you can download the archive of the latest - version of this theme from: - https://github.com/theNewDynamic/gohugo-theme-ananke/archive/master.zip - - Extract that .zip file to get a "gohugo-theme-ananke-master" directory. - - Rename that directory to "ananke", and move it into the "themes/" directory. - Then, add the theme to the site configuration: ```bash diff --git a/content/en/troubleshooting/faq.md b/content/en/troubleshooting/faq.md index 6e90bd0d4..548073b3f 100644 --- a/content/en/troubleshooting/faq.md +++ b/content/en/troubleshooting/faq.md @@ -56,3 +56,14 @@ error: failed to transform resource: TOCSS: failed to transform "scss/main.scss" We release two set of binaries for technical reasons. The extended version is not what you get by default for some installation methods. On the [release page](https://github.com/gohugoio/hugo/releases), look for archives with `extended` in the name. To build `hugo-extended`, use `go install --tags extended` To confirm, run `hugo version` and look for the word `extended`. + +## Do I need to install Git to create, deploy, and maintain a website with Hugo? + +>Technically, no. +> +>Practically, yes. + +* The primary installation method documented by most (perhaps all) themes is via Git or the Hugo Modules feature. +* The Hugo Modules feature requires Go, and Go “gets” with Git. +* A Git repository is required by CI/CD hosting (Bitbucket, Cloudflare, GitHub Pages, GitLab Pages, Netlify, et. al.). +* The canonical “last modified” date for content is its Git committer date; using anything else is error-prone.