Skip to content

Commit 439c7c7

Browse files
author
Quarto GHA Workflow Runner
committed
Built site for gh-pages
1 parent 6e161c1 commit 439c7c7

File tree

5 files changed

+233
-65
lines changed

5 files changed

+233
-65
lines changed

.nojekyll

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
a367948f
1+
ea63e97e

pages/markdown.html

Lines changed: 112 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -335,23 +335,29 @@ <h2 data-number="4" class="anchored" data-anchor-id="bold-and-italic-text"><span
335335
</section>
336336
<section id="bullet-points-and-numbered-lists" class="level2" data-number="5">
337337
<h2 data-number="5" class="anchored" data-anchor-id="bullet-points-and-numbered-lists"><span class="header-section-number">5</span> Bullet points and numbered lists</h2>
338-
<p>To create a bullet list, use <code>*</code> followed by a space and then your text:</p>
338+
<p>To create a bullet list, use <code>*</code> or <code>-</code> or <code>+</code> followed by a space and then your text:</p>
339339
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb5"><pre class="sourceCode markdown code-with-copy"><code class="sourceCode markdown"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="ss">* </span>Bullet point 1</span>
340340
<span id="cb5-2"><a href="#cb5-2" aria-hidden="true" tabindex="-1"></a><span class="ss">* </span>Bullet point 2</span>
341341
<span id="cb5-3"><a href="#cb5-3" aria-hidden="true" tabindex="-1"></a><span class="ss">* </span>Bullet point 3</span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
342-
<p>You can indent with spaces (or tab) to create sub-bullets:</p>
342+
<p>Can give more space by having blank lines between items</p>
343343
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb6"><pre class="sourceCode markdown code-with-copy"><code class="sourceCode markdown"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a><span class="ss">* </span>Bullet point 1</span>
344-
<span id="cb6-2"><a href="#cb6-2" aria-hidden="true" tabindex="-1"></a><span class="ss"> * </span>Bullet point level 2</span>
345-
<span id="cb6-3"><a href="#cb6-3" aria-hidden="true" tabindex="-1"></a><span class="ss"> * </span>Bullet point level 3</span>
346-
<span id="cb6-4"><a href="#cb6-4" aria-hidden="true" tabindex="-1"></a><span class="ss">* </span>Back to level 1</span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
347-
<p>A numbered list is created in a similar way using numbers (or letters):</p>
348-
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb7"><pre class="sourceCode markdown code-with-copy"><code class="sourceCode markdown"><span id="cb7-1"><a href="#cb7-1" aria-hidden="true" tabindex="-1"></a><span class="ss">1. </span>Numbered point 1</span>
349-
<span id="cb7-2"><a href="#cb7-2" aria-hidden="true" tabindex="-1"></a> a. Numbered point level 2 </span>
350-
<span id="cb7-3"><a href="#cb7-3" aria-hidden="true" tabindex="-1"></a> b. Numbered point level 2 again</span>
351-
<span id="cb7-4"><a href="#cb7-4" aria-hidden="true" tabindex="-1"></a><span class="ss">2. </span>Back to level 1</span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
344+
<span id="cb6-2"><a href="#cb6-2" aria-hidden="true" tabindex="-1"></a></span>
345+
<span id="cb6-3"><a href="#cb6-3" aria-hidden="true" tabindex="-1"></a><span class="ss">* </span>Bullet point 2</span>
346+
<span id="cb6-4"><a href="#cb6-4" aria-hidden="true" tabindex="-1"></a></span>
347+
<span id="cb6-5"><a href="#cb6-5" aria-hidden="true" tabindex="-1"></a><span class="ss">* </span>Bullet point 3</span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
348+
<p>You can indent with spaces (or tab) to create sub-bullets:</p>
349+
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb7"><pre class="sourceCode markdown code-with-copy"><code class="sourceCode markdown"><span id="cb7-1"><a href="#cb7-1" aria-hidden="true" tabindex="-1"></a><span class="ss">* </span>Bullet point 1</span>
350+
<span id="cb7-2"><a href="#cb7-2" aria-hidden="true" tabindex="-1"></a><span class="ss"> * </span>Bullet point level 2</span>
351+
<span id="cb7-3"><a href="#cb7-3" aria-hidden="true" tabindex="-1"></a><span class="ss"> * </span>Bullet point level 3</span>
352+
<span id="cb7-4"><a href="#cb7-4" aria-hidden="true" tabindex="-1"></a><span class="ss">* </span>Back to level 1</span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
353+
<p>A numbered list is created in a similar way using numbers, letters or Roman numerals, or can use #, will just give deciminal numbers from 1:</p>
354+
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb8"><pre class="sourceCode markdown code-with-copy"><code class="sourceCode markdown"><span id="cb8-1"><a href="#cb8-1" aria-hidden="true" tabindex="-1"></a><span class="ss">1. </span>Numbered point 1</span>
355+
<span id="cb8-2"><a href="#cb8-2" aria-hidden="true" tabindex="-1"></a> a. Numbered point level 2 </span>
356+
<span id="cb8-3"><a href="#cb8-3" aria-hidden="true" tabindex="-1"></a> b. Numbered point level 2 again</span>
357+
<span id="cb8-4"><a href="#cb8-4" aria-hidden="true" tabindex="-1"></a><span class="ss">2. </span>Back to level 1</span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
352358
<p>To create a checklist, add <code>[ ]</code> between the bullet and text. You can then click on the boxes to cross them out, or have them already shown as crossed out using <code>[x]</code>.</p>
353-
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb8"><pre class="sourceCode markdown code-with-copy"><code class="sourceCode markdown"><span id="cb8-1"><a href="#cb8-1" aria-hidden="true" tabindex="-1"></a><span class="ss">* </span><span class="va">[ ]</span> First task</span>
354-
<span id="cb8-2"><a href="#cb8-2" aria-hidden="true" tabindex="-1"></a><span class="ss">* </span><span class="va">[x]</span> Finished task</span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
359+
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb9"><pre class="sourceCode markdown code-with-copy"><code class="sourceCode markdown"><span id="cb9-1"><a href="#cb9-1" aria-hidden="true" tabindex="-1"></a><span class="ss">* </span><span class="va">[ ]</span> First task</span>
360+
<span id="cb9-2"><a href="#cb9-2" aria-hidden="true" tabindex="-1"></a><span class="ss">* </span><span class="va">[x]</span> Finished task</span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
355361
<div class="pale-blue">
356362
<p><strong>Task:</strong> In <code>markdown.qmd</code>:</p>
357363
<ul class="task-list">
@@ -361,10 +367,10 @@ <h2 data-number="5" class="anchored" data-anchor-id="bullet-points-and-numbered-
361367
</ul>
362368
</div>
363369
</section>
364-
<section id="indented-text" class="level2" data-number="6">
365-
<h2 data-number="6" class="anchored" data-anchor-id="indented-text"><span class="header-section-number">6</span> Indented text</h2>
370+
<section id="block-quotes" class="level2" data-number="6">
371+
<h2 data-number="6" class="anchored" data-anchor-id="block-quotes"><span class="header-section-number">6</span> Block quotes</h2>
366372
<p>To indent text as a block quote, use <code>&gt;</code> at the start of the line:</p>
367-
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb9"><pre class="sourceCode markdown code-with-copy"><code class="sourceCode markdown"><span id="cb9-1"><a href="#cb9-1" aria-hidden="true" tabindex="-1"></a><span class="at">&gt; This is indented</span></span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
373+
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb10"><pre class="sourceCode markdown code-with-copy"><code class="sourceCode markdown"><span id="cb10-1"><a href="#cb10-1" aria-hidden="true" tabindex="-1"></a><span class="at">&gt; This is indented</span></span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
368374
<p>You can use this for quotes, highlights, or short notes.</p>
369375
<div class="pale-blue">
370376
<p><strong>Task:</strong> In <code>markdown.qmd</code>:</p>
@@ -373,20 +379,103 @@ <h2 data-number="6" class="anchored" data-anchor-id="indented-text"><span class=
373379
</ul>
374380
</div>
375381
</section>
376-
<section id="line-break" class="level2" data-number="7">
377-
<h2 data-number="7" class="anchored" data-anchor-id="line-break"><span class="header-section-number">7</span> Line break</h2>
378-
<p>You can insert a line break using <code>&lt;br&gt;</code>.</p>
379-
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb10"><pre class="sourceCode markdown code-with-copy"><code class="sourceCode markdown"><span id="cb10-1"><a href="#cb10-1" aria-hidden="true" tabindex="-1"></a>First part of the sentence.<span class="dt">&lt;</span><span class="kw">br</span><span class="dt">&gt;</span>Second part on a new line.</span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
382+
<section id="links" class="level2" data-number="7">
383+
<h2 data-number="7" class="anchored" data-anchor-id="links"><span class="header-section-number">7</span> Links</h2>
384+
<p>You can create a link by putting the link text in square brackets and the web address in parentheses:</p>
385+
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb11"><pre class="sourceCode markdown code-with-copy"><code class="sourceCode markdown"><span id="cb11-1"><a href="#cb11-1" aria-hidden="true" tabindex="-1"></a><span class="co">[</span><span class="ot">University of Exeter</span><span class="co">](https://www.exeter.ac.uk/)</span></span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
386+
<p><a href="https://www.exeter.ac.uk/">University of Exeter</a></p>
387+
<p>If you just paste a URL, you should wrap it in angle brackets to ensure it is clickable:</p>
388+
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb12"><pre class="sourceCode markdown code-with-copy"><code class="sourceCode markdown"><span id="cb12-1"><a href="#cb12-1" aria-hidden="true" tabindex="-1"></a><span class="ot">&lt;https://www.exeter.ac.uk/&gt;</span></span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
389+
<p><a href="https://www.exeter.ac.uk/" class="uri">https://www.exeter.ac.uk/</a></p>
390+
<div class="pale-blue">
391+
<p><strong>Task:</strong> In <code>markdown.qmd</code>:</p>
392+
<ul class="task-list">
393+
<li><label><input type="checkbox">Add one link with custom link text.</label></li>
394+
<li><label><input type="checkbox">Add one bare URL wrapped in <code>&lt; &gt;</code> so that it becomes clickable.</label></li>
395+
</ul>
396+
</div>
397+
</section>
398+
<section id="inline-code-and-code-blocks" class="level2" data-number="8">
399+
<h2 data-number="8" class="anchored" data-anchor-id="inline-code-and-code-blocks"><span class="header-section-number">8</span> Inline code and code blocks</h2>
400+
<p>You can show short bits of code or filenames using single backticks. This is good for things like file names, commands, and short code fragments.</p>
401+
<p>Example:</p>
402+
<div class="columns">
403+
<div class="column" style="width:50%;">
404+
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb13"><pre class="sourceCode markdown code-with-copy"><code class="sourceCode markdown"><span id="cb13-1"><a href="#cb13-1" aria-hidden="true" tabindex="-1"></a>Run <span class="in">`python script.py`</span> in your terminal.</span>
405+
<span id="cb13-2"><a href="#cb13-2" aria-hidden="true" tabindex="-1"></a></span>
406+
<span id="cb13-3"><a href="#cb13-3" aria-hidden="true" tabindex="-1"></a>Open <span class="in">`analysis.qmd`</span> and edit the first section.</span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
407+
</div><div class="column" style="width:5%;">
408+
409+
</div><div class="column" style="width:45%;">
410+
<p>Run <code>python script.py</code> in your terminal.</p>
411+
<p>Open <code>analysis.qmd</code> and edit the first section.</p>
412+
</div>
413+
</div>
414+
<p>For longer code, use a code block fenced with three backticks:</p>
415+
<div class="columns">
416+
<div class="column" style="width:50%;">
417+
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb14"><pre class="sourceCode markdown code-with-copy"><code class="sourceCode markdown"><span id="cb14-1"><a href="#cb14-1" aria-hidden="true" tabindex="-1"></a><span class="in">```bash</span></span>
418+
<span id="cb14-2"><a href="#cb14-2" aria-hidden="true" tabindex="-1"></a><span class="ex">python</span> script.py <span class="at">--help</span></span>
419+
<span id="cb14-3"><a href="#cb14-3" aria-hidden="true" tabindex="-1"></a><span class="bu">echo</span> <span class="st">"Hello, world"</span></span>
420+
<span id="cb14-4"><a href="#cb14-4" aria-hidden="true" tabindex="-1"></a><span class="in">```</span></span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
421+
</div><div class="column" style="width:5%;">
422+
423+
</div><div class="column" style="width:45%;">
424+
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb15"><pre class="sourceCode bash code-with-copy"><code class="sourceCode bash"><span id="cb15-1"><a href="#cb15-1" aria-hidden="true" tabindex="-1"></a><span class="ex">python</span> script.py <span class="at">--help</span></span>
425+
<span id="cb15-2"><a href="#cb15-2" aria-hidden="true" tabindex="-1"></a><span class="bu">echo</span> <span class="st">"Hello, world"</span></span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
426+
</div>
427+
</div>
380428
<div class="pale-blue">
381429
<p><strong>Task:</strong> In <code>markdown.qmd</code>:</p>
382430
<ul class="task-list">
383-
<li><label><input type="checkbox">Write a short sentence, then use <code>&lt;br&gt;</code> to put a second short sentence on the next line with a line break between them.</label></li>
431+
<li><label><input type="checkbox">Use inline code (single backticks) to show one filename and one command.</label></li>
432+
<li><label><input type="checkbox">Add a fenced code block with 2-3 lines of example code (any language you like) - or just some text if you are unfamiliar.</label></li>
384433
</ul>
385434
</div>
386435
</section>
387-
<section id="hyperlinks" class="level2" data-number="8">
388-
<h2 data-number="8" class="anchored" data-anchor-id="hyperlinks"><span class="header-section-number">8</span> Hyperlinks</h2>
389-
<p>TODO</p>
436+
<section id="tables" class="level2" data-number="9">
437+
<h2 data-number="9" class="anchored" data-anchor-id="tables"><span class="header-section-number">9</span> Tables</h2>
438+
<p>You can create simple tables using pipes <code>|</code> and dashes <code>-</code>:</p>
439+
<div class="columns">
440+
<div class="column" style="width:30%;">
441+
<div class="code-copy-outer-scaffold"><div class="sourceCode" id="cb16"><pre class="sourceCode markdown code-with-copy"><code class="sourceCode markdown"><span id="cb16-1"><a href="#cb16-1" aria-hidden="true" tabindex="-1"></a><span class="pp">|</span> Letter <span class="pp">|</span> Number <span class="pp">|</span></span>
442+
<span id="cb16-2"><a href="#cb16-2" aria-hidden="true" tabindex="-1"></a><span class="pp">|</span> - <span class="pp">|</span> - <span class="pp">|</span></span>
443+
<span id="cb16-3"><a href="#cb16-3" aria-hidden="true" tabindex="-1"></a><span class="pp">|</span> A <span class="pp">|</span> 1 <span class="pp">|</span></span>
444+
<span id="cb16-4"><a href="#cb16-4" aria-hidden="true" tabindex="-1"></a><span class="pp">|</span> B <span class="pp">|</span> 2 <span class="pp">|</span></span>
445+
<span id="cb16-5"><a href="#cb16-5" aria-hidden="true" tabindex="-1"></a><span class="pp">|</span> C <span class="pp">|</span> 3 <span class="pp">|</span></span></code></pre></div><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></div>
446+
</div><div class="column" style="width:5%;">
447+
448+
</div><div class="column" style="width:65%;">
449+
<table class="caption-top table">
450+
<thead>
451+
<tr class="header">
452+
<th>Letter</th>
453+
<th>Number</th>
454+
</tr>
455+
</thead>
456+
<tbody>
457+
<tr class="odd">
458+
<td>A</td>
459+
<td>1</td>
460+
</tr>
461+
<tr class="even">
462+
<td>B</td>
463+
<td>2</td>
464+
</tr>
465+
<tr class="odd">
466+
<td>C</td>
467+
<td>3</td>
468+
</tr>
469+
</tbody>
470+
</table>
471+
</div>
472+
</div>
473+
<div class="pale-blue">
474+
<p><strong>Task:</strong> In <code>markdown.qmd</code>:</p>
475+
<ul class="task-list">
476+
<li><label><input type="checkbox">Create a small table with two columns and at least three rows (for example, “Item” and “Quantity”).</label></li>
477+
</ul>
478+
</div>
390479

391480

392481
</section>

0 commit comments

Comments
 (0)