mirror of
https://github.com/McShelby/hugo-theme-relearn.git
synced 2024-10-28 11:13:18 +00:00
108 lines
No EOL
8.8 KiB
XML
108 lines
No EOL
8.8 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 Hugo Relearn Theme</title>
|
|
<link>https://McShelby.github.io/hugo-theme-relearn/shortcodes/</link>
|
|
<description>Recent content in Shortcodes on 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&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 &ldquo;ul&rdquo; Choose the style used to group all children. It could be any HTML tag name style &ldquo;li&rdquo; Choose the style used to display each descendant.</description>
|
|
</item>
|
|
<item>
|
|
<title>Swagger</title>
|
|
<link>https://McShelby.github.io/hugo-theme-relearn/shortcodes/swagger/</link>
|
|
<pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
|
|
<guid>https://McShelby.github.io/hugo-theme-relearn/shortcodes/swagger/</guid>
|
|
<description>This shortcode uses the RapiDoc library to display your OpenAPI Specifications.
|
|
Note This only works in modern browsers.
|
|
Configuration Swagger is configured with default settings. You can customize Swagger&rsquo;s default settings for all of your files thru a JSON object in your config.toml or override these settings per page thru your pages frontmatter.
|
|
The JSON object of your config.toml / frontmatter is forwarded into Swagger&rsquo;s initialization. At the moment, only the theme setting is supported.</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 with adjustable color, title and icon.
|
|
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.
|
|
{{% attachments /%}} 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>The button shortcode displays a clickable button with adjustable color, title and icon.
|
|
Get Hugo Get Hugo Get Hugo
|
|
Usage Once the button is clicked, it opens another browser tab for the given URL.
|
|
{{% button href=&#34;https://gohugo.io/&#34; icon=&#34;download&#34; %}}Get Hugo{{% /button %}} Parameter Name Optional Default Notes href yes &lt;empty&gt; The destination URL for the button.</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 [ &lt;string&gt; [ &#34;true&#34; | &#34;false&#34; ] ] %}} Yes! {{% /expand %}} The first optional parameter defines the text that appears next to the expand/collapse icon. The default text is &quot;Expand me...&quot;.
|
|
The second optional parameter controls if the block is initially shown as expanded (&quot;true&quot;) or collapsed (&quot;false&quot;). The default ist &quot;false&quot;.
|
|
Examples I&#39;ll tell you a secret.</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 &lt;string&gt; [ &#34;true&#34; | &#34;false&#34; ] %}} The first required parameter is the path to the file to be included.
|
|
If the file&rsquo;s content will be displayed as HTML, the second optional parameter controls if the first heading of the included file should be displayed (&quot;true&quot;)- 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.
|
|
Note This only works in modern browsers.
|
|
Warning Due to limitations with Mermaid, it is currently not possible to use Mermaid code fences in an initially collapsed expand shortcode. This is a know issue and can&rsquo;t be fixed by this theme.
|
|
Usage Just insert your Mermaid code in the mermaid shortcode like this:</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 various types of disclaimers with adjustable color, title and icon to help you structure your page.
|
|
There may be pirates It is all about the boxes.
|
|
Usage While the examples are using named parameter you are free to use positional aswell.
|
|
named positional {{% notice style=&#34;primary&#34; title=&#34;There may be pirates&#34; icon=&#34;skull-crossbones&#34; %}} It is all about the boxes. {{% /notice %}} {{% notice primary &#34;There may be pirates&#34; &#34;skull-crossbones&#34; %}} It is all about the boxes.</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>The siteparam shortcode is used to help you print values of site params.
|
|
Usage {{% siteparam &lt;string&gt; %}} The first required parameter is the name of the site param to be displayed.
|
|
Examples For instance, in this current site, the editURL variable is used in config.toml
|
|
[params] editURL = &#34;https://github.com/McShelby/hugo-theme-relearn/edit/main/exampleSite/content/&#34; Use the siteparam shortcode to display its value.
|
|
`editURL` Value : {{% siteparam &#34;editURL&#34; %}} is displayed as
|
|
editURL Value : https://github.</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 {{&lt; tabs &gt;}} {{% tab name=&#34;python&#34; %}} ```python print(&#34;Hello World!&#34;) ``` {{% /tab %}} {{% tab name=&#34;R&#34; %}} ```R &gt; print(&#34;Hello World!&#34;) ``` {{% /tab %}} {{% tab name=&#34;Bash&#34; %}} ```Bash echo &#34;Hello World!&#34; ``` {{% /tab %}} {{&lt; /tabs &gt;}} Renders as:
|
|
python R Bash print(&#34;Hello World!</description>
|
|
</item>
|
|
</channel>
|
|
</rss> |