Alignment links

internal/project/effective.go

@@ -256,6 +256,7 @@ func (p *Project) EffectiveConfig() EffectiveConfig {
 			VisibilityFile:       defaultString(p.Config.TopData.Wiki.VisibilityFile, DefaultTopDataWikiVisibilityFile),
 			TemplatesDir:         defaultString(p.Config.TopData.Wiki.TemplatesDir, DefaultTopDataWikiTemplatesDir),
 			ManualSectionsDir:    defaultString(p.Config.TopData.Wiki.ManualSectionsDir, DefaultTopDataWikiManualSectionsDir),
+			AlignmentLinks:       p.Config.TopData.Wiki.AlignmentLinks,
 			TitlePrefixMinLength: defaultInt(p.Config.TopData.Wiki.TitlePrefixMinLength, DefaultTopDataWikiTitlePrefixMinLength),
 			StatusPages:          defaultBoolPointer(p.Config.TopData.Wiki.StatusPages, DefaultTopDataWikiStatusPages),
 			StatusListingScope:   defaultString(p.Config.TopData.Wiki.StatusListingScope, DefaultTopDataWikiStatusListingScope),

internal/project/project.go

@@ -249,6 +249,7 @@ type TopDataWikiConfig struct {
 	VisibilityFile       string                         `json:"visibility_file" yaml:"visibility_file"`
 	TemplatesDir         string                         `json:"templates_dir" yaml:"templates_dir"`
 	ManualSectionsDir    string                         `json:"manual_sections_dir" yaml:"manual_sections_dir"`
+	AlignmentLinks       TopDataWikiAlignmentLinks      `json:"alignment_links" yaml:"alignment_links"`
 	TitlePrefixMinLength int                            `json:"title_prefix_min_length" yaml:"title_prefix_min_length"`
 	StatusPages          *bool                          `json:"status_pages,omitempty" yaml:"status_pages,omitempty"`
 	StatusListingScope   string                         `json:"status_listing_scope" yaml:"status_listing_scope"`
@@ -256,6 +257,10 @@ type TopDataWikiConfig struct {
 	ManagedRegion        TopDataWikiManagedRegionConfig `json:"managed_region" yaml:"managed_region"`
 }
 
+type TopDataWikiAlignmentLinks struct {
+	TargetPattern string `json:"target_pattern" yaml:"target_pattern"`
+}
+
 type TopDataWikiStalePagesConfig struct {
 	Default     string `json:"default" yaml:"default"`
 	LiveCleanup string `json:"live_cleanup" yaml:"live_cleanup"`

internal/topdata/wiki_native.go

@@ -120,6 +120,7 @@ type wikiContext struct {
 	visibleWikiKeys      map[string]bool
 	namespaceTitles      map[string]string
 	namespacePaths       map[string]string
+	alignmentLinkPattern string
 }
 
 func buildWiki(p *project.Project, nativeResult BuildResult, force bool, progress func(string)) (wikiResult, error) {
@@ -153,6 +154,7 @@ func buildWiki(p *project.Project, nativeResult BuildResult, force bool, progres
 	manualSections := loadWikiManualSections(p)
 	ctx.manualSections = manualSections
 	ctx.templateDir = filepath.Join(p.TopDataWikiSourceDir(), filepath.FromSlash(p.EffectiveConfig().TopData.Wiki.TemplatesDir), "pages")
+	ctx.alignmentLinkPattern = p.EffectiveConfig().TopData.Wiki.AlignmentLinks.TargetPattern
 	ctx.wikiTablesPath = filepath.Join(p.TopDataWikiSourceDir(), filepath.FromSlash(p.EffectiveConfig().TopData.Wiki.TablesFile))
 	tableDefinitions, err := loadWikiTableDefinitions(ctx.wikiTablesPath)
 	if err != nil {

internal/topdata/wiki_native_test.go

@@ -1288,6 +1288,28 @@ func TestWikiTemplateFormatsPreferredAlignments(t *testing.T) {
 	}
 }
 
+func TestWikiTemplateFormatsPreferredAlignmentsWithConfiguredLinks(t *testing.T) {
+	ctx := &wikiContext{alignmentLinkPattern: "Guides/Alignment/{alignment}"}
+	page := wikiTemplatePage{
+		PageID:   "racialtypes:tiefling",
+		Category: "racialtypes",
+		Key:      "racialtypes:tiefling",
+		Title:    "Tiefling",
+		Row: map[string]any{
+			"PreferredAlignments": map[string]any{"list": []any{"le", "ne", "ce"}},
+		},
+	}
+
+	got, err := ctx.renderWikiTemplateString("racialtypes.html", `{{alignments(PreferredAlignments)}}`, page)
+	if err != nil {
+		t.Fatalf("render template: %v", err)
+	}
+	want := "[[Guides/Alignment/Lawful_Evil|Lawful Evil]], [[Guides/Alignment/Neutral_Evil|Neutral Evil]], [[Guides/Alignment/Chaotic_Evil|Chaotic Evil]]"
+	if got != want {
+		t.Fatalf("expected %q, got %q", want, got)
+	}
+}
+
 func TestWikiTemplateDescriptionFiltersExtractParagraphsAndSections(t *testing.T) {
 	ctx := &wikiContext{}
 	page := wikiTemplatePage{

internal/topdata/wiki_tables.go

@@ -1059,7 +1059,7 @@ func (p *wikiExprParser) callHelper(name string, args []any) (any, error) {
 		if len(args) != 1 {
 			return nil, fmt.Errorf("alignments expects 1 argument")
 		}
-		return formatWikiTemplateAlignments(args[0])
+		return p.ctx.formatWikiTemplateAlignments(args[0])
 	case "ability_adjustments":
 		if len(args) != 0 {
 			return nil, fmt.Errorf("ability_adjustments expects 0 arguments")

internal/topdata/wiki_template_expr.go

@@ -188,7 +188,7 @@ func (ctx *wikiContext) applyWikiTemplateFilter(value any, filter string, state
 	case "count":
 		return countWikiTemplateValue(value), nil
 	case "alignments":
-		return formatWikiTemplateAlignments(value)
+		return ctx.formatWikiTemplateAlignments(value)
 	case "list":
 		return wikiTemplateHTML(renderWikiTemplateList(value, firstArg(args))), nil
 	case "ordinal":
@@ -367,7 +367,7 @@ func joinWikiTemplateValue(value any, sep string) string {
 	}
 }
 
-func formatWikiTemplateAlignments(value any) (string, error) {
+func (ctx *wikiContext) formatWikiTemplateAlignments(value any) (string, error) {
 	values, err := wikiTemplateAlignmentValues(value)
 	if err != nil {
 		return "", err
@@ -384,7 +384,7 @@ func formatWikiTemplateAlignments(value any) (string, error) {
 		if !ok {
 			return "", fmt.Errorf("unknown alignment value 0x%02X", value)
 		}
-		labels = append(labels, label)
+		labels = append(labels, ctx.renderWikiTemplateAlignmentLabel(label))
 	}
 	if len(labels) == 0 {
 		return "Any", nil
@@ -392,6 +392,26 @@ func formatWikiTemplateAlignments(value any) (string, error) {
 	return strings.Join(labels, ", "), nil
 }
 
+func (ctx *wikiContext) renderWikiTemplateAlignmentLabel(label string) string {
+	pattern := ""
+	if ctx != nil {
+		pattern = strings.TrimSpace(ctx.alignmentLinkPattern)
+	}
+	if pattern == "" {
+		return label
+	}
+	target := strings.ReplaceAll(pattern, "{alignment}", wikiTemplateAlignmentTargetSegment(label))
+	target = strings.ReplaceAll(target, "{label}", label)
+	if strings.TrimSpace(target) == "" {
+		return label
+	}
+	return "[[" + target + "|" + label + "]]"
+}
+
+func wikiTemplateAlignmentTargetSegment(label string) string {
+	return strings.ReplaceAll(strings.TrimSpace(label), " ", "_")
+}
+
 func wikiTemplateAlignmentValues(value any) ([]int, error) {
 	if isNullLike(value) {
 		return []int{0}, nil