Jafner.net/Jafner.dev
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
..
.gitea/workflows Init 2024-05-28 19:01:48 -07:00
.github/workflows Add missing instance of url parameter 2024-05-28 23:31:13 -07:00
archetypes Init 2024-05-28 19:01:48 -07:00
content Publish Homelab Tour Series Intro 2024-06-28 17:25:59 -07:00
layouts/shortcodes Publish Homelab Tour Series Intro 2024-06-28 17:25:59 -07:00
public Publish Homelab Tour Series Intro 2024-06-28 17:25:59 -07:00
resources/_gen/assets/scss/scss Init 2024-05-28 19:01:48 -07:00
static/css Publish Homelab Tour Series Intro 2024-06-28 17:25:59 -07:00
themes Init 2024-05-28 18:59:39 -07:00
.gitmodules Init 2024-05-28 18:59:39 -07:00
.hugo_build.lock Init 2024-05-28 19:01:48 -07:00
config.toml Publish Homelab Tour Series Intro 2024-06-28 17:25:59 -07:00
docker-compose.yml Init 2024-05-28 19:01:48 -07:00
README.md Publish Homelab Tour Series Intro 2024-06-28 17:25:59 -07:00

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.