Skip to content

Commit

Permalink
Merge pull request #28 from Openscapes/stef-issue26
Browse files Browse the repository at this point in the history 
updating tutorial throughout
  • Loading branch information
@stefaniebutland
stefaniebutland authored Jan 4, 2024
2 parents 8da986e + 2367e36 commit 04c572f
Show file tree
Hide file tree
Showing 27 changed files with 1,899 additions and 494 deletions.
2 changes: 1 addition & 1 deletion _quarto.yml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ website:

page-footer:
right: "This page is built with ❤️ and [Quarto](https://quarto.org/)."
left: "© CC-By Openscapes, 2022"
left: "© CC-By Openscapes, 2024"

sidebar:
logo: "images/openscapes_hex.png"
Expand Down
Binary file modified _site/images/quarto-files-github.png
View file
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
325 changes: 262 additions & 63 deletions _site/index.html
View file

Large diffs are not rendered by default.

149 changes: 114 additions & 35 deletions _site/learning-more.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>

<meta charset="utf-8">
<meta name="generator" content="quarto-0.9.653">
<meta name="generator" content="quarto-1.2.335">

<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">

Expand All @@ -11,10 +11,15 @@
<style>
code{white-space: pre-wrap;}
span.smallcaps{font-variant: small-caps;}
span.underline{text-decoration: underline;}
div.column{display: inline-block; vertical-align: top; width: 50%;}
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{list-style: none;}
ul.task-list li input[type="checkbox"] {
width: 0.8em;
margin: 0 0.8em 0.2em -1.6em;
vertical-align: middle;
}
</style>


