UCOMmandIt
/
uci-doc
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

fix spelling and pass spellchecking

master
Robert Kaussow 2020-05-31 18:17:32 +02:00
parent f07cb738b1
commit 3959b13cd8
15 changed files with 97 additions and 75 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
exampleSite/content/_index.md
View File

@ -11,8 +11,8 @@ Geekdoc is a simple Hugo theme for documentations. This work is inspired and par
## Features ## Features
- Clean simple design - Clean and simple design
- Light and mobile-friendly - Light and mobile-friendly
- Customisable - Easy customization
- Zero initial configuration - Zero initial configuration
- Handy shortcodes - Handy shortcodes

4
exampleSite/content/posts/hello_geekdoc.md
View File

@ -6,4 +6,6 @@ date: 2020-01-06
This is the first release of the Geekdoc theme. This is the first release of the Geekdoc theme.
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. 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.
Amalia id per in minimum facility, quid facet modifier ea ma. Ill um select ma ad, en ferric patine sentient vim. Per expendable foreordained interpretations cu, maxim sole pertinacity in ram. Que no rota alters, ad sea sues exercise main rum, cu diam mas facility sea.

2
exampleSite/content/posts/initial_release.md
View File

@ -6,4 +6,4 @@ date: 2020-01-08
This is the first release of the Geekdoc theme. This is the first release of the Geekdoc theme.
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. 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.

33
exampleSite/content/shortcodes/columns.md
View File

@ -1,43 +1,46 @@
Columns help organize shorter pieces of content horizontally for readability. Columns help organize shorter pieces of content horizontally for readability.
```html ```html
{{</* columns */>}} <!-- begin columns block --> {{</* columns */>}} <!-- begin columns block -->
# Left Content # Left Content
Lorem markdownum insigne... Dolor sit, sumo unique argument um no ...
<---> <!-- magic sparator, between columns --> <---> <!-- magic sparator, between columns -->
# Mid Content # Mid Content
Lorem markdownum insigne... Dolor sit, sumo unique argument um no ...
<---> <!-- magic sparator, between columns --> <---> <!-- magic sparator, between columns -->
# Right Content # Right Content
Lorem markdownum insigne... Dolor sit, sumo unique argument um no ...
{{</* /columns */>}} {{</* /columns */>}}
``` ```
## Example ## Example
{{< columns >}} {{< columns >}}
## Left Content
Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat ## Left
stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa
protulit, sed sed aere valvis inhaesuro Pallas animam: qui _quid_, ignes. Dolor sit, sumo unique argument um no. Gracie nominal id xiv. Romanesque acclimates
Miseratus fonte Ditis conubia. 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.
<---> <--->
## Mid Content ## Mid Content
Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat
stringit, frustra Saturnius uteroque inter! 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.
<---> <--->
## Right Content ## Right Content
Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat
stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa Dolor sit, sumo unique argument um no. Gracie nominal id xiv. Romanesque acclimates
protulit, sed sed aere valvis inhaesuro Pallas animam: qui _quid_, ignes. investiture. Ornateness bland it ex enc, est yeti am bongo detract re. Pro ad prompts
Miseratus fonte Ditis conubia. feud gait, quid exercise emeritus bis e. In pro quints consequent, denim fastidious
copious quo ad. Stet probates in duo.
{{< /columns >}} {{< /columns >}}

21
exampleSite/content/shortcodes/expand.md
View File

@ -1,18 +1,21 @@
Expand shortcode can help to decrease clutter on screen by hiding part of text. Expand content by clicking on it. Expand shortcode can help to decrease clutter on screen by hiding part of text. Expand content by clicking on it.
## Example ## Example
### Default ### Default
```tpl ```tpl
{{</* expand */>}} {{</* expand */>}}
## Markdown content ## Markdown content
Lorem markdownum insigne... Dolor sit, sumo unique ...
{{</* /expand */>}} {{</* /expand */>}}
``` ```
{{< expand >}} {{< expand >}}
## Markdown content ## Markdown content
Lorem markdownum insigne...
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.
{{< /expand >}} {{< /expand >}}
### With Custom Label ### With Custom Label
@ -20,14 +23,16 @@ Lorem markdownum insigne...
```tpl ```tpl
{{</* expand "Custom Label" "..." */>}} {{</* expand "Custom Label" "..." */>}}
## Markdown content ## Markdown content
Lorem markdownum insigne... Dolor sit, sumo unique ...
{{</* /expand */>}} {{</* /expand */>}}
``` ```
{{< expand "Custom Label" "..." >}} {{< expand "Custom Label" "..." >}}
## Markdown content
Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat ## More markdown
stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa
protulit, sed sed aere valvis inhaesuro Pallas animam: qui _quid_, ignes. Dolor sit, sumo unique argument um no. Gracie nominal id xiv. Romanesque acclimates
Miseratus fonte Ditis conubia. 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.
{{< /expand >}} {{< /expand >}}

