mirror/gohugoio-hugo
1
0
Fork 0
mirror of https://github.com/gohugoio/hugo.git synced 2024-05-11 05:54:58 +00:00
Code Issues Releases Activity

Docs: Minor copyediting/proofreading

Browse Source 
- Correct some typos
- Add backticks and commas where necessary
- Use fenced code blocks specifying "bash" as the language
  to avoid weird highlighting
- Place commas outside of quotation marks surroundingn codes
  to avoid possible confusion
- Suggest users to use the discussion forum rather than the
  mailing list
This commit is contained in:
Anthony Fok
2014-12-04 09:26:12 -07:00
committed by bep
parent 736dd4b521
commit a6d3862b87
15 changed files with 83 additions and 75 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
docs/content/themes/creation.md
View File

@@ -37,10 +37,9 @@ a large amount of flexibility.
The default single file layout is located at `layouts/_default/single.html`.
### List of Contents
The default list file layout is located at `layouts/_default/list.html`
The default list file layout is located at `layouts/_default/list.html`.
### Partial Templates

28
docs/content/themes/customizing.md
View File

@@ -14,19 +14,19 @@ from within your working directory.
## Replacing Static files
If you would like to include a different file than the theme ships
with.. For example you would like to use a more recent version of jquery
then the theme happens to include simply place an identically name file in the same
relative location but in your working directory. For example if the
theme has jquery 1.6 in /themes/themename/static/js/jQuery.min.js, simply place your file
in the same relative path /static/js/jQuery.min.js.
For including a different file than what the theme ships
with. For example, if you would like to use a more recent version of jQuery
than what the theme happens to include, simply place an identically named file in the same
relative location but in your working directory. For example, if the
theme has jQuery 1.6 in `/themes/themename/static/js/jquery.min.js`, simply place your file
in the same relative path `/static/js/jquery.min.js`.
## Replace a single template file
Anytime Hugo looks for a matching template it will first check the
Anytime Hugo looks for a matching template, it will first check the
working directory before looking in the theme directory. If you would
like to modify a template simply create that template in your local
layouts directory. In the [template documentation](/templates/overview)
like to modify a template, simply create that template in your local
`layouts` directory. In the [template documentation](/templates/overview)
each different template type explains the rules it uses to determine
which template to use.
@@ -35,22 +35,22 @@ templates](/templates/partials). These partial templates are perfect for easy
injection into the theme with minimal maintenance to ensure future
compatibility.
**warning.. This only works for templates that Hugo knows about. If the
theme imports template files in a creatively named directory
Hugo won’t know to look for the local /layouts first**
**Warning: This only works for templates that Hugo knows about. If the
theme imports template files in a creatively named directory,
Hugo won’t know to look for the local `/layouts` first.**
## Replace an archetype
If the archetype that ships with the theme for a given content type (or
all content types) doesn’t fit with how you are using the theme, feel
free to copy it to your /archetypes directory and make modifications as
free to copy it to your `/archetypes` directory and make modifications as
you see fit.
## Beware of the default
**Default** is a very powerful force in Hugo... Especially as it pertains to
overwriting theme files. If a default is located in the local archetype
directory or /layouts/\_default/ directory it will be used instead of
directory or `/layouts/_default/` directory, it will be used instead of
any of the similar files in the theme.
It is usually better to override specific files rather than using the

5
docs/content/themes/installing.md
View File

@@ -18,8 +18,9 @@ repository which contains pointers to set of contributed themes.
If you would like to install all of the available hugo themes, simply
clone the entire repository from within your working directory.
git clone --recursive https://github.com/spf13/hugoThemes.git themes
```bash
git clone --recursive https://github.com/spf13/hugoThemes.git themes
```
## Installing a specific theme

4
docs/content/themes/overview.md
View File

@@ -17,8 +17,8 @@ site.
Hugo themes have been designed to be the perfect balance between
simplicity and functionality. Hugo themes are powered by the excellent
go template library. If you are new to go templates, see our [primer on
go templates](/templates/go-templates).
Go template library. If you are new to Go templates, see our [primer on
Go templates](/templates/go-templates).
Hugo themes support all modern features you come to expect. They are
structured in such a way to eliminate code duplication. Themes are also

6
docs/content/themes/usage.md
View File

@@ -10,13 +10,13 @@ weight: 30
---
Please make certain you have installed the themes you want to use in the
/themes directory.
`/themes` directory.
To use a theme for a site:
hugo -t ThemeName
The ThemeName must match the name of the directory inside /themes
The *ThemeName* must match the name of the directory inside `/themes`.
Hugo will then apply the theme first, then apply anything that is in the local
directory. To learn more, goto [customizing themes](/themes/customizing)
directory. To learn more, go to [customizing themes](/themes/customizing).