Docs widget

[vishalkadam47]

Documentation page would be a nice feature
thought to try myself but ended up with all markdown files combined in one page

	case "docs":
		return &DocsWidget{}, nil

  - name: Docs
    columns:
      - size: full
        widgets:
          - type: docs
            path: ./docs

docs.html

<div class="docs-widget"></div>
    <h2>{{ .Title }}</h2>
    <div class="docs-content">
        {{range $file, $content := .Contents}}
            <div class="doc-content" id="{{$file}}" style="display: none;">
                {{$content}}
            </div>
        {{end}}
    </div>
    <div class="docs-sidebar">
        <h3>Table of Contents</h3>
        <ul>
            {{range $file, $content := .Contents}}
                <li><a href="#{{$file}}">{{$file}}</a></li>
            {{end}}
        </ul>
    </div>
</div>

docs.go

package widget

import (
	"bytes"
	"html/template"
	"os"
	"path/filepath"

    "github.com/yuin/goldmark"
    "github.com/yuin/goldmark/extension"
    "github.com/yuin/goldmark/parser"
    "github.com/yuin/goldmark/renderer/html"
)

type DocsWidget struct {
	widgetBase
	Path string `yaml:"path"`
}

func (w *DocsWidget) GetType() string {
	return "docs"
}

func (w *DocsWidget) Render() template.HTML {
    files, err := os.ReadDir(w.Path)
    if err != nil {
        return template.HTML("Error reading directory: " + err.Error())
    }

    var content string
    for _, file := range files {
        if filepath.Ext(file.Name()) == ".md" || filepath.Ext(file.Name()) == ".mdx" {
            fileContent, err := os.ReadFile(filepath.Join(w.Path, file.Name()))
            if err != nil {
                content += "Error reading file " + file.Name() + ": " + err.Error() + "<br>"
                continue
            }

			md := goldmark.New(
				goldmark.WithExtensions(
					extension.GFM,
					extension.NewTypographer(
						extension.WithTypographicSubstitutions(extension.TypographicSubstitutions{
							extension.LeftSingleQuote:  []byte("&sbquo;"),
							extension.RightSingleQuote: nil, // nil disables a substitution
						}),
					),
				),
				goldmark.WithParserOptions(
					parser.WithAutoHeadingID(),
					parser.WithBlockParsers(),
					parser.WithInlineParsers(),
					parser.WithParagraphTransformers(),
					parser.WithASTTransformers(),
					parser.WithAttribute(),
				),
				goldmark.WithRendererOptions(
					html.WithHardWraps(),
					html.WithXHTML(),
					html.WithUnsafe(),
				),
			)
            var buf bytes.Buffer
            if err := md.Convert(fileContent, &buf); err != nil {
                content += "Error converting file " + file.Name() + ": " + err.Error() + "<br>"
                continue
            }
            content += buf.String()
        }
    }

    return template.HTML(content)

}
func (w *DocsWidget) Initialize() error {
	return nil
}