mirror of
https://github.com/thegeeklab/hugo-geekblog.git
synced 2024-11-25 14:30:39 +00:00
add markdown samples
This commit is contained in:
parent
9cb493de55
commit
a0fe4fd2a3
@ -2,3 +2,9 @@
|
|||||||
hugo-book
|
hugo-book
|
||||||
Kaussow
|
Kaussow
|
||||||
DevOps
|
DevOps
|
||||||
|
glyphs
|
||||||
|
Gopherfest
|
||||||
|
[B|b]lockquote[s]*
|
||||||
|
backticks
|
||||||
|
Shortcode[s]*
|
||||||
|
emojify
|
||||||
|
@ -5,7 +5,7 @@ theme: hugo-geekblog
|
|||||||
pygmentsUseClasses: true
|
pygmentsUseClasses: true
|
||||||
pygmentsCodeFences: true
|
pygmentsCodeFences: true
|
||||||
|
|
||||||
paginate: 3
|
paginate: 5
|
||||||
|
|
||||||
# Needed for mermaid/katex shortcodes
|
# Needed for mermaid/katex shortcodes
|
||||||
markup:
|
markup:
|
||||||
|
42
exampleSite/content/posts/emojies.md
Normal file
42
exampleSite/content/posts/emojies.md
Normal file
@ -0,0 +1,42 @@
|
|||||||
|
---
|
||||||
|
title: "Emoji Support"
|
||||||
|
date: 2020-07-13T19:00:00+02:00
|
||||||
|
authors:
|
||||||
|
- john-doe
|
||||||
|
tags:
|
||||||
|
- Documentation
|
||||||
|
---
|
||||||
|
|
||||||
|
Emoji can be enabled in a Hugo project in a number of ways.
|
||||||
|
|
||||||
|
<!--more-->
|
||||||
|
|
||||||
|
The [emojify](https://gohugo.io/functions/emojify/) function can be called directly in templates or [Inline Shortcodes](https://gohugo.io/templates/shortcode-templates/#inline-shortcodes).
|
||||||
|
|
||||||
|
To enable emoji globally, set `enableEmoji` to `true` in your site's [configuration](https://gohugo.io/getting-started/configuration/) and then you can type emoji shorthand codes directly in content files:
|
||||||
|
|
||||||
|
<!-- markdownlint-disable -->
|
||||||
|
<!-- spellchecker-disable -->
|
||||||
|
<p>
|
||||||
|
<span class="nowrap">{{< emojify ":see_no_evil:" >}} <code>:see_no_evil:</code></span>
|
||||||
|
<span class="nowrap">{{< emojify ":hear_no_evil:" >}} <code>:hear_no_evil:</code></span>
|
||||||
|
<span class="nowrap">{{< emojify ":speak_no_evil:" >}} <code>:speak_no_evil:</code></span>
|
||||||
|
</p>
|
||||||
|
<!-- spellchecker-enable -->
|
||||||
|
<!-- markdownlint-restore -->
|
||||||
|
|
||||||
|
The [Emoji cheat sheet](http://www.emoji-cheat-sheet.com/) is a useful reference for emoji shorthand codes.
|
||||||
|
|
||||||
|
{{< hint info >}}
|
||||||
|
**Info**\
|
||||||
|
The above steps enable Unicode Standard emoji characters and sequences in Hugo, however the rendering of these glyphs depends on the browser and the platform. To style the emoji you can either use a third party emoji font or a font stack.
|
||||||
|
{{< /hint >}}
|
||||||
|
|
||||||
|
<!-- spellchecker-disable -->
|
||||||
|
**Example:**
|
||||||
|
{{< highlight html "linenos=table" >}}
|
||||||
|
.emoji {
|
||||||
|
font-family: Apple Color Emoji, Segoe UI Emoji, NotoColorEmoji, Segoe UI Symbol, Android Emoji, EmojiSymbols;
|
||||||
|
}
|
||||||
|
{{< /highlight >}}
|
||||||
|
<!-- spellchecker-enable -->
|
169
exampleSite/content/posts/markdown.md
Normal file
169
exampleSite/content/posts/markdown.md
Normal file
@ -0,0 +1,169 @@
|
|||||||
|
---
|
||||||
|
title: "Markdown syntax"
|
||||||
|
date: 2020-07-13T20:00:00+02:00
|
||||||
|
authors:
|
||||||
|
- john-doe
|
||||||
|
tags:
|
||||||
|
- Documentation
|
||||||
|
---
|
||||||
|
|
||||||
|
This article offers a sample of basic Markdown syntax that can be used in Hugo content files, also it shows whether basic HTML elements are decorated with CSS in a Hugo theme.
|
||||||
|
|
||||||
|
<!--more-->
|
||||||
|
|
||||||
|
## Headings
|
||||||
|
|
||||||
|
The following HTML `<h1>`—`<h6>` elements represent six levels of section headings. `<h1>` is the highest section level while `<h6>` is the lowest.
|
||||||
|
|
||||||
|
<!-- spellchecker-disable -->
|
||||||
|
<!-- markdownlint-disable -->
|
||||||
|
# H1
|
||||||
|
|
||||||
|
## H2
|
||||||
|
|
||||||
|
### H3
|
||||||
|
|
||||||
|
#### H4
|
||||||
|
|
||||||
|
##### H5
|
||||||
|
|
||||||
|
###### H6
|
||||||
|
<!-- markdownlint-restore -->
|
||||||
|
|
||||||
|
## Paragraph
|
||||||
|
|
||||||
|
Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum, voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma dolestendit peritin re plis aut quas inctum laceat est volestemque commosa as cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin porecus evelectur, cum que nis nust voloribus ratem aut omnimi, sitatur? Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad quibus unda veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata tiustia prat.
|
||||||
|
|
||||||
|
Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sapicia is sinveli squiatum, core et que aut hariosam ex eat.
|
||||||
|
<!-- spellchecker-enable -->
|
||||||
|
|
||||||
|
## Blockquotes
|
||||||
|
|
||||||
|
The blockquote element represents content that is quoted from another source, optionally with a citation which must be within a `footer` or `cite` element, and optionally with in-line changes such as annotations and abbreviations.
|
||||||
|
|
||||||
|
### Blockquote without attribution
|
||||||
|
|
||||||
|
<!-- spellchecker-disable -->
|
||||||
|
> Tiam, ad mint andaepu dandae nostion secatur sequo quae.
|
||||||
|
> **Note** that you can use _Markdown syntax_ within a blockquote.
|
||||||
|
<!-- spellchecker-enable -->
|
||||||
|
|
||||||
|
### Blockquote with attribution
|
||||||
|
|
||||||
|
<!-- markdownlint-disable -->
|
||||||
|
> Don't communicate by sharing memory, share memory by communicating.<br>
|
||||||
|
> — <cite>Rob Pike[^1]</cite>
|
||||||
|
> <!-- markdownlint-restore -->
|
||||||
|
|
||||||
|
[^1]: The above quote is excerpted from Rob Pike's [talk](https://www.youtube.com/watch?v=PAAkCSZUG1c) during Gopherfest, November 18, 2015.
|
||||||
|
|
||||||
|
## Tables
|
||||||
|
|
||||||
|
Tables aren't part of the core Markdown spec, but Hugo supports supports them out-of-the-box.
|
||||||
|
|
||||||
|
| Name | Age |
|
||||||
|
| ----- | --- |
|
||||||
|
| Bob | 27 |
|
||||||
|
| Alice | 23 |
|
||||||
|
|
||||||
|
### Inline Markdown within tables
|
||||||
|
|
||||||
|
| Italics | Bold | Code |
|
||||||
|
| --------- | -------- | ------ |
|
||||||
|
| _italics_ | **bold** | `code` |
|
||||||
|
|
||||||
|
## Code Blocks
|
||||||
|
|
||||||
|
### Code block with backticks
|
||||||
|
|
||||||
|
```html
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="en">
|
||||||
|
<head>
|
||||||
|
<meta charset="utf-8" />
|
||||||
|
<title>Example HTML5 Document</title>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<p>Test</p>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Code block indented with four spaces
|
||||||
|
|
||||||
|
<!-- markdownlint-disable -->
|
||||||
|
<!-- spellchecker-disable -->
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en">
|
||||||
|
<head>
|
||||||
|
<meta charset="utf-8">
|
||||||
|
<title>Example HTML5 Document</title>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<p>Test</p>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
|
<!-- spellchecker-enable -->
|
||||||
|
<!-- markdownlint-restore -->
|
||||||
|
|
||||||
|
#### Code block with Hugo's internal highlight Shortcode
|
||||||
|
|
||||||
|
<!-- prettier-ignore-start -->
|
||||||
|
<!-- markdownlint-disable -->
|
||||||
|
<!-- spellchecker-disable -->
|
||||||
|
{{< highlight html "linenos=table" >}}
|
||||||
|
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="en">
|
||||||
|
<head>
|
||||||
|
<meta charset="utf-8">
|
||||||
|
<title>Example HTML5 Document</title>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<p>Test</p>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
|
{{< /highlight >}}
|
||||||
|
<!-- spellchecker-enable -->
|
||||||
|
<!-- markdownlint-restore -->
|
||||||
|
<!-- prettier-ignore-end -->
|
||||||
|
|
||||||
|
## List Types
|
||||||
|
|
||||||
|
### Ordered List
|
||||||
|
|
||||||
|
1. First item
|
||||||
|
2. Second item
|
||||||
|
3. Third item
|
||||||
|
|
||||||
|
### Unordered List
|
||||||
|
|
||||||
|
- List item
|
||||||
|
- Another item
|
||||||
|
- And another item
|
||||||
|
|
||||||
|
### Nested list
|
||||||
|
|
||||||
|
- Fruit
|
||||||
|
- Apple
|
||||||
|
- Orange
|
||||||
|
- Banana
|
||||||
|
- Dairy
|
||||||
|
- Milk
|
||||||
|
- Cheese
|
||||||
|
|
||||||
|
## Other Elements — abbr, sub, sup, kbd, mark
|
||||||
|
|
||||||
|
<!-- spellchecker-disable -->
|
||||||
|
<!-- markdownlint-disable -->
|
||||||
|
<abbr title="Graphics Interchange Format">GIF</abbr> is a bitmap image format.
|
||||||
|
|
||||||
|
H<sub>2</sub>O
|
||||||
|
|
||||||
|
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
|
||||||
|
|
||||||
|
Press <kbd><kbd>CTRL</kbd>+<kbd>ALT</kbd>+<kbd>Delete</kbd></kbd> to end the session.
|
||||||
|
|
||||||
|
Most <mark>salamanders</mark> are nocturnal, and hunt for insects, worms, and other small creatures.
|
||||||
|
<!-- markdownlint-restore -->
|
||||||
|
<!-- spellchecker-enable -->
|
@ -5,7 +5,6 @@ authors:
|
|||||||
- richard-roe
|
- richard-roe
|
||||||
- john-doe
|
- john-doe
|
||||||
tags:
|
tags:
|
||||||
- Opinion
|
|
||||||
- Hardware
|
- Hardware
|
||||||
---
|
---
|
||||||
|
|
||||||
|
@ -1,10 +1,10 @@
|
|||||||
---
|
---
|
||||||
title: "Very short post"
|
title: "Short post"
|
||||||
date: 2020-06-22T20:00:00+02:00
|
date: 2020-06-22T20:00:00+02:00
|
||||||
authors:
|
authors:
|
||||||
- john-doe
|
- john-doe
|
||||||
tags:
|
tags:
|
||||||
- Opinion
|
- Development
|
||||||
---
|
---
|
||||||
|
|
||||||
Dolor sit, sumo unique argument um no. Gracie nominal id xiv. Romanesque acclimates investiture. Ornateness bland it ex enc, est yeti am bongo detract re. Pro ad prompts feud gait, quid exercise emeritus bis e. In pro quints consequent, denim fastidious copious quo ad. Stet probates in duo.
|
Dolor sit, sumo unique argument um no. Gracie nominal id xiv. Romanesque acclimates investiture. Ornateness bland it ex enc, est yeti am bongo detract re. Pro ad prompts feud gait, quid exercise emeritus bis e. In pro quints consequent, denim fastidious copious quo ad. Stet probates in duo.
|
||||||
|
1
layouts/shortcodes/emojify.html
Normal file
1
layouts/shortcodes/emojify.html
Normal file
@ -0,0 +1 @@
|
|||||||
|
<span class="emoji">{{ .Get 0 | emojify }}</span>
|
@ -32,7 +32,7 @@ h3,
|
|||||||
h4,
|
h4,
|
||||||
h5,
|
h5,
|
||||||
h6 {
|
h6 {
|
||||||
font-weight: $body-font-weight;
|
font-weight: 600;
|
||||||
display: flex;
|
display: flex;
|
||||||
align-items: center;
|
align-items: center;
|
||||||
|
|
||||||
@ -45,9 +45,7 @@ h6 {
|
|||||||
h4,
|
h4,
|
||||||
h5,
|
h5,
|
||||||
h6 {
|
h6 {
|
||||||
> code {
|
font-size: 1rem !important;
|
||||||
font-size: 0.8rem !important;
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
a {
|
a {
|
||||||
|
@ -14,32 +14,6 @@
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
h1,
|
|
||||||
h2,
|
|
||||||
h3,
|
|
||||||
h4,
|
|
||||||
h5,
|
|
||||||
h6 {
|
|
||||||
font-weight: normal;
|
|
||||||
line-height: 1em;
|
|
||||||
margin-top: 1.5em;
|
|
||||||
margin-bottom: $padding-16;
|
|
||||||
}
|
|
||||||
|
|
||||||
h4,
|
|
||||||
h5,
|
|
||||||
h6 {
|
|
||||||
font-weight: bolder;
|
|
||||||
}
|
|
||||||
|
|
||||||
h5 {
|
|
||||||
font-size: 0.875em;
|
|
||||||
}
|
|
||||||
|
|
||||||
h6 {
|
|
||||||
font-size: 0.75em;
|
|
||||||
}
|
|
||||||
|
|
||||||
b,
|
b,
|
||||||
optgroup,
|
optgroup,
|
||||||
strong {
|
strong {
|
||||||
@ -123,4 +97,14 @@
|
|||||||
width: 100%;
|
width: 100%;
|
||||||
overflow: auto;
|
overflow: auto;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
mark {
|
||||||
|
background-color: rgba(255, 221, 102, 1);
|
||||||
|
}
|
||||||
|
|
||||||
|
section.footnotes {
|
||||||
|
margin-top: 3rem;
|
||||||
|
color: $gray-600;
|
||||||
|
font-size: 0.9em;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
Loading…
Reference in New Issue
Block a user