hugo-theme-relearn/shortcodes/index.xml
2021-10-16 23:42:34 +00:00

22 lines
No EOL
7.6 KiB
XML

<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Shortcodes on Documentation for Hugo Relearn Theme</title><link>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/</link><description>Recent content in Shortcodes on Documentation for Hugo Relearn Theme</description><generator>Hugo -- gohugo.io</generator><language>en</language><atom:link href="https://mcshelby.github.io/hugo-theme-relearn/shortcodes/index.xml" rel="self" type="application/rss+xml"/><item><title>Children</title><link>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/children/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/children/</guid><description>Use the children shortcode to list the child pages of a page and the further descendants (children&amp;rsquo;s children). By default, the shortcode displays links to the child pages.
Usage Parameter Default Description page current Specify the page name (section name) to display children for containerstyle &amp;ldquo;ul&amp;rdquo; Choose the style used to group all children. It could be any HTML tag name style &amp;ldquo;li&amp;rdquo; Choose the style used to display each descendant.</description></item><item><title>Attachments</title><link>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/attachments/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/attachments/</guid><description>The Attachments shortcode displays a list of files attached to a page.
Attachments adivorciarsetoca00cape.pdf (361 KB) BachGavotteShort.mp3 (357 KB) Carroll_AliceAuPaysDesMerveilles.pdf (175 KB) hugo.png (17 KB) hugo.txt (20 B) movieselectricsheep-flock-244-32500-2.mp4 (340 KB) Usage The shortcurt lists files found in a specific folder. Currently, it support two implementations for pages
If your page is a Markdown file, attachements must be placed in a folder named like your page and ending with .</description></item><item><title>Button</title><link>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/button/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/button/</guid><description>A button is a just a clickable button with optional icon.
{{% button href=&amp;#34;https://gohugo.io/&amp;#34; %}}Get Hugo{{% /button %}} {{% button href=&amp;#34;https://gohugo.io/&amp;#34; icon=&amp;#34;fas fa-download&amp;#34; %}}Get Hugo with icon{{% /button %}} {{% button href=&amp;#34;https://gohugo.io/&amp;#34; icon=&amp;#34;fas fa-download&amp;#34; icon-position=&amp;#34;right&amp;#34; %}}Get Hugo with icon right{{% /button %}} Get Hugo Get Hugo with icon Get Hugo with icon right</description></item><item><title>Expand</title><link>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/expand/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/expand/</guid><description>The Expand shortcode displays an expandable/collapsible section of text on your page.
Usage {{% expand &amp;#34;Does this Relearn theme rock?&amp;#34; { &amp;#34;true&amp;#34; | &amp;#34;false&amp;#34; } %}} Yes! {{% /expand %}} The first optional parameter defines the text that appears next to the expand/collapse icon. The default text is &amp;quot;Expand me...&amp;quot;.
The second optional parameter controls if the block is initially shown as expanded (&amp;quot;true&amp;quot;) or collapsed (&amp;quot;false&amp;quot;). The default ist &amp;quot;false&amp;quot;.</description></item><item><title>Include</title><link>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/include/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/include/</guid><description>The include shortcode includes other files from your project inside of the current file. This can even contain Markdown and will be taken into account when generating the table of contents.
Usage {{% include &amp;#34;&amp;lt;file&amp;gt;&amp;#34; { &amp;#34;true&amp;#34; | &amp;#34;false&amp;#34; } %}} The first parameter is the path to the file to be included.
If the file&amp;rsquo;s content will be displayed as HTML, the second optional parameter controls if the first heading of the included file should be displayed (&amp;ldquo;true&amp;rdquo;)- which is the default - or be hidden.</description></item><item><title>Mermaid</title><link>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/mermaid/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/mermaid/</guid><description>Mermaid is a library helping you to generate diagram and flowcharts from text, in a similar manner as Markdown.
Usage Just insert your Mermaid code in the mermaid shortcode like this:
{{&amp;lt; mermaid [ align=(left|right|center|justify) ] &amp;gt;}} classDiagram Person *-- Dog {{&amp;lt; /mermaid &amp;gt;}} You can set an optional align attribute which defaults to center.
If you don&amp;rsquo;t need alignment you can use the alternative syntax using code fences if you have turned off guessSyntax for the markup.</description></item><item><title>Notice</title><link>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/notice/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/notice/</guid><description>The notice shortcode shows four types of disclaimers to help you structure your page.
Usage {{% notice [ note | info | tip | warning ] %}} Some markup {{% /notice %}} Examples Note NoteA notice disclaimer
You can add:
multiple paragraphs bullet point lists emphasized, bold and even bold emphasized text links other shortcodes besides notice etc. ...and even source code the possiblities are endless
Show markup {{% notice note %}} A **notice** disclaimer You can add: - multiple paragraphs - bullet point lists - _emphasized_, **bold** and even ***bold emphasized*** text - [links](https://example.</description></item><item><title>Site param</title><link>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/siteparam/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/siteparam/</guid><description>siteparam shortcode is used to help you print values of site params.
For instance, in this current site, the editURL variable is used in config.toml
[params] editURL = &amp;#34;https://github.com/McShelby/hugo-theme-relearn/edit/main/exampleSite/content/&amp;#34; Use the siteparam shortcode to display its value.
`editURL` Value : {{% siteparam &amp;#34;editURL&amp;#34; %}} is displayed as
editURL Value : https://github.com/McShelby/hugo-theme-relearn/edit/main/exampleSite/content/</description></item><item><title>Tabbed views</title><link>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/tabs/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://mcshelby.github.io/hugo-theme-relearn/shortcodes/tabs/</guid><description>Choose which content to see across the page. Very handy for providing code snippets for multiple languages or providing configuration in different formats.
Code example {{&amp;lt; tabs &amp;gt;}} {{% tab name=&amp;#34;python&amp;#34; %}} ```python print(&amp;#34;Hello World!&amp;#34;) ``` {{% /tab %}} {{% tab name=&amp;#34;R&amp;#34; %}} ```R &amp;gt; print(&amp;#34;Hello World!&amp;#34;) ``` {{% /tab %}} {{% tab name=&amp;#34;Bash&amp;#34; %}} ```Bash echo &amp;#34;Hello World!&amp;#34; ``` {{% /tab %}} {{&amp;lt; /tabs &amp;gt;}} Renders as:
python R Bash print(&amp;#34;Hello World!</description></item></channel></rss>