The notes section of this site is a Digital Garden created with the docs layout of the Hugo Bootstrap Theme. The docs layout has a so called “catalog” sidebar to the left whose contents are automatically generated from a given hierarchy of files and folders.

  • Create a folder content/notes​ in the existing site’s folder

  • Create content/notes/_index.md​ with content

    1---
2cascade:
3    type: docs
4menu:
5    main:
6        title: Notes
7        weight: '45'
8title: Notes
9---

  • Now, the files and folders present in content/notes​ will appear in the left catalog sidebar hierarchy.

  • To get a ‘Recent Posts’ sidebar widget in the digital garden, add {{ partial "sidebar/recent-posts" . }}​ to layouts/partials/hooks/docs/sidebar-end.html​

  • This is sufficient to create a digital garden if you intend to write your notes as files within the content/notes​ hierarchy, in ways that are already compatible with or recognizable by Hugo.

    • But in case you create your notes using some other software program, it would be necessary to export those notes into a hierarchy of plain markdown files that are understandable by Hugo.
    • ~~I use ​Dendron~~​ ~~ for taking notes. The tools and process for exporting notes from a Dendron "vault" are described in ~~​Export Dendron to Hugo
    • ~~I use ​Obsidian~~​ ~~ for taking notes. The tools and process for exporting notes from an Obsidian "vault" are described in ~~​Publishing Obsidian vault with Hugo
    • I use SiYuan for taking notes. The tools and process for exporting and publishing notes from SiYuan are described in Publishing SiYuan notes with Hugo

  • Modify list template to remove subsections and child page summaries from being displayed

    • Copy theme files to site root

      cp themes/hugo-theme-bootstrap/layouts/partials/docs/list.html layouts/partials/docs/

    • Edit layouts/partials/docs/list.html​ to contain

      <div class="container">
    {{- if not .IsHome -}}
        {{- partial "breadcrumb" . -}}
        {{- with .Content -}}
        <article class="row card post component">
        <div class="card-body pb-0">
            {{ . }}
        </div>
        </article>
        {{- end -}}
    {{- end -}}
    </div>