Output

Code and its result in one block

withoutput="true" splits a fence at a separator line into a code panel and an output panel. Everything above ---output--- is highlighted as code. Everything below it is shown verbatim, with no highlighting, because program output is not source.

This needs outputPanel: true in kazari.config.yaml. Without it the separator stays literal text in the middle of the code, which is the whole of the failure mode: nothing errors, the block only looks wrong.

1
package main
2
3
import "fmt"
4
5
func main() {
6
  for i := 1; i <= 3; i++ {
7
    fmt.Printf("tick %d\n", i)
8
  }
9
}

tick 1
tick 2
tick 3

Naming the panel

outputlabel replaces the default label on the panel’s toggle.

1
values = [4, 8, 15, 16, 23, 42]
2
print("count:", len(values))
3
print("mean:", sum(values) / len(values))

count: 6
mean: 18.0

Starting collapsed

outputcollapsed="true" hides the panel until the reader opens it, which suits long or noisy output. outputcollapsed="false" forces it open on a site whose config collapses output by default.

1
go build ./...
2
go test ./...

ok  	github.com/frostybee/kazari	0.412s
ok  	github.com/frostybee/kazari/goldmark	0.188s
ok  	github.com/frostybee/kazari/process	1.307s

Terminal blocks work the same way

A shell block still gets its terminal frame, and the output panel sits below it.

1
kazari process --config kazari.config.yaml public

7 files, 24 blocks upgraded, 1 skipped, 0 suppressed, 9 changed

A note on the attribute names

The Kazari meta grammar spells these keys withOutput, outputLabel, and outputCollapsed. Hugo lowercases every attribute name before the render hook sees it, so the hook translates withoutput back to withOutput on the way out. Write them lowercase in Hugo fences and the hook handles the rest.