<NME> index.md
<BEF> ADDFILE
<MSG> Support prerendering of code blocks. (#1627)

Passing `prerender=true` to `Documenter.HTML` now renders syntax
highlighting of code blocks when building the page rather than
in the browser when the page is loaded. This requires a `node`
(NodeJS) executable in PATH or that a path to an executable is
passed as the `node` keyword argument. The `highlightjs` keyword
argument can be used to give a (local) file path to a custrom
hightlight.js library.

Example configuration:

  using Documenter, NodeJS_16_jll

  makedocs(;
      format = Documenter.HTML(
          prerender = true,            # enable prerendering
          node = NodeJS_16_jll.node(), # specify node executable (required if not available in PATH)
          # ...
      )
      # ...
  )

This feature is marked as experimental for now.
<DFF> @@ -0,0 +1,22 @@
+# Code block prerendering using NodeJS
+
+```julia
+function f()
+    print("hello, world")
+end
+```
+
+```julia-repl
+julia> function f()
+           print("hello, world")
+       end
+```
+
+```llvm
+;  @ int.jl:87 within `+'
+define i64 @"julia_+_212"(i64 signext %0, i64 signext %1) {
+top:
+  %2 = add i64 %1, %0
+  ret i64 %2
+}
+```

Support prerendering of code blocks. (#1627)