Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/ribice/kiss.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEmir Ribic <ribice@gmail.com>2018-02-03 11:11:59 +0300
committerEmir Ribic <ribice@gmail.com>2018-02-03 11:11:59 +0300
commitd6a567627d2b815e742c2d44df1091d73e6f057c (patch)
tree40c9318f8879e7e2127dd8355eae0a0637b40c68 /exampleSite
parent813caa69d5fa547bd08c0de4bd2e9a0649c48af0 (diff)
Trim whitespaces
Diffstat (limited to 'exampleSite')
-rw-r--r--exampleSite/config.toml2
-rw-r--r--exampleSite/content/about.md1
-rw-r--r--exampleSite/content/post/creating-a-new-theme.md146
-rw-r--r--exampleSite/content/post/goisforlovers.md48
4 files changed, 98 insertions, 99 deletions
diff --git a/exampleSite/config.toml b/exampleSite/config.toml
index c778c3d..4fbde67 100644
--- a/exampleSite/config.toml
+++ b/exampleSite/config.toml
@@ -7,7 +7,7 @@ disqusShortname = "shortname"
googleAnalytics = ""
# Number of posts per page
Paginate = 5
-enableRobotsTXT = true
+enableRobotsTXT = true
[params.assets]
diff --git a/exampleSite/content/about.md b/exampleSite/content/about.md
index f8cad87..47f9698 100644
--- a/exampleSite/content/about.md
+++ b/exampleSite/content/about.md
@@ -6,7 +6,6 @@ menu = "main"
Hugo is a static site engine written in Go.
-
It makes use of a variety of open source projects including:
* [Cobra](https://github.com/spf13/cobra)
diff --git a/exampleSite/content/post/creating-a-new-theme.md b/exampleSite/content/post/creating-a-new-theme.md
index d46413b..556c6ee 100644
--- a/exampleSite/content/post/creating-a-new-theme.md
+++ b/exampleSite/content/post/creating-a-new-theme.md
@@ -150,13 +150,13 @@ INFO: 2014/09/29 Using config file: config.toml
INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/
WARN: 2014/09/29 Unable to locate layout: [index.html _default/list.html _default/single.html]
WARN: 2014/09/29 Unable to locate layout: [404.html]
-0 draft content
-0 future content
-0 pages created
+0 draft content
+0 future content
+0 pages created
0 tags created
0 categories created
in 2 ms
-$
+$
```
The "`--verbose`" flag gives extra information that will be helpful when we build the template. Every line of the output that starts with "INFO:" or "WARN:" is present because we used that flag. The lines that start with "WARN:" are warning messages. We'll go over them later.
@@ -182,7 +182,7 @@ $ ls -l public
total 16
-rw-r--r-- 1 quoha staff 416 Sep 29 17:02 index.xml
-rw-r--r-- 1 quoha staff 262 Sep 29 17:02 sitemap.xml
-$
+$
```
Hugo created two XML files, which is standard, but there are no HTML files.
@@ -199,9 +199,9 @@ INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/config.toml
INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/
WARN: 2014/09/29 Unable to locate layout: [index.html _default/list.html _default/single.html]
WARN: 2014/09/29 Unable to locate layout: [404.html]
-0 draft content
-0 future content
-0 pages created
+0 draft content
+0 future content
+0 pages created
0 tags created
0 categories created
in 2 ms
@@ -269,7 +269,7 @@ $ find themes -type f | xargs ls -l
-rw-r--r-- 1 quoha staff 0 Sep 29 17:31 themes/zafta/layouts/partials/footer.html
-rw-r--r-- 1 quoha staff 0 Sep 29 17:31 themes/zafta/layouts/partials/header.html
-rw-r--r-- 1 quoha staff 93 Sep 29 17:31 themes/zafta/theme.toml
-$
+$
```
The skeleton includes templates (the files ending in .html), license file, a description of your theme (the theme.toml file), and an empty archetype.
@@ -332,9 +332,9 @@ INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/config.toml
INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/themes/zafta/static/ to /Users/quoha/Sites/zafta/public/
INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/
WARN: 2014/09/29 Unable to locate layout: [404.html theme/404.html]
-0 draft content
-0 future content
-0 pages created
+0 draft content
+0 future content
+0 pages created
0 tags created
0 categories created
in 2 ms
@@ -379,7 +379,7 @@ When Hugo created our theme, it created an empty home page template. Now, when w
$ find . -name index.html | xargs ls -l
-rw-r--r-- 1 quoha staff 0 Sep 29 20:21 ./public/index.html
-rw-r--r-- 1 quoha staff 0 Sep 29 17:31 ./themes/zafta/layouts/index.html
-$
+$
```
#### The Magic of Static
@@ -398,7 +398,7 @@ drwxr-xr-x 4 quoha staff 136 Sep 29 17:31 themes/zafta/layouts/partials
drwxr-xr-x 4 quoha staff 136 Sep 29 17:31 themes/zafta/static
drwxr-xr-x 2 quoha staff 68 Sep 29 17:31 themes/zafta/static/css
drwxr-xr-x 2 quoha staff 68 Sep 29 17:31 themes/zafta/static/js
-$
+$
```
## The Theme Development Cycle
@@ -454,9 +454,9 @@ INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/config.toml
INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/themes/zafta/static/ to /Users/quoha/Sites/zafta/public/
INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/
WARN: 2014/09/29 Unable to locate layout: [404.html theme/404.html]
-0 draft content
-0 future content
-0 pages created
+0 draft content
+0 future content
+0 pages created
0 tags created
0 categories created
in 2 ms
@@ -468,9 +468,9 @@ INFO: 2014/09/29 File System Event: ["/Users/quoha/Sites/zafta/themes/zafta/layo
Change detected, rebuilding site
WARN: 2014/09/29 Unable to locate layout: [404.html theme/404.html]
-0 draft content
-0 future content
-0 pages created
+0 draft content
+0 future content
+0 pages created
0 tags created
0 categories created
in 1 ms
@@ -492,12 +492,12 @@ Right now, that page is empty because we don't have any content and we don't hav
```
$ vi themes/zafta/layouts/index.html
-<!DOCTYPE html>
-<html>
-<body>
- <p>hugo says hello!</p>
-</body>
-</html>
+<!DOCTYPE html>
+<html>
+<body>
+ <p>hugo says hello!</p>
+</body>
+</html>
:wq
$
@@ -511,9 +511,9 @@ INFO: 2014/09/29 Using config file: /Users/quoha/Sites/zafta/config.toml
INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/themes/zafta/static/ to /Users/quoha/Sites/zafta/public/
INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/
WARN: 2014/09/29 Unable to locate layout: [404.html theme/404.html]
-0 draft content
-0 future content
-0 pages created
+0 draft content
+0 future content
+0 pages created
0 tags created
0 categories created
in 2 ms
@@ -521,11 +521,11 @@ in 2 ms
$ find public -type f -name '*.html' | xargs ls -l
-rw-r--r-- 1 quoha staff 78 Sep 29 21:26 public/index.html
-$ cat public/index.html
-<!DOCTYPE html>
-<html>
-<body>
- <p>hugo says hello!</p>
+$ cat public/index.html
+<!DOCTYPE html>
+<html>
+<body>
+ <p>hugo says hello!</p>
</html>
```
@@ -534,15 +534,15 @@ $ cat public/index.html
Note: If you're running the server with the `--watch` option, you'll see different content in the file:
```
-$ cat public/index.html
-<!DOCTYPE html>
-<html>
-<body>
- <p>hugo says hello!</p>
-<script>document.write('<script src="http://'
- + (location.host || 'localhost').split(':')[0]
- + ':1313/livereload.js?mindelay=10"></'
- + 'script>')</script></body>
+$ cat public/index.html
+<!DOCTYPE html>
+<html>
+<body>
+ <p>hugo says hello!</p>
+<script>document.write('<script src="http://'
+ + (location.host || 'localhost').split(':')[0]
+ + ':1313/livereload.js?mindelay=10"></'
+ + 'script>')</script></body>
</html>
```
@@ -565,7 +565,7 @@ INFO: 2014/09/29 attempting to create post/first.md of post
INFO: 2014/09/29 curpath: /Users/quoha/Sites/zafta/themes/zafta/archetypes/default.md
ERROR: 2014/09/29 Unable to Cast <nil> to map[string]interface{}
-$
+$
```
That wasn't very nice, was it?
@@ -604,7 +604,7 @@ total 16
-rw-r--r-- 1 quoha staff 104 Sep 29 21:54 first.md
-rw-r--r-- 1 quoha staff 105 Sep 29 21:57 second.md
-$ cat content/post/first.md
+$ cat content/post/first.md
+++
Categories = []
Description = ""
@@ -615,7 +615,7 @@ title = "first"
+++
my first post
-$ cat content/post/second.md
+$ cat content/post/second.md
+++
Categories = []
Description = ""
@@ -626,7 +626,7 @@ title = "second"
+++
my second post
-$
+$
```
Build the web site and then verify the results.
@@ -639,9 +639,9 @@ INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/themes/zafta/static/ to /
INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/
INFO: 2014/09/29 found taxonomies: map[string]string{"category":"categories", "tag":"tags"}
WARN: 2014/09/29 Unable to locate layout: [404.html theme/404.html]
-0 draft content
-0 future content
-2 pages created
+0 draft content
+0 future content
+2 pages created
0 tags created
0 categories created
in 4 ms
@@ -674,7 +674,7 @@ There are three other types of templates: partials, content views, and terms. We
The home page will contain a list of posts. Let's update its template to add the posts that we just created. The logic in the template will run every time we build the site.
```
-$ vi themes/zafta/layouts/index.html
+$ vi themes/zafta/layouts/index.html
<!DOCTYPE html>
<html>
<body>
@@ -712,26 +712,26 @@ INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/themes/zafta/static/ to /
INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/
INFO: 2014/09/29 found taxonomies: map[string]string{"tag":"tags", "category":"categories"}
WARN: 2014/09/29 Unable to locate layout: [404.html theme/404.html]
-0 draft content
-0 future content
-2 pages created
+0 draft content
+0 future content
+2 pages created
0 tags created
0 categories created
in 4 ms
-$ find public -type f -name '*.html' | xargs ls -l
+$ find public -type f -name '*.html' | xargs ls -l
-rw-r--r-- 1 quoha staff 94 Sep 29 22:23 public/index.html
-rw-r--r-- 1 quoha staff 0 Sep 29 22:23 public/post/first/index.html
-rw-r--r-- 1 quoha staff 0 Sep 29 22:23 public/post/index.html
-rw-r--r-- 1 quoha staff 0 Sep 29 22:23 public/post/second/index.html
-$ cat public/index.html
+$ cat public/index.html
<!DOCTYPE html>
<html>
<body>
-
+
<h1>second</h1>
-
+
<h1>first</h1>
-
+
</body>
</html>
$
@@ -763,7 +763,7 @@ Please see the Hugo documentation on template rendering for all the details on d
#### Update the Template File
```
-$ vi themes/zafta/layouts/_default/single.html
+$ vi themes/zafta/layouts/_default/single.html
<!DOCTYPE html>
<html>
<head>
@@ -789,9 +789,9 @@ INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/themes/zafta/static/ to /
INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/
INFO: 2014/09/29 found taxonomies: map[string]string{"tag":"tags", "category":"categories"}
WARN: 2014/09/29 Unable to locate layout: [404.html theme/404.html]
-0 draft content
-0 future content
-2 pages created
+0 draft content
+0 future content
+2 pages created
0 tags created
0 categories created
in 4 ms
@@ -802,7 +802,7 @@ $ find public -type f -name '*.html' | xargs ls -l
-rw-r--r-- 1 quoha staff 0 Sep 29 22:40 public/post/index.html
-rw-r--r-- 1 quoha staff 128 Sep 29 22:40 public/post/second/index.html
-$ cat public/post/first/index.html
+$ cat public/post/first/index.html
<!DOCTYPE html>
<html>
<head>
@@ -815,7 +815,7 @@ $ cat public/post/first/index.html
</body>
</html>
-$ cat public/post/second/index.html
+$ cat public/post/second/index.html
<!DOCTYPE html>
<html>
<head>
@@ -858,9 +858,9 @@ INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/themes/zafta/static/ to /
INFO: 2014/09/29 syncing from /Users/quoha/Sites/zafta/static/ to /Users/quoha/Sites/zafta/public/
INFO: 2014/09/29 found taxonomies: map[string]string{"tag":"tags", "category":"categories"}
WARN: 2014/09/29 Unable to locate layout: [404.html theme/404.html]
-0 draft content
-0 future content
-2 pages created
+0 draft content
+0 future content
+2 pages created
0 tags created
0 categories created
in 4 ms
@@ -871,15 +871,15 @@ $ find public -type f -name '*.html' | xargs ls -l
-rw-r--r-- 1 quoha staff 0 Sep 29 22:44 public/post/index.html
-rw-r--r-- 1 quoha staff 128 Sep 29 22:44 public/post/second/index.html
-$ cat public/index.html
+$ cat public/index.html
<!DOCTYPE html>
<html>
<body>
-
+
<h1><a href="/post/second/">second</a></h1>
-
+
<h1><a href="/post/first/">first</a></h1>
-
+
</body>
</html>
@@ -906,7 +906,7 @@ Let's add an "about" page and display it at the top level (as opposed to a sub-l
The default in Hugo is to use the directory structure of the content/ directory to guide the location of the generated html in the public/ directory. Let's verify that by creating an "about" page at the top level:
```
-$ vi content/about.md
+$ vi content/about.md
+++
title = "about"
description = "about this site"
diff --git a/exampleSite/content/post/goisforlovers.md b/exampleSite/content/post/goisforlovers.md
index 8065477..103d282 100644
--- a/exampleSite/content/post/goisforlovers.md
+++ b/exampleSite/content/post/goisforlovers.md
@@ -39,7 +39,7 @@ details can be found in the [go docs][gohtmltemplate].
## Basic Syntax
Go lang templates are html files with the addition of variables and
-functions.
+functions.
**Go variables and functions are accessible within {{ }}**
@@ -111,7 +111,7 @@ the /layout/ directory within Hugo.
Go templates provide the most basic iteration and conditional logic.
-### Iteration
+### Iteration
Just like in go, the go templates make heavy use of range to iterate over
a map, array or slice. The following are different examples of how to use
@@ -119,42 +119,42 @@ range.
**Example 1: Using Context**
- {{ range array }}
+ {{ range array }}
{{ . }}
{{ end }}
**Example 2: Declaring value variable name**
- {{range $element := array}}
- {{ $element }}
+ {{range $element := array}}
+ {{ $element }}
{{ end }}
**Example 2: Declaring key and value variable name**
{{range $index, $element := array}}
- {{ $index }}
- {{ $element }}
+ {{ $index }}
+ {{ $element }}
{{ end }}
-### Conditionals
+### Conditionals
If, else, with, or, & and provide the framework for handling conditional
logic in Go Templates. Like range, each statement is closed with `end`.
-Go Templates treat the following values as false:
+Go Templates treat the following values as false:
* false
-* 0
+* 0
* any array, slice, map, or string of length zero
**Example 1: If**
{{ if isset .Params "title" }}<h4>{{ index .Params "title" }}</h4>{{ end }}
-**Example 2: If -> Else**
+**Example 2: If -> Else**
- {{ if isset .Params "alt" }}
+ {{ if isset .Params "alt" }}
{{ index .Params "alt" }}
{{else}}
{{ index .Params "caption" }}
@@ -174,9 +174,9 @@ The first example above could be simplified as:
{{ with .Params.title }}<h4>{{ . }}</h4>{{ end }}
-**Example 5: If -> Else If**
+**Example 5: If -> Else If**
- {{ if isset .Params "alt" }}
+ {{ if isset .Params "alt" }}
{{ index .Params "alt" }}
{{ else if isset .Params "caption" }}
{{ index .Params "caption" }}
@@ -187,12 +187,12 @@ The first example above could be simplified as:
One of the most powerful components of go templates is the ability to
stack actions one after another. This is done by using pipes. Borrowed
from unix pipes, the concept is simple, each pipeline's output becomes the
-input of the following pipe.
+input of the following pipe.
Because of the very simple syntax of go templates, the pipe is essential
to being able to chain together function calls. One limitation of the
pipes is that they only can work with a single value and that value
-becomes the last parameter of the next pipeline.
+becomes the last parameter of the next pipeline.
A few simple examples should help convey how to use the pipe.
@@ -200,7 +200,7 @@ A few simple examples should help convey how to use the pipe.
{{ if eq 1 1 }} Same {{ end }}
-is the same as
+is the same as
{{ eq 1 1 | if }} Same {{ end }}
@@ -219,10 +219,10 @@ Access the page parameter called "disqus_url" and escape the HTML.
Stuff Here
{{ end }}
-Could be rewritten as
+Could be rewritten as
{{ isset .Params "caption" | or isset .Params "title" | or isset .Params "attr" | if }}
- Stuff Here
+ Stuff Here
{{ end }}
@@ -247,24 +247,24 @@ Notice how once we have entered the loop the value of {{ . }} has changed. We
have defined a variable outside of the loop so we have access to it from within
the loop.
-# Hugo Parameters
+# Hugo Parameters
Hugo provides the option of passing values to the template language
through the site configuration (for sitewide values), or through the meta
data of each specific piece of content. You can define any values of any
type (supported by your front matter/config format) and use them however
-you want to inside of your templates.
+you want to inside of your templates.
-## Using Content (page) Parameters
+## Using Content (page) Parameters
In each piece of content you can provide variables to be used by the
-templates. This happens in the [front matter](/content/front-matter).
+templates. This happens in the [front matter](/content/front-matter).
An example of this is used in this documentation site. Most of the pages
benefit from having the table of contents provided. Sometimes the TOC just
doesn't make a lot of sense. We've defined a variable in our front matter
-of some pages to turn off the TOC from being displayed.
+of some pages to turn off the TOC from being displayed.
Here is the example front matter: