examples/julia.html

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang xml:lang>
<head>
  <meta charset="utf-8" />
  <meta name="generator" content="pandoc" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
  <title>Codebraid with Julia</title>
  <style>
code{white-space: pre-wrap;}
span.smallcaps{font-variant: small-caps;}
div.columns{display: flex; gap: min(4vw, 1.5em);}
div.column{flex: auto; overflow-x: auto;}
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}

ul.task-list[class]{list-style: none;}
ul.task-list li input[type="checkbox"] {
font-size: inherit;
width: 0.8em;
margin: 0 0.8em 0.2em -1.6em;
vertical-align: middle;
}
.display.math{display: block; text-align: center; margin: 0.5rem auto;}

pre > code.sourceCode { white-space: pre; position: relative; }
pre > code.sourceCode > span { line-height: 1.25; }
pre > code.sourceCode > span:empty { height: 1.2em; }
.sourceCode { overflow: visible; }
code.sourceCode > span { color: inherit; text-decoration: inherit; }
div.sourceCode { margin: 1em 0; }
pre.sourceCode { margin: 0; }
@media screen {
div.sourceCode { overflow: auto; }
}
@media print {
pre > code.sourceCode { white-space: pre-wrap; }
pre > code.sourceCode > span { text-indent: -5em; padding-left: 5em; }
}
pre.numberSource code
{ counter-reset: source-line 0; }
pre.numberSource code > span
{ position: relative; left: -4em; counter-increment: source-line; }
pre.numberSource code > span > a:first-child::before
{ content: counter(source-line);
position: relative; left: -1em; text-align: right; vertical-align: baseline;
border: none; display: inline-block;
-webkit-touch-callout: none; -webkit-user-select: none;
-khtml-user-select: none; -moz-user-select: none;
-ms-user-select: none; user-select: none;
padding: 0 4px; width: 4em;
color: #aaaaaa;
}
pre.numberSource { margin-left: 3em; border-left: 1px solid #aaaaaa; padding-left: 4px; }
div.sourceCode
{ }
@media screen {
pre > code.sourceCode > span > a:first-child::before { text-decoration: underline; }
}
code span.al { color: #ff0000; font-weight: bold; } 
code span.an { color: #60a0b0; font-weight: bold; font-style: italic; } 
code span.at { color: #7d9029; } 
code span.bn { color: #40a070; } 
code span.bu { color: #008000; } 
code span.cf { color: #007020; font-weight: bold; } 
code span.ch { color: #4070a0; } 
code span.cn { color: #880000; } 
code span.co { color: #60a0b0; font-style: italic; } 
code span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } 
code span.do { color: #ba2121; font-style: italic; } 
code span.dt { color: #902000; } 
code span.dv { color: #40a070; } 
code span.er { color: #ff0000; font-weight: bold; } 
code span.ex { } 
code span.fl { color: #40a070; } 
code span.fu { color: #06287e; } 
code span.im { color: #008000; font-weight: bold; } 
code span.in { color: #60a0b0; font-weight: bold; font-style: italic; } 
code span.kw { color: #007020; font-weight: bold; } 
code span.op { color: #666666; } 
code span.ot { color: #007020; } 
code span.pp { color: #bc7a00; } 
code span.sc { color: #4070a0; } 
code span.ss { color: #bb6688; } 
code span.st { color: #4070a0; } 
code span.va { color: #19177c; } 
code span.vs { color: #4070a0; } 
code span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } 
</style>
  <style type="text/css">body {display: block;text-align: left;max-width: 40rem;padding-left: 0.5rem;padding-right: 0.5rem;margin: auto;}pre.numberSource a.sourceLine {position: relative;left: -3em;}pre.numberSource a.sourceLine::before{content: attr(title);position: relative;left: -1em;text-align: right;vertical-align: baseline;border: none;pointer-events: all;display: inline-block;-webkit-touch-callout: none;-webkit-user-select: none;-khtml-user-select: none;-moz-user-select: none;-ms-user-select: none;user-select: none;padding: 0 4px;width: 3em;color: #aaaaaa;}pre.numberSource {margin-left: 2em;border-left: 1px solid #aaaaaa;padding-left: 4px;}div.exampleMarkup:before{content: "Markdown";font-family: monospace;display: block;height: 2em;font-size: 150%;}div.exampleMarkup {padding-top: 0.5em;padding-left: 0.5em;padding-right: 0.5em;margin-top: 2em;margin-bottom: 1em;background-color: honeydew;border-style: solid;border-width: 1px;border-color: limegreen;border-radius: 0.2em;}div.exampleOutput:before{content: "Output";font-family: monospace;display: block;font-size: 150%;}div.exampleOutput {color: black;padding-top: 0.5em;padding-left: 0.5em;padding-right: 0.5em;margin-top: 1em;margin-bottom: 2em;background-color: whitesmoke;border-style: solid;border-width: 1px;border-color: lightgray;border-radius: 0.2em;}div.sourceCode {padding: 0.5em;background-color: aliceblue;border-style: solid;border-width: 1px;border-color: lightskyblue;border-radius: 0.2em;}div.exampleOutput div.sourceCode:before{content: "code";font-family: monospace;display: block;height: 2em;font-weight: bold;font-size: 120%;}pre.stdout:before{content: "stdout";display: block;height: 2em;font-weight: bold;font-size: 120%;}pre.stdout {color: black;padding: 0.5em;background-color: azure;border-style: solid;border-width: 1px;border-color: turquoise;border-radius: 0.2em;padding-left: 0.5em;}code.stdout {color: black;background-color: azure;border-style: solid;border-width: 1px;border-color: turquoise;}pre.stderr:before{content: "stderr";display: block;height: 2em;font-weight: bold;font-size: 120%;}pre.stderr {color: red;padding: 0.5em;background-color: lavenderblush;border-style: solid;border-width: 1px;border-color: pink;border-radius: 0.2em;padding-left: 0.5em;}code.stderr {color: red;background-color: lavenderblush;border-style: solid;border-width: 1px;border-color: pink;}pre.error:before{content: "Error";display: block;height: 2em;font-weight: bold;font-size: 120%;}pre.error {color: red;padding: 0.5em;background-color: lavenderblush;border-style: solid;border-width: 1px;border-color: pink;border-radius: 0.2em;padding-left: 0.5em;}code.error {color: red;background-color: lavenderblush;border-style: solid;border-width: 1px;border-color: pink;}</style>
  <!--[if lt IE 9]>
    <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
  <![endif]-->
</head>
<body>
<header id="title-block-header">
<h1 class="title">Codebraid with Julia</h1>
</header>
<h2 id="inline-code">Inline code</h2>
<h3 id="run">Run</h3>
<p>Inline code with <code>.cb-run</code> gives raw stdout.</p>
<div class="example">
<div class="exampleMarkup">
<pre><code>`println(1 + 2)`{.julia .cb-run}</code></pre>
</div>
<div class="exampleOutput">
<p>3</p>
</div>
</div>
<h3 id="expression-and-inline-notebook">Expression and inline
notebook</h3>
<p>Inline code with <code>.cb-expr</code> evaluates an expression and
then inserts the raw output into the document, where it is interpreted
as Markdown. Inline code with <code>.cb-nb</code> (<code>nb</code> is
short for <code>notebook</code>) is similar, except output is shown
verbatim.</p>
<div class="example">
<div class="exampleMarkup">
<pre><code>`&quot;\$\\sin(30^\\circ) = $(sind(30))\$&quot;`{.julia .cb-expr}</code></pre>
</div>
<div class="exampleOutput">
<p><span class="math inline">sin (30<sup>∘</sup>) = 0.5</span></p>
</div>
</div>
<div class="example">
<div class="exampleMarkup">
<pre><code>`&quot;\$e^{\\pi/4} = $(exp(pi/4))\$&quot;`{.julia .cb-expr}</code></pre>
</div>
<div class="exampleOutput">
<p><span class="math inline"><em>e</em><sup><em>π</em>/4</sup> = 2.1932800507380152</span></p>
</div>
</div>
<div class="example">
<div class="exampleMarkup">
<pre><code>`&quot;\$e^{\\pi/4} = $(exp(pi/4))\$&quot;`{.julia .cb-nb}</code></pre>
</div>
<div class="exampleOutput">
<p><code class="expr">$e^{\pi/4} = 2.1932800507380152$</code></p>
</div>
</div>
<h3 id="stderr">Stderr</h3>
<p>In the event of an error, inline code automatically shows stderr by
default. This code is executed in its own session,
<code>inline_error</code>, so that it does not impact other
examples.</p>
<div class="example">
<div class="exampleMarkup">
<pre><code>`1 + &quot;a&quot;`{.julia .cb-run session=inline_error}</code></pre>
</div>
<div class="exampleOutput">
<p><code class="stderr error">ERROR: LoadError: MethodError: no method matching +(::Int64, ::String)  Closest candidates are:   +(::Any, ::Any, !Matched::Any, !Matched::Any...)    @ Base operators.jl:578   +(::T, !Matched::T) where T&lt;:Union{Int128, Int16, Int32, Int64, Int8, UInt128, UInt16, UInt32, UInt64, UInt8}    @ Base int.jl:87   +(::Integer, !Matched::Ptr)    @ Base pointer.jl:169   ...  Stacktrace:  [1] top-level scope    @ &lt;string&gt;:1 in expression starting at &lt;string&gt;:1</code></p>
</div>
</div>
<h3 id="source-errors">Source errors</h3>
<p>A message is also displayed for errors in the Markdown source. This
usually includes the name of the document source and the approximate
line number.</p>
<div class="example">
<div class="exampleMarkup">
<pre><code>`println(1 + 2)`{.jlia .cb-run session=inline_source_error}</code></pre>
</div>
<div class="exampleOutput">
<p><code class="error sysConfigError">SYS CONFIG ERROR in &quot;julia.cbmd&quot; near line 45: Language definition for &quot;jlia&quot; does not exist</code></p>
</div>
</div>
<h2 id="block-code">Block code</h2>
<h3 id="run-1">Run</h3>
<p>Code blocks with <code>.cb-run</code> give raw stdout. There is
continuity between code blocks so long as they are in the same session;
variables persist.</p>
<div class="example">
<div class="exampleMarkup">
<pre><code>```{.julia .cb-run session=hello}
x = &quot;Hello from *Julia!*&quot;
```</code></pre>
</div>
</div>
<div class="example">
<div class="exampleMarkup">
<pre><code>```{.julia .cb-run session=hello}
println(x)
```</code></pre>
</div>
<div class="exampleOutput">
<p>Hello from <em>Julia!</em></p>
</div>
</div>
<h3 id="notebook">Notebook</h3>
<p>Code blocks with <code>.cb-nb</code> show the code and also the
verbatim stdout.</p>
<div class="example">
<div class="exampleMarkup">
<pre><code>```{.julia .cb-nb session=random}
using Random
using Statistics
Random.seed!(1)
rnums = rand(1:100, 10)
println(&quot;Random numbers: $(rnums)&quot;)
println(&quot;Median: $(median(rnums))&quot;)
println(&quot;Mean: $(mean(rnums))&quot;)
```</code></pre>
</div>
<div class="exampleOutput">
<div class="sourceCode" id="cb10" data-startFrom="1"><pre class="sourceCode numberSource julia numberLines"><code class="sourceCode julia"><span id="cb10-1"><a href="#cb10-1"></a><span class="im">using</span> <span class="bu">Random</span></span>
<span id="cb10-2"><a href="#cb10-2"></a><span class="im">using</span> <span class="bu">Statistics</span></span>
<span id="cb10-3"><a href="#cb10-3"></a><span class="bu">Random</span>.<span class="fu">seed!</span>(<span class="fl">1</span>)</span>
<span id="cb10-4"><a href="#cb10-4"></a>rnums <span class="op">=</span> <span class="fu">rand</span>(<span class="fl">1</span><span class="op">:</span><span class="fl">100</span>, <span class="fl">10</span>)</span>
<span id="cb10-5"><a href="#cb10-5"></a><span class="fu">println</span>(<span class="st">&quot;Random numbers: </span><span class="sc">$</span>(rnums)<span class="st">&quot;</span>)</span>
<span id="cb10-6"><a href="#cb10-6"></a><span class="fu">println</span>(<span class="st">&quot;Median: </span><span class="sc">$</span>(<span class="fu">median</span>(rnums))<span class="st">&quot;</span>)</span>
<span id="cb10-7"><a href="#cb10-7"></a><span class="fu">println</span>(<span class="st">&quot;Mean: </span><span class="sc">$</span>(<span class="fu">mean</span>(rnums))<span class="st">&quot;</span>)</span></code></pre></div>
<pre class="stdout"><code>Random numbers: [8, 35, 70, 63, 92, 20, 78, 79, 68, 17]
Median: 65.5
Mean: 53.0</code></pre>
</div>
</div>
<h3 id="stderr-1">Stderr</h3>
<p>Code blocks automatically show stderr by default.</p>
<div class="example">
<div class="exampleMarkup">
<pre><code>```{.julia .cb-nb .line_numbers session=block_error}
var = 123
println(var)
flush(stdout)
var += &quot;a&quot;
```</code></pre>
</div>
<div class="exampleOutput">
<div class="sourceCode" id="cb13" data-startFrom="1"><pre class="sourceCode numberSource julia numberLines"><code class="sourceCode julia"><span id="cb13-1"><a href="#cb13-1"></a>var <span class="op">=</span> <span class="fl">123</span></span>
<span id="cb13-2"><a href="#cb13-2"></a><span class="fu">println</span>(var)</span>
<span id="cb13-3"><a href="#cb13-3"></a><span class="fu">flush</span>(<span class="cn">stdout</span>)</span>
<span id="cb13-4"><a href="#cb13-4"></a>var <span class="op">+=</span> <span class="st">&quot;a&quot;</span></span></code></pre></div>
<pre class="stdout"><code>123</code></pre>
<pre class="stderr error"><code>ERROR: LoadError: MethodError: no method matching +(::Int64, ::String)

Closest candidates are:
  +(::Any, ::Any, !Matched::Any, !Matched::Any...)
   @ Base operators.jl:578
  +(::T, !Matched::T) where T&lt;:Union{Int128, Int16, Int32, Int64, Int8, UInt128, UInt16, UInt32, UInt64, UInt8}
   @ Base int.jl:87
  +(::Integer, !Matched::Ptr)
   @ Base pointer.jl:169
  ...

Stacktrace:
 [1] top-level scope
   @ source.jl:4
in expression starting at source.jl:4</code></pre>
</div>
</div>
<h3 id="source-errors-1">Source errors</h3>
<p>A message is also displayed for errors in the Markdown source. This
usually includes the name of the document source and the approximate
line number.</p>
<div class="example">
<div class="exampleMarkup">
<pre><code>```{.julia .cb-ruuun session=block_source_error}
println(1 + 2)
```</code></pre>
</div>
<div class="exampleOutput">
<pre class="error sourceError"><code>SOURCE ERROR in &quot;julia.cbmd&quot; near line 101:
Unknown or unsupported Codebraid command &quot;cb-ruuun&quot;

SOURCE ERROR in &quot;julia.cbmd&quot; near line 101:
Missing valid Codebraid command</code></pre>
</div>
</div>
<h2 id="other-options">Other options</h2>
<p>By default, stdout and stderr are only shown if they are non-empty.
In some situations, it may be useful to represent empty output visually
as confirmation that there indeed was none.</p>
<div class="example">
<div class="exampleMarkup">
<pre><code>```{.julia .cb-run show=code+stdout+stderr:verbatim_or_empty}
x = 1 + 2
```</code></pre>
</div>
<div class="exampleOutput">
<div class="sourceCode" id="cb19" data-startFrom="1"><pre class="sourceCode numberSource julia numberLines"><code class="sourceCode julia"><span id="cb19-1"><a href="#cb19-1"></a>x <span class="op">=</span> <span class="fl">1</span> <span class="op">+</span> <span class="fl">2</span></span></code></pre></div>
<pre class="stderr"><code> </code></pre>
</div>
</div>
<p>It is also possible to selectively hide output from a code chunk.</p>
<div class="example">
<div class="exampleMarkup">
<pre><code>```{.julia .cb-nb hide=stdout}
println(x)
```</code></pre>
</div>
<div class="exampleOutput">
<div class="sourceCode" id="cb22" data-startFrom="2"><pre class="sourceCode numberSource julia numberLines"><code class="sourceCode julia" style="counter-reset: source-line 1;"><span id="cb22-2"><a href="#cb22-2"></a><span class="fu">println</span>(x)</span></code></pre></div>
</div>
</div>
<p><code>hide</code> takes any combination of <code>code</code>,
<code>stderr</code>, and <code>stdout</code>, or simply
<code>all</code>.</p>
</body>
</html>