Jasność Myślenia (A la luz de pensar)

Mon, 01 Jan 0001 00:00:00 +0000

Asciinema#

Asciinema shortcode integrates asciinema player into the markdown page.

{{< asciinema
 cast="asciinema-627097.cast"
 or
 cast="https://asciinema.org/a/vJNKUQFjuh7qKI2j3OoaKs8Jk.cast"
 loop=true
 autoplay=true
 speed=2 >}}

Parameters#

All parameters added to the shortcode will be transformed to options for Asciinema player, expect cast parameter that is used to locate cast file. Cast file follows same rules as portable image, it could be site resource, page resource or remote file URL.

List of Asciinema options

Mon, 01 Jan 0001 00:00:00 +0000

Buttons#

Buttons are styled links that can lead to local page or external link.

Example#

{{< button relref="/" [class="..."] >}}Get Home{{< /button >}}
{{< button href="https://github.com/alex-shpak/hugo-book" >}}Contribute{{< /button >}}

Get Home Contribute

Mon, 01 Jan 0001 00:00:00 +0000

Columns#

Columns help organize shorter pieces of content horizontally for readability. columns shortcode styles markdown list as up to 3 columns.

Example#

{{% columns [ratio="1:1"] [class="..."] %}}
- ### Left Content
 Lorem markdownum insigne...

- ### Mid Content
 Lorem markdownum insigne...

- ### Right Content
 Lorem markdownum insigne...
{{% /columns %}}

Left Content#

Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa protulit, sed sed aere valvis inhaesuro Pallas animam: qui quid, ignes. Miseratus fonte Ditis conubia.

Mon, 01 Jan 0001 00:00:00 +0000

Details#

Details shortcode is a helper for details html5 element. To collapse the details either omit the open keyword when using positional arguments or set open=false when using parameters.

Example with positional arguments#

{{% details "Title" [open] %}}
## Markdown content
Lorem markdownum insigne...
{{% /details %}}

Markdown content#

Lorem markdownum insigne…

Example with parameters#

{{% details title="Title" open=true %}}
## Markdown content
Lorem markdownum insigne...
{{% /details %}}

Markdown content#

Lorem markdownum insigne…

Mon, 01 Jan 0001 00:00:00 +0000

Hints#

Hint shortcode can be used as a hint/alert/notification block.

{{% hint [info|success|warning|danger] %}}
**Markdown content** 
Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat
stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa
{{% /hint %}}

> [!NOTE|TIP|IMPORTANT|WARNING|CAUTION]
> **Markdown content** 
> Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat
> stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa

Example#

Markdown content
Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa

Mon, 01 Jan 0001 00:00:00 +0000

Mermaid Chart#

MermaidJS is library for generating svg charts and diagrams from text.

Override Mermaid initialization config
To override the initialization config for Mermaid, create a mermaid.json file in your assets folder!

Example#

```mermaid
stateDiagram-v2
 State1: The state with a note
 note right of State1
 Important information! You can write
 notes.
 end note
 State1 --> State2
 note left of State2 : This is the note to the left.
```

stateDiagram-v2
 State1: The state with a note
 note right of State1
 Important information! You can write
 notes.
 end note
 State1 --> State2
 note left of State2 : This is the note to the left.

{{< mermaid [class="..."] >}}
stateDiagram-v2
 State1: The state with a note
 note right of State1
 Important information! You can write
 notes.
 end note
 State1 --> State2
 note left of State2 : This is the note to the left.
{{< /mermaid >}}

Diagrams#

Explore more diagrams and syntax on Mermaid documentation page.

Mon, 01 Jan 0001 00:00:00 +0000

Steps#

Steps shortcode styles numbered list as series of points for better content organization.

{{% steps %}}
1. ## Suspendisse sed congue orci.
 ...

2. ## Maecenas scelerisque sem.
 ...

3. ## Etiam risus purus.
 ...

4. ## Curabitur sed lacinia velit.
 ...
{{% /steps %}}

Example#

Suspendisse sed congue orci.#

Suspendisse sed congue orci, eu congue metus. Nullam feugiat urna massa, et fringilla metus consectetur molestie. Curabitur pellentesque sodales ipsum, sed efficitur libero euismod ac. Donec sit amet erat nunc. Suspendisse porta nisl velit, quis auctor massa commodo nec. Donec sollicitudin tellus sit amet massa condimentum luctus. Etiam molestie at ante et convallis.

Mon, 01 Jan 0001 00:00:00 +0000

Tabs#

Tabs let you organize content by context, for example installation instructions for each supported platform.

{{< tabs >}}
{{% tab "MacOS" %}} # MacOS Content {{% /tab %}}
{{% tab "Linux" %}} # Linux Content {{% /tab %}}
{{% tab "Windows" %}} # Windows Content {{% /tab %}}
{{< /tabs >}}

Example#

MacOS

MacOS#

This is tab MacOS content.

Lorem markdownum insigne. Olympo signis Delphis! Retexi Nereius nova develat stringit, frustra Saturnius uteroque inter! Oculis non ritibus Telethusa protulit, sed sed aere valvis inhaesuro Pallas animam: qui quid, ignes. Miseratus fonte Ditis conubia.

Mon, 01 Jan 0001 00:00:00 +0000

Asciinema#
Badge#

TitleValue
Button#

<a class=“book-btn"href=”/">A Button
Card#

Markdown
Suspendisse sed congue orci, eu congue metus. Nullam feugiat urna massa.
Details#

Markdown content#

Lorem markdownum insigne…

KaTeX

Mon, 01 Jan 0001 00:00:00 +0000

KaTeX#

KaTeX shortcode let you render math typesetting in markdown document. See KaTeX

Override KaTeX initialization config
To override the initialization config for KaTeX, create a katex.json file in your assets folder!

Example#

Activation#

KaTeX is activated on the page by first use of the shortcode or render block. you can force activation with empty {{< katex />}} and use delimiters defined in configuration in assets/katex.json.

Jasność Myślenia (A la luz de pensar)

Asciinema#

Parameters#

Buttons#

Example#

Columns#

Example#

Left Content#

Details#

Example with positional arguments#

Markdown content#

Example with parameters#

Markdown content#

Hints#

Example#

Mermaid Chart#

Example#

Diagrams#

Steps#

Example#

Suspendisse sed congue orci.#

Tabs#

Example#

MacOS#

Asciinema#

Badge#

Button#

Card#

Details#

Markdown content#

KaTeX

KaTeX#

Example#

Activation#