16
exampleSite/content/shortcodes/hints.md
View File

@ -4,8 +4,8 @@ There are 3 colors to choose: `info`, `warning` and `danger`.
```tpl ```tpl
{{</* hint [info|warning|danger] */>}} {{</* hint [info|warning|danger] */>}}
**Markdown content**\ **Markdown content**\
Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat Dolor sit, sumo unique argument um no. Gracie nominal id xiv. Romanesque acclimates investiture.
stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa Ornateness bland it ex enc, est yeti am bongo detract re.
{{</* /hint */>}} {{</* /hint */>}}
``` ```
@ -13,18 +13,18 @@ stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa
{{< hint info >}} {{< hint info >}}
**Markdown content**\ **Markdown content**\
Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat Dolor sit, sumo unique argument um no. Gracie nominal id xiv. Romanesque acclimates investiture.
stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa Ornateness bland it ex enc, est yeti am bongo detract re.
{{< /hint >}} {{< /hint >}}
{{< hint warning >}} {{< hint warning >}}
**Markdown content**\ **Markdown content**\
Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat Dolor sit, sumo unique argument um no. Gracie nominal id xiv. Romanesque acclimates investiture.
stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa Ornateness bland it ex enc, est yeti am bongo detract re.
{{< /hint >}} {{< /hint >}}
{{< hint danger >}} {{< hint danger >}}
**Markdown content**\ **Markdown content**\
Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat Dolor sit, sumo unique argument um no. Gracie nominal id xiv. Romanesque acclimates investiture.
stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa Ornateness bland it ex enc, est yeti am bongo detract re.
{{< /hint >}} {{< /hint >}}

16
exampleSite/content/shortcodes/includes.md
View File

