Maintenance: Partials and Shortcodes

Disclaimer: Maintenance pages are for those who update this website. Nonetheless, everyone is free to look.

This page documents the partials and shortcodes available with this theme.

Partials

Inserts HTML (and may include embedded Hugo code). NOTE: Not available from markdown files. (See both layouts/partials/ and themes/Author-Blog/layouts/partials/.)

• banner.html - (NOT USED) Generates the “hero” banner at the top of the webpage
• body-bottom.html - Comment form when enabled on a given page/post
• copyright.html - Copyright statement (in the footer)
• footer.html - Footer content (history, links, top tags)
• head.html - Header content (not visible to users)
• menu/show_list.html - Part 1 of 2 of website’s menu generation
• menu/walk.html - Part 2 of 2 of the website’s menu generation
• nav-top.html - Navigation menu at top of webpage
• nav-prev.html - Next/Previous buttons with name of current section
• scripts.html - Scripts to pull from elsewhere

Shortcodes

Inserts HTML (and may include embedded Hugo code). NOTE: Available to use in markdown files. (See both layouts/partials/ and themes/Author-Blog/layouts/partials/.)

• aside - Side comments in an outlined block to the right of text
• audio - Generate the link for an audio (mp3) player
• blockquote - Enclose .Inner inside HTML blockquote, and (if either) $0 as author, and $1 as citation
• blurb - Book-blurb with cover image and story synopsis
• card-big - Full-width previews of publications
• card-group - Wrapper for multiple card-small “cards”
• card-small - Small “card” used as a link to other pages
• carousel - Begin (and end) a carousel of images
• carousel-image - An image inside a carousel
• clearfix.html - Force a break from a floating image
• download - Generate a clickable “Download” link
• dump_page_variables - For debugging, not production use
• dump_site_variables - For debugging, not production use
• formspree - Insert a Formspree.io Contact (or other) form
• gallery - Begin (and end) a gallery of images
• gallery-image - An image in a gallery
• html - (DISCOURAGED) - Wrapper for plain HTML. Use only as a last resort.
• img/float-begin - (INFERIOR) Display an image near the top-left, use img/left instead (text flows around it better)
• img/float-end - (BEST) Display an image to the right
• img/full - (SECOND CHOICE) Display an image front and center
• img/left - Display an image to the left
• img/right - (INFERIOR) Display an image to the right, use img/float-end instead
• link - Generates a BootStrap “button” with an HTML link
• mailto - Wraps an email address so it can be clicked to send a message
• rawhtml - Rarely used, it encases raw HTML for odd jobs
• socialmedia - Generates the list of social media sites associated with this website