Jafner.net/Jafner.dev/README.md
Joey Hafner c5532734a4 Publish Homelab Tour Series Intro
Fix intermittently broken article/project list rendering,
implement table of contents shortcode,
implement css snippet to reduce underline-fatigue for table of contents,
remove filler article files,
generate static files.
2024-06-28 17:25:59 -07:00

1.2 KiB

Running local dev server

  1. Ensure theme submodule is loaded: git submodule init && git submodule update
  2. Run the server with hugo server --noHTTPCache --ignoreCache --disableFastRender --buildDrafts

Including Images in Content

Good old-fashioned ![](image.png) markdown image embedding works just fine.

  1. Place the image file beside the content in the folder.
  2. For a Featured Image, use the line featured_image = "../pamidi.jpg" in the frontmatter.
  3. For an inline image, use {{< image src="../pamidi.jpg" >}}

Note: The working directory for relative resource locations uses the name of the content file as the current location. E.g. referencing the image ./myimage.jpg or ./myimage.jpg from inside the /content/projects/pamidi.md content file, would look for those images at /content/projects/pamidi/myimage.jpg.

Add a Table of Contents

  • To include a table of contents at the beginning of a page, add the flag toc = true to the frontmatter.
  • To insert a table of contents inline with the text, use the {{% toc %}} shortcode.
  • Tables of contents are configured under the [markup] configuration node in config.toml.