Escape all Code blocks for jingsa templates

Author: nicolasgarnier

claat/cmd/export.go

@@ -164,6 +164,7 @@ func writeCodelabWriter(w io.Writer, clab *types.Codelab, extraVars map[string]s
 	}{Context: render.Context{
 		Env:      ctx.Env,
 		Prefix:   ctx.Prefix,
+		Format:   ctx.Format,
 		GlobalGA: ctx.MainGA,
 		Updated:  time.Time(*ctx.Updated).Format(time.RFC3339),
 		Meta:     &clab.Meta,
@@ -206,6 +207,7 @@ func writeCodelab(dir string, clab *types.Codelab, extraVars map[string]string,
 	}{Context: render.Context{
 		Env:      ctx.Env,
 		Prefix:   ctx.Prefix,
+		Format:   ctx.Format,
 		GlobalGA: ctx.MainGA,
 		Updated:  time.Time(*ctx.Updated).Format(time.RFC3339),
 		Meta:     &clab.Meta,

claat/render/html.go

@@ -36,17 +36,17 @@ var (
 )
 
 // HTML renders nodes as the markup for the target env.
-func HTML(env string, nodes ...types.Node) (htmlTemplate.HTML, error) {
+func HTML(ctx Context, nodes ...types.Node) (htmlTemplate.HTML, error) {
 	var buf bytes.Buffer
-	if err := WriteHTML(&buf, env, nodes...); err != nil {
+	if err := WriteHTML(&buf, ctx.Env, ctx.Format, nodes...); err != nil {
 		return "", err
 	}
 	return htmlTemplate.HTML(buf.String()), nil
 }
 
 // WriteHTML does the same as HTML but outputs rendered markup to w.
-func WriteHTML(w io.Writer, env string, nodes ...types.Node) error {
-	hw := htmlWriter{w: w, env: env}
+func WriteHTML(w io.Writer, env string, fmt string, nodes ...types.Node) error {
+	hw := htmlWriter{w: w, env: env, format: fmt}
 	return hw.write(nodes...)
 }
 
@@ -64,9 +64,10 @@ func ReplaceAmpersand(s string) string {
 }
 
 type htmlWriter struct {
-	w   io.Writer // output writer
-	env string    // target environment
-	err error     // error during any writeXxx methods
+	w      io.Writer // output writer
+	env    string    // target environment
+	format string    // target template
+	err    error     // error during any writeXxx methods
 }
 
 func (hw *htmlWriter) matchEnv(v []string) bool {
@@ -241,7 +242,13 @@ func (hw *htmlWriter) code(n *types.CodeNode) {
 		}
 		hw.writeBytes(greaterThan)
 	}
+	if hw.format == "devsite" {
+		hw.writeString("{% verbatim %}")
+	}
 	hw.writeEscape(n.Value)
+	if hw.format == "devsite" {
+		hw.writeString("{% endverbatim %}")
+	}
 	if !n.Term {
 		hw.writeString("</code>")
 	}

claat/render/lite.go

@@ -30,9 +30,9 @@ import (
 )
 
 // Lite renders nodes as a standard HTML markup, without Custom Elements.
-func Lite(env string, nodes ...types.Node) (htmlTemplate.HTML, error) {
+func Lite(ctx Context, nodes ...types.Node) (htmlTemplate.HTML, error) {
 	var buf bytes.Buffer
-	if err := WriteLite(&buf, env, nodes...); err != nil {
+	if err := WriteLite(&buf, ctx.Env, nodes...); err != nil {
 		return "", err
 	}
 	return htmlTemplate.HTML(buf.String()), nil

claat/render/md.go

@@ -27,9 +27,9 @@ import (
 )
 
 // MD renders nodes as markdown for the target env.
-func MD(env string, nodes ...types.Node) (string, error) {
+func MD(ctx Context, nodes ...types.Node) (string, error) {
 	var buf bytes.Buffer
-	if err := WriteMD(&buf, env, nodes...); err != nil {
+	if err := WriteMD(&buf, ctx.Env, nodes...); err != nil {
 		return "", err
 	}
 	return buf.String(), nil
@@ -42,12 +42,12 @@ func WriteMD(w io.Writer, env string, nodes ...types.Node) error {
 }
 
 type mdWriter struct {
-	w         io.Writer // output writer
-	env       string    // target environment
-	err       error     // error during any writeXxx methods
-	lineStart bool
-	isWritingTableCell bool // used to override lineStart for correct cell formatting
-	Prefix    string    // prefix for e.g. blockquote content
+	w                  io.Writer // output writer
+	env                string    // target environment
+	err                error     // error during any writeXxx methods
+	lineStart          bool
+	isWritingTableCell bool   // used to override lineStart for correct cell formatting
+	Prefix             string // prefix for e.g. blockquote content
 }
 
 func (mw *mdWriter) writeBytes(b []byte) {

claat/render/template-devsite.html

@@ -62,7 +62,7 @@
                                   {{if $.Meta.BadgePath}}badge-path="{{$.Meta.BadgePath}}"{{end}}>
             </google-codelab-about>
           {{end}}
-          {{.Content | renderHTML $.Env}}
+          {{.Content | renderHTML $.Context}}
         </google-codelab-step>
       {{end}}{{end}}
     </google-codelab>

claat/render/template-offline.html

@@ -70,7 +70,7 @@ <h1>{{.Meta.Title}}</h1>
     <div class="step__body">
       <h1>{{.Meta.Title}}</h1>
       <h2>{{.StepNum}}. {{.Current.Title}}</h2>
-      {{.Current.Content | renderLite .Env}}
+      {{.Current.Content | renderLite $.Context}}
     </div>
 
   </div><!-- codelab__toc -->

claat/render/template.go

@@ -36,6 +36,7 @@ type Context struct {
 	Env      string
 	Prefix   string
 	GlobalGA string
+	Format   string
 	Meta     *types.Meta
 	Steps    []*types.Step
 	Updated  string

claat/render/template.html

@@ -42,7 +42,7 @@
                   feedback-link="{{.Meta.Feedback}}">
     {{range $i, $e := .Steps}}{{if matchEnv .Tags $.Env}}
       <google-codelab-step label="{{.Title}}" duration="{{.Duration.Minutes}}">
-        {{.Content | renderHTML $.Env}}
+        {{.Content | renderHTML $.Context}}
       </google-codelab-step>
     {{end}}{{end}}
   </google-codelab>

claat/render/template.md

@@ -9,5 +9,5 @@
 {{range .Steps}}{{if matchEnv .Tags $.Env}}
 ## {{.Title}}
 {{if .Duration}}Duration: {{durationStr .Duration}}{{end}}
-{{.Content | renderMD $.Env}}
+{{.Content | renderMD $.Context}}
 {{end}}{{end}}