@ -1,4 +1,4 @@
Include Shortcode can include files of different types. By specifying a language, the included file will have syntax highlighting. Include shortcode can include files of different types. By specifying a language, the included file will have syntax highlighting.
## Shortcode ## Shortcode
@ -15,7 +15,7 @@ Attributes:
| markdown | included file is markdown | false | | markdown | included file is markdown | false |
| options | highlighting [options](https://gohugo.io/content-management/syntax-highlighting/#highlight-shortcode) | linenos=table | | options | highlighting [options](https://gohugo.io/content-management/syntax-highlighting/#highlight-shortcode) | linenos=table |
\* if not set, the content will be rendered as plain html \* if not set, the content will be rendered as plain HTML
### Include *.yml file with options ### Include *.yml file with options
@ -31,21 +31,21 @@ Included markdown files will be rendered using the `markdownify` filter.
{{< hint warning >}} {{< hint warning >}}
**Location of markdown files**\ **Location of markdown files**\
If you include markdown files that should not get a menu entry, place them outside the content folder or exlude them otherwise. If you include markdown files that should not get a menu entry, place them outside the content folder or exclude them otherwise.
{{< /hint >}} {{< /hint >}}
```tpl ```tpl
{{</* include file="static/table.md" markdown="true" */>}} {{</* include file="static/includes/table.md.part" markdown="true" */>}}
``` ```
{{< include file="static/table.md" markdown="true" >}} {{< include file="static/includes/table.md.part" markdown="true" >}}
### Include *.html file ### Include *.html file
Html content will be filtered by the `safeHTML` filter and added to the rendered page output. HTML content will be filtered by the `safeHTML` filter and added to the rendered page output.
```tpl ```tpl
{{</* include file="static/example.html" */>}} {{</* include file="static/includes/example.html.part" */>}}
``` ```
{{< include file="static/example.html" >}} {{< include file="static/includes/example.html.part" >}}

3
exampleSite/content/shortcodes/mermaid.md
View File

@ -1,8 +1,9 @@
[Mermaid](https://mermaidjs.github.io/) is library for generating svg charts and diagrams from text. [Mermaid](https://mermaidjs.github.io/) is library for generating SVG charts and diagrams from text.
## Example ## Example
{{< columns >}} {{< columns >}}
```tpl ```tpl
{{</* mermaid class="text-center"*/>}} {{</* mermaid class="text-center"*/>}}
sequenceDiagram sequenceDiagram

32
exampleSite/content/shortcodes/tabs.md
View File

@ -2,7 +2,7 @@ Tabs let you organize content by context, for example installation instructions
```tpl ```tpl
{{</* tabs "uniqueid" */>}} {{</* tabs "uniqueid" */>}}
{{</* tab "MacOS" */>}} # MacOS Content {{</* /tab */>}} {{</* tab "macOS" */>}} # macOS Content {{</* /tab */>}}
{{</* tab "Linux" */>}} # Linux Content {{</* /tab */>}} {{</* tab "Linux" */>}} # Linux Content {{</* /tab */>}}
{{</* tab "Windows" */>}} # Windows Content {{</* /tab */>}} {{</* tab "Windows" */>}} # Windows Content {{</* /tab */>}}
{{</* /tabs */>}} {{</* /tabs */>}}
@ -11,15 +11,16 @@ Tabs let you organize content by context, for example installation instructions
## Example ## Example
{{< tabs "uniqueid" >}} {{< tabs "uniqueid" >}}
{{< tab "MacOS" >}} {{< tab "macOS" >}}
# MacOS
This is tab **MacOS** content. # macOS
Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat This is tab **macOS** content.
stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa
protulit, sed sed aere valvis inhaesuro Pallas animam: qui _quid_, ignes. Dolor sit, sumo unique argument um no. Gracie nominal id xiv. Romanesque acclimates
Miseratus fonte Ditis conubia. 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.
{{< /tab >}} {{< /tab >}}
{{< tab "Linux" >}} {{< tab "Linux" >}}
@ -28,10 +29,10 @@ Miseratus fonte Ditis conubia.
This is tab **Linux** content. This is tab **Linux** content.
Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat Dolor sit, sumo unique argument um no. Gracie nominal id xiv. Romanesque acclimates
stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa investiture. __Ornateness__ bland it ex enc, est yeti am bongo detract re. Pro ad
protulit, sed sed aere valvis inhaesuro Pallas animam: qui _quid_, ignes. prompts feud gait, quid exercise emeritus bis e. In pro quints consequent, denim
Miseratus fonte Ditis conubia. fastidious copious quo ad. Stet probates in duo.
{{< /tab >}} {{< /tab >}}
{{< tab "Windows" >}} {{< tab "Windows" >}}
@ -40,9 +41,8 @@ Miseratus fonte Ditis conubia.
This is tab **Windows** content. This is tab **Windows** content.
Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat Dolor sit, sumo unique argument um no. Gracie nominal id xiv. Romanesque acclimates
stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa investiture. Ornateness bland it ex enc, est yeti am bongo detract re. Pro ad
protulit, sed sed aere valvis inhaesuro Pallas animam: qui _quid_, ignes. prompts feud gait, quid exercise emeritus bis e. In pro quints consequent.
Miseratus fonte Ditis conubia.
{{< /tab >}} {{< /tab >}}
{{< /tabs >}} {{< /tabs >}}

16
exampleSite/content/shortcodes/toc.md
View File

@ -8,30 +8,30 @@ Simple wrapper to generate a page Table of Content from a shortcode.
## Level 1 ## Level 1
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. 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.
## Level 2 ## Level 2
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat. Amalia id per in minimum facility, quid facet modifier ea ma. Ill um select ma ad, en ferric patine sentient vim. Per expendable foreordained interpretations cu, maxim sole pertinacity in ram.
### Level 2.1 ### Level 2.1
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren. Amalia id per in minimum facility, quid facet modifier ea ma. Ill um select ma ad, en ferric patine sentient vim. Per expendable foreordained interpretations cu, maxim sole pertinacity in ram.
#### Level 2.1.1 #### Level 2.1.1
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat. Amalia id per in minimum facility, quid facet modifier ea ma. Ill um select ma ad, en ferric patine sentient vim.
##### Level 2.1.1.1 ##### Level 2.1.1.1
Lorem ipsum dolor sit amet, consetetur sadipscing elitr. In pro quints consequent, denim fastidious copious quo ad.
###### Level 2.1.1.1.1 ###### Level 2.1.1.1.1
Lorem ipsum dolor sit amet, consetetur sadipscing elitr. In pro quints consequent, denim fastidious copious quo ad.
### Level 2.2 ### Level 2.2
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren. 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.
no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Amalia id per in minimum facility, quid facet modifier ea ma. Ill um select ma ad, en ferric patine sentient vim. Per expendable foreordained interpretations cu, maxim sole pertinacity in ram.

4
exampleSite/content/usage/code_blocks.md
View File

@ -1,4 +1,4 @@
There are multiple ways to add code blocks. Most of them works out of the box only the hugo shortcode `<highlight>` need some configuration to work properly. There are multiple ways to add code blocks. Most of them works out of the box only the Hugo shortcode `<highlight>` need some configuration to work properly.
## Inline code ## Inline code
To display an inline shortcode use single quotes: To display an inline shortcode use single quotes:
@ -41,7 +41,7 @@ echo "Hello World"
## Highlight shortcode ## Highlight shortcode
Hugo has a build-in shortcode for syntax highlighting. To work properly with this theme, you have to set following options in your sites config: Hugo has a build-in shortcode for syntax highlighting. To work properly with this theme, you have to set following options in your site configuration:
{{< tabs "uniqueid" >}} {{< tabs "uniqueid" >}}
{{< tab "TOML" >}} {{< tab "TOML" >}}

6
exampleSite/content/usage/color_schemes.md
View File

@ -1,9 +1,9 @@
If you want to customize the color scheme of the theme to give it your individual touch you are just a few lines CSS away. In general, you have to override the defaults, the easiest way to do so is to create a `static/custom.css` file right in your site root. If you want to customize the color scheme of the theme to give it your individual touch you are just a few lines CSS away. In general, you have to override the defaults, the easiest way to do so is to create a `static/custom.css` file right in your site root.
All necessary class names are listed below. If you miss some classes for theming you are very welcome to fill an [Issue](https://github.com/xoxys/hugo-geekdoc/issues). For some inspiration you can have a look at [https://www.color-hex.com/color-palettes/](https://www.color-hex.com/). The following listing use the _HC-primary_ color palette as an example: All necessary class names are listed below. If you miss some classes required for a color scheme you are very welcome to create an [Issue](https://github.com/xoxys/hugo-geekdoc/issues) or Pull Request. For some inspiration you can have a look at [https://www.color-hex.com/color-palettes/](https://www.color-hex.com/). The following listing use the _HC-primary_ color palette as an example:
{{< highlight CSS "linenos=table" >}} {{< highlight CSS "linenos=table" >}}
/* defaut link color */ /* default link color */
a { color: #1c388e; } a { color: #1c388e; }
a:visited { color: #73bfb8 } a:visited { color: #73bfb8 }
@ -31,6 +31,6 @@ a:visited { color: #73bfb8 }
.gdoc-hint.danger { background: #fae1db; border-color: #cf5f46; color: black; } .gdoc-hint.danger { background: #fae1db; border-color: #cf5f46; color: black; }
{{< /highlight >}} {{< /highlight >}}
And that is how the result will looks like. Happy theming! And that is how the result will looks like. Happy customizing!
[![HC-primary Color Scheme](/media/color_scheme_example.png)](/media/color_scheme_example.png) [![HC-primary Color Scheme](/media/color_scheme_example.png)](/media/color_scheme_example.png)

6
exampleSite/static/includes/example.html.part Normal file
View File

@ -0,0 +1,6 @@
<h1>This is heading 1</h1>
<h2>This is heading 2</h2>
<h3>This is heading 3</h3>
<h4>This is heading 4</h4>
<h5>This is heading 5</h5>
<h6>This is heading 6</h6>

5
exampleSite/static/includes/table.md.part Normal file
View File

@ -0,0 +1,5 @@
#### Test Table
| Head 1 | Head 2 | Head 3 |
|---|---|---|
| 1 | 2 | 3 |