Fun with custom shortcodes

Straight from the χάος lab. Custom shortcodes available with this theme.

featurelist

A represantation of featured places. This is not the partial by the name of partials/featurelist.html rendered to the home page. Instead the shortcode shortcodes/featurelist.html is injected and populaded from this pages front matter. Both render to the css  class featurelist however.

On a small screen, You should see something like the following screen shot below the screen shot, while on the big screen the feature list will be placed towards the bottom right of the page.

edgebadge

Top right corner of this page. Keep it short and snappy. In case you want to display longer text, you may have to overwrite the .badge class in main.css.

nf for 󰻐

Takes the nerdfont class name as its only parameter. That is nf-fa-gears will be rendered as , even though it is not , and you are reading the source code without nerd font support. This is probably the case if  shows like 󰹽 to You. Click on the following to find out how to grind this and view this line in markdown source code .

Nerd Font Cheat Sheet

Use to look up class names for this shortcode or simply copy the glyph for pasting directly into your markdown text.

searchbox

witch opens a search on searx.xaoz.de

video

Square videos may be handy in certain use cases.

nextvideo

Takes the nextcloud share id as its only parameter. This is the final portion of the nextcloud share link. GYBctR4PkRNcDQZ in this case.

Music by The Dirtbombs

To make this work with Your own nextcloud instance, simply copy the YOUR-SITE/themes/aknized/layouts/shortcodes/nextvideo.html to YOUR-SITE/layouts/shortcodes/nextvideo.html and edit the HTML there.

<video controls poster="/images/xaoz.svg">
  <source src="https://next.xaoz.de/s/{{ .Get 0 }}/download" type="video/mp4">
  Your browser does not support the video tag.
</video>

The poster parameter is the placeholder image URL.

Last but not least, please note that all shortcodes may be easily overwritten thusly, without having to fork the entire theme. Within the scope of this theme´s documentation the copying of resouces from within the theme subfolder into your sites folder structure is what is being refered to be the word overwrite. Everything can be overwritten. Once your changes become so many, that you want to support Your own hugo theme, You are not only allowed to, but also encouraged in accord with this sofware´s licence agreement and the mission statement of this web site. It would be a decent move of You to make your work available under the same terms, but hey what do you know. The world is full of plagiarists and trolls. Perhaps you found an error or came up with a new cool short code. You are welcome to commit your changes to the so called upstream. That is this software project itself.