@@ -63,7 +63,7 @@ $ hugo server -D --themesDir ../..
63
63
You can now see the example website in your browser and interact with it. Hugo
64
64
will print instructions for what address to use. Usually it is ` http://localhost:1313/ ` .
65
65
66
- # Example site ` config `
66
+ # Example site configuration file
67
67
68
68
Here is a working ` config.yaml ` :
69
69
@@ -110,19 +110,19 @@ paginate = 4
110
110
111
111
| Category | Shortcode | Description |
112
112
| :--- | :--- | :--- |
113
- | ** Contact info** | contact-box | Displays contact info set in params.social |
114
- | | social | Displays contact info set in params.social |
115
- | ** Photo Gallery** | gallery-category | Container for gallery-photo shortcodes |
116
- | | gallery-modal | HTML to allow for full page view of gallery photos |
117
- | | gallery-photo | Include a photo in a gallery |
118
- | | gallery-script | Script to allow for full page view of gallery photos |
119
- | ** General** | image | Image for use in any page. See example in [ How to create a blog] ( #user-content- how-to-create-a-blog ) |
120
- | | video | Similar to an ordinary <video > html tag but with a CSS class to make it look good in posts |
121
- | | rawhtml | For including raw html without the global unsafe option for Goldmark |
122
- | ** Resume** | container | Container for resume shortcodes |
123
- | | resume-entry | One entry in a resume (e.g. a university degree) |
124
- | | resume-section | One section in resume (e.g. "Education") |
125
- | | resume-subcategory | Creates a heading within a section of the resume |
113
+ | ** Contact info** | ` contact-box ` | Displays contact info set in ` params.social ` |
114
+ | | ` social ` | Displays contact info set in ` params.social ` |
115
+ | ** Photo Gallery** | ` gallery-category ` | Container for ` gallery-photo ` shortcodes |
116
+ | | ` gallery-modal ` | HTML to allow for full page view of gallery photos |
117
+ | | ` gallery-photo ` | Include a photo in a gallery |
118
+ | | ` gallery-script ` | Script to allow for full page view of gallery photos |
119
+ | ** General** | ` image ` | Image for use in any page. See example in [ How to create a blog] ( #how-to-create-a-blog ) |
120
+ | | ` video ` | Similar to an ordinary ` <video> ` HTML tag but with a CSS class to make it look good in posts |
121
+ | | ` rawhtml ` | For including raw HTML without the global unsafe option for Goldmark |
122
+ | ** Resume** | ` container ` | Container for resume shortcodes |
123
+ | | ` resume-entry ` | One entry in a resume (e.g. a university degree) |
124
+ | | ` resume-section ` | One section in resume (e.g. "Education") |
125
+ | | ` resume-subcategory ` | Creates a heading within a section of the resume |
126
126
127
127
Most of the shortcodes are explained in more detail in their respective
128
128
sections below. I explain the other two here.
@@ -133,8 +133,8 @@ sections below. I explain the other two here.
133
133
{{< rawhtml >}}<p>A paragraph</p>{{< /rawhtml >}}
134
134
```
135
135
136
- This allows you to use html to create elements that you can't create
137
- with just markdown without allowing unsafe html in the site ` config ` .
136
+ This allows you to use HTML to create elements that you can't create
137
+ with just markdown without allowing unsafe HTML in the site configuration file .
138
138
I'm not a security expert, and there might be a good reason why unsafe HTML
139
139
is disabled by default. If you think this shortcode shouldn't be part of
140
140
the theme, feel free to open an issue and say why.
@@ -146,8 +146,8 @@ class that I've added some styling for. Use it like this:
146
146
{{< video src=" your_video.mp4" type =" video/mp4" preload=" auto" >}}
147
147
```
148
148
149
- Your video needs to be in the ` static ` folder or a subfolder of it such
150
- as "video" (in which case you'd add the subfolder in the ` src `
149
+ Your video needs to be in the ` static ` folder or a subdirectory of it such
150
+ as "video" (in which case you'd add the subdirectory in the ` src `
151
151
parameter.
152
152
153
153
## User CSS
@@ -170,7 +170,7 @@ menu:
170
170
---
171
171
```
172
172
173
- Don't use the site ` config ` to add menus because then the highlighting
173
+ Don't use the site configuration file to add menus because then the highlighting
174
174
of active tabs might not work (at least not if drop-down menus are involved).
175
175
176
176
### How to add a page to drop down menu
@@ -180,9 +180,9 @@ Quick instruction: Set it's `parent` parameter to one of the menus in
180
180
181
181
Instructions with example:
182
182
183
- 1 . Create the top-level menu in config.yaml or your equivalent. An
183
+ 1 . Create the top-level menu in ` config.yaml ` or your equivalent. An
184
184
example where the top-level menu doesn't correspond to a real page
185
- (url is #) and is just there to hold the drop-down menu:
185
+ (` url ` is #) and is just there to hold the drop-down menu:
186
186
187
187
``` yaml
188
188
menu :
@@ -237,9 +237,9 @@ params:
237
237
` ` `
238
238
239
239
If you don't want to show the latest posts from your blog at the bottom
240
- of the home page, set `showBlogLatest` to false in your site `config` .
240
+ of the home page, set `showBlogLatest` to false in your site configuration file .
241
241
You may also want to change the number of posts shown (default : 3) and
242
- the heading above it (default "Latest from the blog") In config.yaml, it
242
+ the heading above it (default "Latest from the blog") In ` config.yaml` , it
243
243
would look like this :
244
244
245
245
` ` ` yaml
@@ -294,7 +294,7 @@ populate the top of the homepage, like in the Hugo Basic Example.
294
294
For those of you who do the third step, there is an option available to
295
295
remove the buttons with links to the archive (if you have an archives
296
296
page, see step 3), tags and category pages from the top of the blog list
297
- page. Just set the following in your site `config` :
297
+ page. Just set the following in your site configuration file :
298
298
299
299
` ` ` yaml
300
300
params:
@@ -317,13 +317,13 @@ on that category or tag in any post instead, and you can link to
317
317
You can add images just as for the home page. Available options are those of the
318
318
built in `figure` shortcode of Hugo, and additionally :
319
319
320
- | Parameter name | Allowed Values |
321
- | :--- | :--- |
322
- | `float` | right/left |
323
- | `frame` | true/false/leave out |
324
- | `wide` | true/false |
325
- | `width` | e.g. 10em, 50%, 70px |
326
- | `height` | e.g. 10em, 50%, 70px |
320
+ | Parameter name | Allowed Values |
321
+ | :--- | :--- |
322
+ | `float` | right/left |
323
+ | `frame` | true/false/leave out |
324
+ | `wide` | true/false |
325
+ | `width` | e.g. ` 10em`, ` 50%`, ` 70px` |
326
+ | `height` | e.g. ` 10em`, ` 50%`, ` 70px` |
327
327
328
328
A difference from the built in shortcode is that width and height are for the
329
329
outer `<figure>` element. This allows text to wrap around the picture if you set
@@ -341,7 +341,7 @@ can enable it if you want.
341
341
342
342
Disqus is implemented the [default Hugo
343
343
way](https://gohugo.io/content-management/comments/#add-disqus) so just
344
- add your Disqus Shortname in the site `config` and all blog posts will
344
+ add your Disqus Shortname in the site configuration file and all blog posts will
345
345
have a comments section.
346
346
347
347
# # How to create a gallery
@@ -379,7 +379,7 @@ And place corresponding full-size images under `static/img/fullsize`.
379
379
The file names need to be the same as for the thumbnails.
380
380
381
381
Thumbnails should of course be small so that your page loads fast and
382
- fullsize should be large enough that they don't look pixelated when
382
+ full-size should be large enough that they don't look pixelated when
383
383
covering the full space of a web browser. One way to resize images is
384
384
with (graphicsmagick)[http://www.graphicsmagick.org/] : ` gm mogrify
385
385
-resize 1920x1920 *.jpg` , which will resize all images in the current
@@ -449,8 +449,8 @@ links to your social media or other contact info on the rights side of the page,
449
449
want, some text on the left side of the box, outside the frame. Put this
450
450
text within the shortcode tags.
451
451
452
- You decide what social media to include in your site `config` under
453
- social under params, like this :
452
+ You decide what social media to include in your site configuration file under
453
+ ` social` under ` params` , like this :
454
454
455
455
` ` ` yaml
456
456
params:
@@ -476,7 +476,7 @@ parameters defaults to floating to the right, the width defaults to
476
476
477
477
# How to set a footer
478
478
479
- If you want to add a footer to your webpage , you can use the `footer`
479
+ If you want to add a footer to your web page , you can use the `footer`
480
480
key in your configuration, e.g :
481
481
482
482
` ` ` yaml
@@ -495,9 +495,9 @@ included in the theme files, so you'll homepage will serve the
495
495
resources.
496
496
497
497
Some of the fonts under `static/fonts` are parts of the project [GNU
498
- FreeFont](https://www.gnu.org/software/freefont/). They are licenced
498
+ FreeFont](https://www.gnu.org/software/freefont/). They are licensed
499
499
under "GPLv3 or later". Licenses are also supposed to be included in the
500
- .woff files themselves. Some of the fonts are edited by me to take up
500
+ ` .woff` files themselves. Some of the fonts are edited by me to take up
501
501
less space by including fewer characters.
502
502
503
503
The monospace font in the same directory, used for code in the theme, is
@@ -507,9 +507,9 @@ SIL OFL 1.1
507
507
508
508
The icons used for the `contact-box` and `social` shortcodes are from
509
509
[Font Awesome](https://github.com/FortAwesome/Font-Awesome) project.
510
- It's licence is SIL OFL 1.1
510
+ It's license is SIL OFL 1.1
511
511
([https://scripts.sil.org/OFL](https://scripts.sil.org/OFL)). A HTML
512
- comment is included in the contact-box shortcode to show the licence and
512
+ comment is included in the contact-box shortcode to show the license and
513
513
source.
514
514
515
515
For matching the icons from Font Awesome with names for various social
0 commit comments