Add syntax in html format

.gitignore

@@ -10,6 +10,7 @@
 Thumbs.db
 .DS_Store
 .vscode
+.idea
 
 # Logs #
 ########

reference-converter/internal/output/output.go

@@ -14,7 +14,8 @@ type Directive struct {
 	Name            string   `json:"name"`
 	Default         string   `json:"default"`
 	Contexts        []string `json:"contexts"`
-	Syntax          []string `json:"syntax"`
+	SyntaxMd        []string `json:"syntax_md"`
+	SyntaxHtml      []string `json:"syntax_html"`
 	IsBlock         bool     `json:"isBlock"`
 	DescriptionMd   string   `json:"description_md"`
 	DescriptionHtml string   `json:"description_html"`
@@ -37,7 +38,8 @@ func toModule(m *parse.Module) Module {
 				Name:            directive.Name,
 				Default:         directive.Default,
 				Contexts:        directive.Contexts,
-				Syntax:          directive.Syntax.ToMarkdown(),
+				SyntaxMd:        directive.Syntax.ToMarkdown(),
+				SyntaxHtml:      directive.Syntax.ToHTML(),
 				IsBlock:         directive.Syntax.IsBlock(),
 				DescriptionMd:   directive.Prose.ToMarkdown(),
 				DescriptionHtml: directive.Prose.ToHTML(),

reference-converter/internal/output/output_test.go

@@ -43,7 +43,8 @@ func TestNew(t *testing.T) {
 						Name:            "directive 2",
 						Default:         "default 2",
 						Contexts:        []string{"context 1", "context 2"},
-						Syntax:          []string{"syntax 1", "syntax 2"},
+						SyntaxMd:        []string{"syntax 1", "syntax 2"},
+						SyntaxHtml:      []string{"<p>syntax 1</p>\n", "<p>syntax 2</p>\n"},
 						DescriptionMd:   "Test",
 						DescriptionHtml: "<p>Test</p>\n",
 					},
@@ -66,7 +67,8 @@ func TestWrite(t *testing.T) {
 						Name:            "Directive 1",
 						Default:         "Default",
 						Contexts:        []string{"Context 1", "Context 2"},
-						Syntax:          []string{"I am Syntax"},
+						SyntaxMd:        []string{"I am Syntax"},
+						SyntaxHtml:      []string{"<p>I am Syntax</p>"},
 						DescriptionMd:   "It is a directive",
 						DescriptionHtml: "<p>It is a directive</p>",
 					},

reference-converter/internal/parse/elements.go

@@ -33,6 +33,19 @@ func (ss Syntaxes) ToMarkdown() []string {
 	return ret
 }
 
+func (ss Syntaxes) ToHTML() []string {
+	if len(ss) == 0 {
+		return nil
+	}
+
+	ret := make([]string, 0, len(ss))
+	for _, s := range ss {
+		md := []byte(s.ToMarkdown())
+		ret = append(ret, string(mdToHTML(md)))
+	}
+	return ret
+}
+
 func (ss Syntaxes) IsBlock() bool {
 	isBlock := false
 	for _, s := range ss {

reference-lib/index.ts

@@ -51,7 +51,7 @@ export function getDirectives(format=Format.HTML): Directive[] {
         name: d.name,
         module: d.module,
         description: format === Format.HTML ? d.description_html : d.description_md,
-        syntax: d.syntax,
+        syntax: format === Format.HTML ? d.syntax_html : d.syntax_md,
         contexts: d.contexts,
         isBlock: d.isBlock,
         default: d.default

reference-lib/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nginxinc/reference-lib",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "",
   "main": "dist/index.js",
   "scripts": {

reference-lib/src/__mocks__/reference_mock.json

@@ -12,9 +12,12 @@
             "location",
             "limit_except"
           ],
-          "syntax": [
+          "syntax_md": [
             "*`address`* | *`CIDR`* | `unix:` | `all`"
           ],
+          "syntax_html": [
+            "<p><em><code>address</code></em> | <em><code>CIDR</code></em> | <code>unix:</code> | <code>all</code></p>\n"
+          ],
           "isBlock": false,
           "description_md": "Allows access for the specified network or address.",
           "description_html": "\u003cp\u003eAllows access for the specified network or address\u003c/p\u003e"

reference-lib/tests/index.test.ts

@@ -38,7 +38,7 @@ describe('Directive Helper', () => {
       const expected = [{ name: directive?.name,
         module: module?.name,
         description: directive?.description_html,
-        syntax: directive?.syntax,
+        syntax: directive?.syntax_html,
         contexts: directive?.contexts,
         isBlock: directive?.isBlock,
         default: directive?.default,
@@ -50,7 +50,7 @@ describe('Directive Helper', () => {
       const expected = [{ name: directive?.name,
         module: module?.name,
         description: directive?.description_md,
-        syntax: directive?.syntax,
+        syntax: directive?.syntax_md,
         contexts: directive?.contexts,
         isBlock: directive?.isBlock,
         default: directive?.default,