mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-21 20:46:30 -05:00
Squashed 'docs/' changes from 5d9a6703..f3c88b08
f3c88b08 Add warning on GitInfo and Shallow Clones fa5be591 Make the two common Taxonomy templates explicit 4a81c507 Update pull request link in showcase.html f751e57a Update christianmendoza.me in the showcase d582419b Remove commit message prefix from showcase addition guide d12791cf Fix path for screenshot in showcase addition guide e487b916 Add invincible.site to the showcase c85cfccf Update guide for showcase additions c44b31c1 Fix spelling dc10d7f6 Add slightly better GitHub install description 2611980f Revert "Add workaround to Fetch from GitHub documentation" b2e56907 Fix Git commit link in footer b025a638 Regenerate commands docs for v0.24.1 0741ad08 Update README.md 942d130a Add branch info to README e8c36390 Set hugoDocs/master to 0.24.1 c4e21471 Add workaround to Fetch from GitHub documentation db0a3c08 Fix typo in release note git-subtree-dir: docs git-subtree-split: f3c88b081022c945f010cdbfcd25e0008e0c3f5b
This commit is contained in:
Bjørn Erik Pedersen
parent
dd78d5b23f
commit
37c69054e2
39 changed files with 117 additions and 72 deletions
10
README.md
10
README.md
|
|
@ -1,3 +1,13 @@
|
|||
# Hugo Docs
|
||||
|
||||
Documentation site for [Hugo](https://github.com/gohugoio/hugo), the very fast and flexible static site generator built with love in GoLang.
|
||||
|
||||
## Branches
|
||||
|
||||
* The `master` branch is the **current Hugo version** and will be auto-deployed to [gohugo.io/](https://gohugo.io/).
|
||||
* Anything not relevant to the current Hugo version goes into the `dev` branch.
|
||||
* Changes in [hugo/docs](https://github.com/gohugoio/hugo/tree/master/docs) will, in general, be merged once every release, but can be manually merged/cherry picked if needed. This goes both ways.
|
||||
* All contributions that is not tightly coupled with code changes, should be made directly to `hugoDocs`.
|
||||
* But we also merge PRs into [hugo/docs](https://github.com/gohugoio/hugo/tree/master/docs), but preferably changes that is related to the code in the PR itself
|
||||
|
||||
To summarize, we have two branches in this repository: `master` (current Hugo) and `dev` (next Hugo).
|
||||
|
|
|
|||
|
|
@ -26,7 +26,7 @@ notAlternative = true
|
|||
[params]
|
||||
description = "Documentation of Hugo, a fast and flexible static site generator built with love by spf13, bep and friends in Go"
|
||||
author = "Steve Francia (spf13) and friends"
|
||||
release = "0.25-DEV"
|
||||
release = "0.24.1"
|
||||
|
||||
[taxonomies]
|
||||
tag = "tags"
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo"
|
||||
slug: hugo
|
||||
url: /commands/hugo/
|
||||
|
|
@ -77,4 +77,4 @@ hugo [flags]
|
|||
* [hugo undraft](/commands/hugo_undraft/) - Undraft changes the content's draft status from 'True' to 'False'
|
||||
* [hugo version](/commands/hugo_version/) - Print the version number of Hugo
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo benchmark"
|
||||
slug: hugo_benchmark
|
||||
url: /commands/hugo_benchmark/
|
||||
|
|
@ -69,4 +69,4 @@ hugo benchmark [flags]
|
|||
### SEE ALSO
|
||||
* [hugo](/commands/hugo/) - hugo builds your site
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo check"
|
||||
slug: hugo_check
|
||||
url: /commands/hugo_check/
|
||||
|
|
@ -34,4 +34,4 @@ Contains some verification checks
|
|||
* [hugo](/commands/hugo/) - hugo builds your site
|
||||
* [hugo check ulimit](/commands/hugo_check_ulimit/) - Check system ulimit settings
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo check ulimit"
|
||||
slug: hugo_check_ulimit
|
||||
url: /commands/hugo_check_ulimit/
|
||||
|
|
@ -38,4 +38,4 @@ hugo check ulimit [flags]
|
|||
### SEE ALSO
|
||||
* [hugo check](/commands/hugo_check/) - Contains some verification checks
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo config"
|
||||
slug: hugo_config
|
||||
url: /commands/hugo_config/
|
||||
|
|
@ -37,4 +37,4 @@ hugo config [flags]
|
|||
### SEE ALSO
|
||||
* [hugo](/commands/hugo/) - hugo builds your site
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo convert"
|
||||
slug: hugo_convert
|
||||
url: /commands/hugo_convert/
|
||||
|
|
@ -41,4 +41,4 @@ See convert's subcommands toJSON, toTOML and toYAML for more information.
|
|||
* [hugo convert toTOML](/commands/hugo_convert_totoml/) - Convert front matter to TOML
|
||||
* [hugo convert toYAML](/commands/hugo_convert_toyaml/) - Convert front matter to YAML
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo convert toJSON"
|
||||
slug: hugo_convert_toJSON
|
||||
url: /commands/hugo_convert_tojson/
|
||||
|
|
@ -41,4 +41,4 @@ hugo convert toJSON [flags]
|
|||
### SEE ALSO
|
||||
* [hugo convert](/commands/hugo_convert/) - Convert your content to different formats
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo convert toTOML"
|
||||
slug: hugo_convert_toTOML
|
||||
url: /commands/hugo_convert_totoml/
|
||||
|
|
@ -41,4 +41,4 @@ hugo convert toTOML [flags]
|
|||
### SEE ALSO
|
||||
* [hugo convert](/commands/hugo_convert/) - Convert your content to different formats
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo convert toYAML"
|
||||
slug: hugo_convert_toYAML
|
||||
url: /commands/hugo_convert_toyaml/
|
||||
|
|
@ -41,4 +41,4 @@ hugo convert toYAML [flags]
|
|||
### SEE ALSO
|
||||
* [hugo convert](/commands/hugo_convert/) - Convert your content to different formats
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo env"
|
||||
slug: hugo_env
|
||||
url: /commands/hugo_env/
|
||||
|
|
@ -37,4 +37,4 @@ hugo env [flags]
|
|||
### SEE ALSO
|
||||
* [hugo](/commands/hugo/) - hugo builds your site
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo gen"
|
||||
slug: hugo_gen
|
||||
url: /commands/hugo_gen/
|
||||
|
|
@ -36,4 +36,4 @@ A collection of several useful generators.
|
|||
* [hugo gen doc](/commands/hugo_gen_doc/) - Generate Markdown documentation for the Hugo CLI.
|
||||
* [hugo gen man](/commands/hugo_gen_man/) - Generate man pages for the Hugo CLI
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo gen autocomplete"
|
||||
slug: hugo_gen_autocomplete
|
||||
url: /commands/hugo_gen_autocomplete/
|
||||
|
|
@ -55,4 +55,4 @@ hugo gen autocomplete [flags]
|
|||
### SEE ALSO
|
||||
* [hugo gen](/commands/hugo_gen/) - A collection of several useful generators.
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo gen doc"
|
||||
slug: hugo_gen_doc
|
||||
url: /commands/hugo_gen_doc/
|
||||
|
|
@ -44,4 +44,4 @@ hugo gen doc [flags]
|
|||
### SEE ALSO
|
||||
* [hugo gen](/commands/hugo_gen/) - A collection of several useful generators.
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo gen man"
|
||||
slug: hugo_gen_man
|
||||
url: /commands/hugo_gen_man/
|
||||
|
|
@ -40,4 +40,4 @@ hugo gen man [flags]
|
|||
### SEE ALSO
|
||||
* [hugo gen](/commands/hugo_gen/) - A collection of several useful generators.
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo import"
|
||||
slug: hugo_import
|
||||
url: /commands/hugo_import/
|
||||
|
|
@ -36,4 +36,4 @@ Import requires a subcommand, e.g. `hugo import jekyll jekyll_root_path target_p
|
|||
* [hugo](/commands/hugo/) - hugo builds your site
|
||||
* [hugo import jekyll](/commands/hugo_import_jekyll/) - hugo import from Jekyll
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo import jekyll"
|
||||
slug: hugo_import_jekyll
|
||||
url: /commands/hugo_import_jekyll/
|
||||
|
|
@ -40,4 +40,4 @@ hugo import jekyll [flags]
|
|||
### SEE ALSO
|
||||
* [hugo import](/commands/hugo_import/) - Import your site from others.
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo list"
|
||||
slug: hugo_list
|
||||
url: /commands/hugo_list/
|
||||
|
|
@ -39,4 +39,4 @@ List requires a subcommand, e.g. `hugo list drafts`.
|
|||
* [hugo list expired](/commands/hugo_list_expired/) - List all posts already expired
|
||||
* [hugo list future](/commands/hugo_list_future/) - List all posts dated in the future
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo list drafts"
|
||||
slug: hugo_list_drafts
|
||||
url: /commands/hugo_list_drafts/
|
||||
|
|
@ -38,4 +38,4 @@ hugo list drafts [flags]
|
|||
### SEE ALSO
|
||||
* [hugo list](/commands/hugo_list/) - Listing out various types of content
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo list expired"
|
||||
slug: hugo_list_expired
|
||||
url: /commands/hugo_list_expired/
|
||||
|
|
@ -39,4 +39,4 @@ hugo list expired [flags]
|
|||
### SEE ALSO
|
||||
* [hugo list](/commands/hugo_list/) - Listing out various types of content
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo list future"
|
||||
slug: hugo_list_future
|
||||
url: /commands/hugo_list_future/
|
||||
|
|
@ -39,4 +39,4 @@ hugo list future [flags]
|
|||
### SEE ALSO
|
||||
* [hugo list](/commands/hugo_list/) - Listing out various types of content
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo new"
|
||||
slug: hugo_new
|
||||
url: /commands/hugo_new/
|
||||
|
|
@ -47,4 +47,4 @@ hugo new [path] [flags]
|
|||
* [hugo new site](/commands/hugo_new_site/) - Create a new site (skeleton)
|
||||
* [hugo new theme](/commands/hugo_new_theme/) - Create a new theme
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo new site"
|
||||
slug: hugo_new_site
|
||||
url: /commands/hugo_new_site/
|
||||
|
|
@ -42,4 +42,4 @@ hugo new site [path] [flags]
|
|||
### SEE ALSO
|
||||
* [hugo new](/commands/hugo_new/) - Create new content for your site
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo new theme"
|
||||
slug: hugo_new_theme
|
||||
url: /commands/hugo_new_theme/
|
||||
|
|
@ -41,4 +41,4 @@ hugo new theme [name] [flags]
|
|||
### SEE ALSO
|
||||
* [hugo new](/commands/hugo_new/) - Create new content for your site
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo server"
|
||||
slug: hugo_server
|
||||
url: /commands/hugo_server/
|
||||
|
|
@ -83,4 +83,4 @@ hugo server [flags]
|
|||
### SEE ALSO
|
||||
* [hugo](/commands/hugo/) - hugo builds your site
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo undraft"
|
||||
slug: hugo_undraft
|
||||
url: /commands/hugo_undraft/
|
||||
|
|
@ -39,4 +39,4 @@ hugo undraft path/to/content [flags]
|
|||
### SEE ALSO
|
||||
* [hugo](/commands/hugo/) - hugo builds your site
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
date: 2017-06-22T21:51:29+02:00
|
||||
date: 2017-06-29T08:42:09+02:00
|
||||
title: "hugo version"
|
||||
slug: hugo_version
|
||||
url: /commands/hugo_version/
|
||||
|
|
@ -37,4 +37,4 @@ hugo version [flags]
|
|||
### SEE ALSO
|
||||
* [hugo](/commands/hugo/) - hugo builds your site
|
||||
|
||||
###### Auto generated by spf13/cobra on 22-Jun-2017
|
||||
###### Auto generated by spf13/cobra on 29-Jun-2017
|
||||
|
|
|
|||
|
|
@ -60,7 +60,7 @@ You **must use govendor** to fetch Hugo's dependencies.
|
|||
|
||||
You got your new website running and it's powered by Hugo? Great. You can add your website with a few steps to the [showcase](/showcase/).
|
||||
|
||||
First, make sure that you created a [fork](https://help.github.com/articles/fork-a-repo/) of Hugo on GitHub and cloned your fork on your local computer. Next, create a separate branch for your additions:
|
||||
First, make sure that you created a [fork](https://help.github.com/articles/fork-a-repo/) of the [`hugoDocs`](https://github.com/gohugoio/hugodocs) repository on GitHub and cloned your fork on your local computer. **Next, create a separate branch for your additions**:
|
||||
|
||||
```
|
||||
# You can choose a different descriptive branch name if you like
|
||||
|
|
@ -94,7 +94,7 @@ title: example
|
|||
|
||||
Add at least values for `sitelink`, `title`, `description` and a path for `thumbnail`.
|
||||
|
||||
Furthermore, we need to create the thumbnail of your website. **It's important that the thumbnail has the required dimensions of 600px by 400px.** Give your thumbnail a name like `example-tn.png`. Save it under `docs/static/img/`.
|
||||
Furthermore, we need to create the thumbnail of your website. **It's important that the thumbnail has the required dimensions of 600px by 400px.** Give your thumbnail a name like `example-tn.png`. Save it under `static/img/`.
|
||||
|
||||
Check a last time that everything works as expected. Start Hugo's built-in server in order to inspect your local copy of the showcase in the browser:
|
||||
|
||||
|
|
@ -102,9 +102,9 @@ Check a last time that everything works as expected. Start Hugo's built-in serve
|
|||
|
||||
If everything looks fine, we are ready to commit your additions. For the sake of best practices, please make sure that your commit follows our [code contribution guideline](https://github.com/gohugoio/hugo#code-contribution-guideline).
|
||||
|
||||
git commit -m"docs: Add example.com to the showcase"
|
||||
git commit -m"Add example.com to the showcase"
|
||||
|
||||
Last but not least, we're ready to create a [pull request](https://github.com/gohugoio/hugo/compare).
|
||||
Last but not least, we're ready to create a [pull request](https://github.com/gohugoio/hugoDocs/compare).
|
||||
|
||||
Don't forget to accept the contributor license agreement. Click on the yellow badge in the automatically added comment in the pull request.
|
||||
|
||||
|
|
|
|||
|
|
@ -44,7 +44,11 @@ Subject
|
|||
: commit message subject, e.g. `tpl: Add custom index function`
|
||||
|
||||
|
||||
## Performance Considerations
|
||||
## Other Considerations
|
||||
|
||||
The Git integrations should be fairly performant, but it does add some time to the build, which depends somewhat on the Git history size.
|
||||
|
||||
The accuracy of data depends on the underlying local git respository. If the local repository is a *shallow clone*, then any file that hasn't been modified in the truncated history will default to data in the oldest commit. In particular, if the respository has been cloned using `--depth=1` then every file will the exact same `GitInfo` data -- that of the only commit in the repository.
|
||||
|
||||
In particular, many CI/CD systems such as [travis-ci.org](https://travis-ci.org) default to a clone depth of 50 which is unlikely to be deep enough. You can explicitly add back the missing history using using `git fetch --unshallow` or [make the initial checkout deeper](https://docs.travis-ci.com/user/customizing-the-build#Git-Clone-Depth).
|
||||
|
||||
|
|
|
|||
|
|
@ -123,14 +123,16 @@ Therefore, a simple `go get` is not supported since `go get` is not vendor-aware
|
|||
You **must use govendor** to fetch Hugo's dependencies.
|
||||
|
||||
### Fetch from GitHub
|
||||
|
||||
The commands below assume that you have [Go](https://golang.org/dl/) installed with your `$GOPATH` set.
|
||||
|
||||
go get github.com/kardianos/govendor
|
||||
govendor get github.com/gohugoio/hugo
|
||||
|
||||
`govendor get` will fetch Hugo and all its dependent libraries to
|
||||
`$HOME/go/src/github.com/gohugoio/hugo`, and compile everything into a final `hugo`
|
||||
`$GOPATH/src/github.com/gohugoio/hugo`, and compile everything into a final `hugo`
|
||||
(or `hugo.exe`) executable, which you will find sitting inside
|
||||
`$HOME/go/bin/`, all ready to go!
|
||||
`$GOPATH/go/bin/`, all ready to go!
|
||||
|
||||
*Windows users: where you see the `$HOME` environment variable above, replace it with `%USERPROFILE%`.*
|
||||
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@ title: 0.24.1
|
|||
|
||||
|
||||
|
||||
This release fixes some important **archetype-related regressions** from the recent Hugo 0.24-relase.
|
||||
This release fixes some important **archetype-related regressions** from the recent Hugo 0.24-release.
|
||||
|
||||
## Fixes
|
||||
|
||||
|
|
|
|||
|
|
@ -1,10 +1,10 @@
|
|||
---
|
||||
lastmod: 2017-06-30
|
||||
date: 2016-10-16T13:30:47-04:00
|
||||
date: 2016-12-20T17:21:00-05:00
|
||||
description: "Personal site"
|
||||
license: ""
|
||||
licenseLink: ""
|
||||
sitelink: https://christianmendoza.me/
|
||||
sitelink: https://www.christianmendoza.me/
|
||||
sourceLink: https://github.com/christianmendoza/christianmendoza.me
|
||||
tags:
|
||||
- personal
|
||||
|
|
|
|||
15
content/showcase/invincible.md
Normal file
15
content/showcase/invincible.md
Normal file
|
|
@ -0,0 +1,15 @@
|
|||
---
|
||||
date: 2017-07-01T01:11:00Z
|
||||
description: "The Invincible: The tale of a disillusioned prince"
|
||||
license: "Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License"
|
||||
licenseLink: "https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode"
|
||||
sitelink: https://invincible.site/
|
||||
sourceLink: https://github.com/shazic/the_invincible
|
||||
tags:
|
||||
- personal
|
||||
- blog
|
||||
- graphic novel
|
||||
thumbnail: /img/invincible-tn.jpg
|
||||
title: Invincible
|
||||
---
|
||||
|
||||
|
|
@ -13,14 +13,28 @@ title: Taxonomy Templates
|
|||
weight: 30
|
||||
---
|
||||
|
||||
There are two different templates that the use of taxonomies will require you to provide.
|
||||
Taxonomy templates should be placed in the folder `layouts/taxonomy`.
|
||||
When Taxonomy term template is provided for a Taxonomy, a section is rendered for it at `/SINGULAR/`. (eg. `/tag/` or `/category/`)
|
||||
|
||||
Both templates are covered in detail in the templates section.
|
||||
There are two different templates that the use of taxonomies will require you to provide:
|
||||
|
||||
A [list template](/templates/list/) is any template that will be used to render multiple pieces of
|
||||
content in a single html page. This template will be used to generate
|
||||
all the automatically created taxonomy pages.
|
||||
### All content attached to taxonomy
|
||||
|
||||
A [taxonomy terms template](/templates/terms/) is a template used to
|
||||
generate the list of terms for a given template.
|
||||
A [taxonomy terms template](/templates/terms/) is a template which has access to all the full Taxonomy structure.
|
||||
This Template is commonly used to generate the list of terms for a given template.
|
||||
|
||||
|
||||
#### layouts/taxonomy/SINGULAR.terms.html
|
||||
|
||||
For example: `tag.terms.html`, `category.terms.html`, or your custom Taxonomy: `actor.terms.html`
|
||||
|
||||
### All content attached to term
|
||||
|
||||
A [list template](/templates/list/) is used to automatically generate pages for each unique term found.
|
||||
|
||||
|
||||
#### layouts/taxonomy/SINGULAR.html
|
||||
|
||||
For example: `tag.html`, `category.html`, or your custom Taxonomy: `actor.html`
|
||||
|
||||
Terms are rendered at `SINGULAR/TERM/`. (eg. `/tag/book/` or `/category/news/`)
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
<div class="row">
|
||||
<div class="footer-panel">
|
||||
<p>Last revision: {{ .Lastmod.Format "January 2, 2006" }}{{ if .IsPage }}{{ with .GitInfo }} | <a href="https://github.com/gohugoio/hugo/commit/{{ .Hash }}">{{ .Subject }} ({{ .AbbreviatedHash }})</a>{{end }}{{ end }}
|
||||
<p>Last revision: {{ .Lastmod.Format "January 2, 2006" }}{{ if .IsPage }}{{ with .GitInfo }} | <a href="https://github.com/gohugoio/hugoDocs/commit/{{ .Hash }}">{{ .Subject }} ({{ .AbbreviatedHash }})</a>{{end }}{{ end }}
|
||||
<span style="float: right;">Hugo v{{ .Site.Params.release }} documentation</span>
|
||||
</p>
|
||||
{{ with getenv "REPOSITORY_URL" -}}
|
||||
|
|
|
|||
|
|
@ -11,7 +11,7 @@
|
|||
<hr>
|
||||
|
||||
<blockquote>
|
||||
If you want to be added to this page, please send a <a href="https://github.com/gohugoio/hugo/pulls">pull request</a>. Check out the <a href="{{ relref . "community/contributing.md#showcase-additions" }}">how-to guide</a>.
|
||||
If you want to be added to this page, please send a <a href="https://github.com/gohugoio/hugoDocs/pulls">pull request</a>. Check out the <a href="{{ relref . "community/contributing.md#showcase-additions" }}">how-to guide</a>.
|
||||
</blockquote>
|
||||
|
||||
{{ partial "footer.html" . }}
|
||||
|
|
|
|||
Binary file not shown.
|
Before Width: | Height: | Size: 55 KiB After Width: | Height: | Size: 41 KiB |
BIN
static/img/invincible-tn.jpg
Normal file
BIN
static/img/invincible-tn.jpg
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 25 KiB |
Loading…
Reference in a new issue