Expand All @@ -35,8 +40,8 @@
<link href="site_libs/quarto-html/quarto-syntax-highlighting-dark.css" rel="prefetch" class="quarto-color-scheme quarto-color-alternate" id="quarto-text-highlighting-styles">
<script src="site_libs/bootstrap/bootstrap.min.js"></script>
<link href="site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet">
<link href="site_libs/bootstrap/bootstrap.min.css" rel="stylesheet" class="quarto-color-scheme">
<link href="site_libs/bootstrap/bootstrap-dark.min.css" rel="prefetch" class="quarto-color-scheme quarto-color-alternate">
<link href="site_libs/bootstrap/bootstrap.min.css" rel="stylesheet" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
<link href="site_libs/bootstrap/bootstrap-dark.min.css" rel="prefetch" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="light">
<script id="quarto-search-options" type="application/json">{
"location": "sidebar",
"copy-button": false,
Expand Down Expand Up @@ -78,7 +83,7 @@ <h1 class="quarto-secondary-nav-title">Learning more</h1>
<!-- sidebar -->
<nav id="quarto-sidebar" class="sidebar collapse sidebar-navigation docked overflow-auto">
<div class="pt-lg-2 mt-2 text-center sidebar-header">
<a href="./" class="sidebar-logo-link">
<a href="./index.html" class="sidebar-logo-link">
<img src="./images/openscapes_hex.png" alt="" class="sidebar-logo py-0 d-lg-inline d-none">
</a>
<div class="sidebar-tools-main tools-wide">
Expand Down Expand Up @@ -106,29 +111,29 @@ <h1 class="quarto-secondary-nav-title">Learning more</h1>
</div>
</li>
<li class="sidebar-item sidebar-item-section">
<div class="sidebar-item-container">
<a href="./quarto-workflows/index.html" class="sidebar-item-text sidebar-link">Quarto workflows</a>
<a class="sidebar-item-toggle text-start collapsed" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" aria-expanded="false">
<i class="bi bi-chevron-right ms-2"></i>
</a>
</div>
<ul id="quarto-sidebar-section-1" class="collapse list-unstyled sidebar-section depth1 ">
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./quarto-workflows/index.html" class="sidebar-item-text sidebar-link">Quarto workflows</a>
<a class="sidebar-item-toggle text-start collapsed" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" aria-expanded="false">
<i class="bi bi-chevron-right ms-2"></i>
</a>
</div>
<ul id="quarto-sidebar-section-1" class="collapse list-unstyled sidebar-section depth1 ">
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./quarto-workflows/browser.html" class="sidebar-item-text sidebar-link">From the Browser</a>
</div>
</li>
<li class="sidebar-item">
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./quarto-workflows/rstudio.html" class="sidebar-item-text sidebar-link">From RStudio</a>
</div>
</li>
<li class="sidebar-item">
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./quarto-workflows/jupyter.html" class="sidebar-item-text sidebar-link">From Jupyter</a>
</div>
</li>
</ul>
</ul>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
Expand All @@ -145,7 +150,7 @@ <h1 class="quarto-secondary-nav-title">Learning more</h1>
</nav>
<!-- margin-sidebar -->
<div id="quarto-margin-sidebar" class="sidebar margin-sidebar">
<nav id="TOC" role="doc-toc">
<nav id="TOC" role="doc-toc" class="toc-active">
<h2 id="toc-title">On this page</h2>

<ul>
Expand All @@ -170,6 +175,7 @@ <h1 class="title d-none d-lg-block">Learning more</h1>
<div class="quarto-title-meta">




</div>

Expand All @@ -179,6 +185,7 @@ <h1 class="title d-none d-lg-block">Learning more</h1>
<section id="learn-more" class="level2">
<h2 class="anchored" data-anchor-id="learn-more">Learn more</h2>
<p>An excellent overview: <strong>Reproducible authoring with Quarto</strong> - Mine Çetinkaya-Rundel, Feb 2022 - <a href="https://mine-cetinkaya-rundel.github.io/2022-repro-toronto/#/title-slide">slides</a>, <a href="https://www.youtube.com/watch?v=6p4vOKS6Xls">youtube</a></p>
<p><a href="https://mine-cetinkaya-rundel.github.io/quarto-tip-a-day/">A Quarto tip a day</a> in June 2022, from Mine Çetinkaya-Rundel.</p>
<section id="examples-in-the-wild" class="level3">
<h3 class="anchored" data-anchor-id="examples-in-the-wild">Examples in the wild:</h3>
<ul>
Expand All @@ -191,7 +198,7 @@ <h3 class="anchored" data-anchor-id="examples-in-the-wild">Examples in the wild:
</section>
<section id="inspiration" class="level3">
<h3 class="anchored" data-anchor-id="inspiration">Inspiration</h3>
<p>Are you making onboarding documentation? Check out <a href="https://thefaylab.github.io/lab-manual/">The Fay Lab Manual</a> for inspiration on structure - you could also start there and make it your own.</p>
<p>Are you making onboarding documentation? Check out <a href="https://thefaylab.github.io/lab-manual/">The Fay Lab Manual</a> (now in Quarto!) for inspiration on structure - you could also start there and make it your own.</p>


</section>
Expand All @@ -200,6 +207,24 @@ <h3 class="anchored" data-anchor-id="inspiration">Inspiration</h3>
</main> <!-- /main -->
<script id="quarto-html-after-body" type="application/javascript">
window.document.addEventListener("DOMContentLoaded", function (event) {
const toggleBodyColorMode = (bsSheetEl) => {
const mode = bsSheetEl.getAttribute("data-mode");
const bodyEl = window.document.querySelector("body");
if (mode === "dark") {
bodyEl.classList.add("quarto-dark");
bodyEl.classList.remove("quarto-light");
} else {
bodyEl.classList.add("quarto-light");
bodyEl.classList.remove("quarto-dark");
}
}
const toggleBodyColorPrimary = () => {
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap");
if (bsSheetEl) {
toggleBodyColorMode(bsSheetEl);
}
}
toggleBodyColorPrimary();
const disableStylesheet = (stylesheets) => {
for (let i=0; i < stylesheets.length; i++) {
const stylesheet = stylesheets[i];
Expand Down Expand Up @@ -229,8 +254,14 @@ <h3 class="anchored" data-anchor-id="inspiration">Inspiration</h3>
manageTransitions('#quarto-margin-sidebar .nav-link', false);
if (alternate) {
enableStylesheet(alternateStylesheets);
for (const sheetNode of alternateStylesheets) {
if (sheetNode.id === "quarto-bootstrap") {
toggleBodyColorMode(sheetNode);
}
}
} else {
disableStylesheet(alternateStylesheets);
toggleBodyColorPrimary();
}
manageTransitions('#quarto-margin-sidebar .nav-link', true);
// Switch the toggles
Expand All @@ -245,6 +276,16 @@ <h3 class="anchored" data-anchor-id="inspiration">Inspiration</h3>
}
}
}
// Hack to workaround the fact that safari doesn't
// properly recolor the scrollbar when toggling (#1455)
if (navigator.userAgent.indexOf('Safari') > 0 && navigator.userAgent.indexOf('Chrome') == -1) {
manageTransitions("body", false);
window.scrollTo(0, 1);
setTimeout(() => {
window.scrollTo(0, 0);
manageTransitions("body", true);
}, 40);
}
}
const isFileUrl = () => {
return window.location.protocol === 'file:';
Expand Down Expand Up @@ -296,7 +337,9 @@ <h3 class="anchored" data-anchor-id="inspiration">Inspiration</h3>
// Switch to dark mode if need be
if (hasAlternateSentinel()) {
toggleColorMode(true);
}
} else {
toggleColorMode(false);
}
const icon = "";
const anchorJS = new window.AnchorJS();
anchorJS.options = {
Expand All @@ -318,7 +361,24 @@ <h3 class="anchored" data-anchor-id="inspiration">Inspiration</h3>
button.classList.add('code-copy-button-checked');
var currentTitle = button.getAttribute("title");
button.setAttribute("title", "Copied!");
let tooltip;
if (window.bootstrap) {
button.setAttribute("data-bs-toggle", "tooltip");
button.setAttribute("data-bs-placement", "left");
button.setAttribute("data-bs-title", "Copied!");
tooltip = new bootstrap.Tooltip(button,
{ trigger: "manual",
customClass: "code-copy-button-tooltip",
offset: [0, -8]});
tooltip.show();
}
setTimeout(function() {
if (tooltip) {
tooltip.hide();
button.removeAttribute("data-bs-title");
button.removeAttribute("data-bs-toggle");
button.removeAttribute("data-bs-placement");
}
button.setAttribute("title", currentTitle);
button.classList.remove('code-copy-button-checked');
}, 1000);
Expand Down Expand Up @@ -346,31 +406,50 @@ <h3 class="anchored" data-anchor-id="inspiration">Inspiration</h3>
for (var i=0; i<noterefs.length; i++) {
const ref = noterefs[i];
tippyHover(ref, function() {
let href = ref.getAttribute('href');
// use id or data attribute instead here
let href = ref.getAttribute('data-footnote-href') || ref.getAttribute('href');
try { href = new URL(href).hash; } catch {}
const id = href.replace(/^#\/?/, "");
const note = window.document.getElementById(id);
return note.innerHTML;
});
}
const findCites = (el) => {
const parentEl = el.parentElement;
if (parentEl) {
const cites = parentEl.dataset.cites;
if (cites) {
return {
el,
cites: cites.split(' ')
};
} else {
return findCites(el.parentElement)
}
} else {
return undefined;
}
};
var bibliorefs = window.document.querySelectorAll('a[role="doc-biblioref"]');
for (var i=0; i<bibliorefs.length; i++) {
const ref = bibliorefs[i];
const cites = ref.parentNode.getAttribute('data-cites').split(' ');
tippyHover(ref, function() {
var popup = window.document.createElement('div');
cites.forEach(function(cite) {
var citeDiv = window.document.createElement('div');
citeDiv.classList.add('hanging-indent');
citeDiv.classList.add('csl-entry');
var biblioDiv = window.document.getElementById('ref-' + cite);
if (biblioDiv) {
citeDiv.innerHTML = biblioDiv.innerHTML;
}
popup.appendChild(citeDiv);
const citeInfo = findCites(ref);
if (citeInfo) {
tippyHover(citeInfo.el, function() {
var popup = window.document.createElement('div');
citeInfo.cites.forEach(function(cite) {
var citeDiv = window.document.createElement('div');
citeDiv.classList.add('hanging-indent');
citeDiv.classList.add('csl-entry');
var biblioDiv = window.document.getElementById('ref-' + cite);
if (biblioDiv) {
citeDiv.innerHTML = biblioDiv.innerHTML;
}
popup.appendChild(citeDiv);
});
return popup.innerHTML;
});
return popup.innerHTML;
});
}
}
});
</script>
Expand Down
Loading

0 comments on commit 04c572f

Please sign in to comment.