Skip to content

Commit

Permalink
Built site for gh-pages
Browse files Browse the repository at this point in the history
  • Loading branch information
@tracykteal
tracykteal committed Nov 1, 2024
1 parent 67e2689 commit b2256fe
Show file tree
Hide file tree
Showing 27 changed files with 18,989 additions and 370 deletions.
2 changes: 1 addition & 1 deletion .nojekyll
View file
Original file line number Diff line number Diff line change
@@ -1 +1 @@
e49a0559
3f5c2364
158 changes: 78 additions & 80 deletions 1-1-hello/1-1-hello-reveal.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
<link href="../site_libs/quarto-contrib/countdown-0.5.0/countdown.css" rel="stylesheet"><meta charset="utf-8">
<meta name="generator" content="quarto-1.4.551">

<meta name="author" content="Mine Çetinkaya Rundel">
<meta name="author" content="Tracy Teal and Rich Iannone">
<title>Reproducible reports and presentations with Quarto and Great Tables - Hello, Quarto!</title>
<meta name="apple-mobile-web-app-capable" content="yes">
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
Expand Down Expand Up @@ -390,7 +390,7 @@
}
</style>
<meta property="og:title" content="Reproducible reports and presentations with Quarto and Great Tables - Hello, Quarto!">
<meta property="og:description" content="SciPy 2024: Unlocking Dynamic Reproducible DocumentsA Quarto Tutorial for Scientific Communication">
<meta property="og:description" content="pyOpenSci Fall Festival 2024: Reproducible reports and presentations with Quarto and Great Tables">
<meta property="og:site_name" content="Reproducible reports and presentations with Quarto and Great Tables">
</head>
<body class="quarto-light">
Expand All @@ -399,82 +399,48 @@

<section id="title-slide" class="quarto-title-block center">
<h1 class="title">Hello, Quarto!</h1>
<p class="subtitle">SciPy 2024: Unlocking Dynamic Reproducible Documents<br>A Quarto Tutorial for Scientific Communication</p>
<p class="subtitle">pyOpenSci Fall Festival 2024: Reproducible reports and presentations <br> with Quarto and Great Tables</p>

<div class="quarto-title-authors">
<div class="quarto-title-author">
<div class="quarto-title-author-name">
Mine Çetinkaya Rundel
Tracy Teal and Rich Iannone
</div>
<p class="quarto-title-affiliation">
Duke University + Posit PBC
Slides about Quarto from Mine Çetinkaya Rundel
</p>
</div>
</div>

</section>
<section>
<section id="pre-workshop" class="title-slide slide level1 center">
<h1>Pre-workshop</h1>

</section>
<section id="setup" class="slide level2 smaller">
<h2>Setup</h2>
<div class="your-turn">
<p><strong>1. Software:</strong> Download and install Python and Quarto:</p>
<ul>
<li>Python 3: <a href="https://www.python.org/downloads/" class="uri">https://www.python.org/downloads/</a></li>
<li>Quarto 1.5.53: <a href="https://quarto.org/docs/get-started/" class="uri">https://quarto.org/docs/get-started/</a></li>
</ul>
<p><strong>2. Tools:</strong> Dowload and install VS Code and Jupyter and Quarto extensions.</p>
<ul>
<li>VS Code: <a href="https://code.visualstudio.com/" class="uri">https://code.visualstudio.com/</a></li>
<li>Quarto Extension: <a href="https://marketplace.visualstudio.com/items?itemName=quarto.quarto" class="uri">https://marketplace.visualstudio.com/items?itemName=quarto.quarto</a></li>
<li>Jupyter Extension: <a href="https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter" class="uri">https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter</a></li>
</ul>
<p><strong>3. Exercises:</strong> Go to <a href="https://bit.ly/quarto-scipy24-exercises"><code>bit.ly/quarto-scipy24-exercises</code></a>, click on “Use this template” then “Create a new repository”. Click on the green <em>Code</em> button and copy the URL of the repo.</p>
<p><strong>4. Packages:</strong> Open VS Code. Under <em>Start</em>, click on <em>Clone Git Repository</em>, and paste the URL of the repo. Open the cloned project. In the Command Palette, go to <code>Python: Create Environment...</code> and choose <code>Venv</code>, then choose the (latest) Python version you have installed. Check the box for <code>requirements.txt</code> in the “Select dependencies to install” menu and hit OK.</p>
</div>
</section></section>
<section>
<section id="welcome" class="title-slide slide level1 center">
<h1>Welcome</h1>

</section>
<section id="code-of-conduct" class="slide level2 smaller">
<h2>Code of Conduct</h2>
<p>Attendees at SciPy 2024 are subject to the NumFOCUS Code of Conduct.</p>
<p>Be kind to others. Do not insult or put down others. Behave professionally. Remember that harassment and sexist, racist, or exclusionary jokes are not appropriate for NumFOCUS.</p>
<p>Attendees at this event are subject to the pyOpenSci Code of Conduct.</p>
<p>Be kind to others. Do not insult or put down others. Behave professionally. Remember that harassment and sexist, racist, or exclusionary jokes are not appropriate.</p>
<p>All communication should be appropriate for a professional audience including people of many different backgrounds. Sexual language and imagery is not appropriate.</p>
<p>NumFOCUS is dedicated to providing a harassment-free community for everyone, regardless of gender, sexual orientation, gender identity and expression, disability, physical appearance, body size, race, or religion. We do not tolerate harassment of community members in any form.</p>
<p>We’re dedicated to providing a harassment-free community for everyone, regardless of gender, sexual orientation, gender identity and expression, disability, physical appearance, body size, race, or religion. We do not tolerate harassment of community members in any form.</p>
<p>Thank you for helping make this a welcoming, friendly community for all.</p>

<aside><div>
<p><a href="https://www.scipy2024.scipy.org/#Code-of-Conduct">For more info and reporting a code of conduct incident</a></p>
</div></aside></section>
<section id="about-me" class="slide level2">
<h2>About me</h2>
</section>
<section id="about-us" class="slide level2">
<h2>About us</h2>
<div class="columns">
<div class="column" style="width:50%;">
<ul>
<li><p>Professor of the Practice<br>
Department of Statistical Science<br>
Duke University</p></li>
<li><p>Developer Educator, Posit PBC</p></li>
<li><p>Rich Iannone, Software Developer, Posit PBC</p></li>
<li><p>Tracy Teal, Open Source Program Director, Nixtla</p></li>
</ul>
</div><div class="column" style="text-align: center;">
<div class="quarto-figure quarto-figure-center">
<figure>
<p><img data-src="images/mine.png" class="quarto-figure quarto-figure-center" alt="Mine's headshot"></p>
</figure>
</div>
<p><strong>Mine Çetinkaya-Rundel</strong></p>
<p><a href="https://mine-cr.com">mine-cr.com</a></p>
<p><img data-src="images/mine.png" class="quarto-figure quarto-figure-center" alt="Mine's headshot"> <img data-src="images/mine.png" class="quarto-figure quarto-figure-center" alt="Mine's headshot"></p>
</div>
</div>
<ul>
<li>Teaching data analysis in computational notebooks for 10+ years</li>
<li>Teaching and using Quarto for 3+ years</li>
<li>Teaching data analysis for 10+ years</li>
<li>Teaching and using Quarto and gt/GT for 3+ years</li>
</ul>
</section>
<section id="about-you" class="slide level2">
Expand All @@ -487,7 +453,7 @@ <h2>About you</h2>
<li>What you hope to get out of this tutorial</li>
</ul>
</div>
<div id="timer_b12c6ed9e1006794122caa567e4604a06d1aea32" class="countdown" data-warn-when="0" data-update-every="1" data-play-sound="false" data-blink-colon="false" data-start-immediately="false" tabindex="0" style="right: 0;bottom: 0;">
<div id="timer_6c49686404f1501232ed21d03ee44ea17e122f6e" class="countdown" data-warn-when="0" data-update-every="1" data-play-sound="false" data-blink-colon="false" data-start-immediately="false" tabindex="0" style="right: 0;bottom: 0;">
<div class="countdown-controls">
<button class="countdown-bump-down">−</button>
<button class="countdown-bump-up">+</button>
Expand All @@ -504,16 +470,17 @@ <h2>Meeting you where you are</h2>
<ul>
<li><p>knows some Python + Markdown</p></li>
<li><p>has worked in VS Code and/or Jupyter Lab</p></li>
<li><p>wants to learn about Quarto</p></li>
<li><p>wants to learn about Quarto and great tables</p></li>
</ul>
</div>
</div><div class="column" style="width:50%;">
<div class="fragment fade-in">
<p>I’ll teach you</p>
<p>We’ll teach you</p>
<ul>
<li><p>More Markdown</p></li>
<li><p>New Quarto formats</p></li>
<li><p>New Quarto projects</p></li>
<li><p>Getting started with Quarto</p></li>
<li><p>Creating great looking tables</p></li>
<li><p>Creating professional looking documents</p></li>
</ul>
</div>
</div>
Expand Down Expand Up @@ -550,32 +517,15 @@ <h2>Workshop structure</h2>
<section id="getting-help" class="slide level2">
<h2>Getting help</h2>
<ul>
<li><p>During <strong>my turn</strong> and <strong>your turn</strong> segments – raise your hand</p></li>
<li><p>During <strong>our turn</strong> segments – also feel free to raise your hand for questions but if your question seems specific to your setup, I might come around and help during the next your turn break</p></li>
<li><p>During <strong>my turn</strong> and <strong>your turn</strong> segments – raise your virtual hand</p></li>
<li><p>During <strong>our turn</strong> segments – also feel free to raise your hand for questions but if your question seems specific to your setup, we might wait to help during the next your turn break</p></li>
</ul>
</section>
<section id="setup-1" class="slide level2 smaller">
<h2>Setup</h2>
<div class="your-turn">
<p><strong>1. Software:</strong> Download and install Python and Quarto:</p>
<ul>
<li>Python 3: <a href="https://www.python.org/downloads/" class="uri">https://www.python.org/downloads/</a></li>
<li>Quarto 1.5.53: <a href="https://quarto.org/docs/get-started/" class="uri">https://quarto.org/docs/get-started/</a></li>
</ul>
<p><strong>2. Tools:</strong> Dowload and install VS Code and Jupyter and Quarto extensions.</p>
<ul>
<li>VS Code: <a href="https://code.visualstudio.com/" class="uri">https://code.visualstudio.com/</a></li>
<li>Quarto Extension: <a href="https://marketplace.visualstudio.com/items?itemName=quarto.quarto" class="uri">https://marketplace.visualstudio.com/items?itemName=quarto.quarto</a></li>
<li>Jupyter Extension: <a href="https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter" class="uri">https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter</a></li>
</ul>
<p><strong>3. Exercises:</strong> Go to <a href="https://bit.ly/quarto-scipy24-exercises"><code>bit.ly/quarto-scipy24-exercises</code></a>, click on “Use this template” then “Create a new repository”. Click on the green <em>Code</em> button and copy the URL of the repo.</p>
<p><strong>4. Packages:</strong> Open VS Code. Under <em>Start</em>, click on <em>Clone Git Repository</em>, and paste the URL of the repo. Open the cloned project. In the Command Palette, go to <code>Python: Create Environment...</code> and choose <code>Venv</code>, then choose the (latest) Python version you have installed. Check the box for <code>requirements.txt</code> in the “Select dependencies to install” menu and hit OK.</p>
</div>
<div class="fragment">
<section id="section" class="slide level2">
<h2></h2>
<div class="hand-blue-large" style="text-align: center;">
<p>Let’s get started!</p>
</div>
</div>
</section></section>
<section>
<section id="what-is-quarto" class="title-slide slide level1 center">
Expand Down Expand Up @@ -627,7 +577,7 @@ <h1>How it works</h1>
<h2>Revisit: What is Quarto?</h2>
<p>Quarto is a command line interface (<strong>CLI</strong>) that renders plain text formats (<code>.qmd</code>, <code>.rmd</code>, <code>.md</code>) OR mixed formats (<code>.ipynb</code>/Jupyter notebook) into static PDF/Word/HTML reports, books, websites, presentations and more.</p>
<div class="fragment">
<div id="f4e55e07" class="cell" data-execution_count="1">
<div id="42a05258" class="cell" data-execution_count="1">
<div class="sourceCode cell-code" id="cb1" data-code-line-numbers="|1|2|10|15|16"><pre class="sourceCode numberSource python number-lines code-with-copy"><code class="sourceCode python"><span id="cb1-1"><a></a>Usage: quarto</span>
<span id="cb1-2"><a></a>Version: <span class="fl">1.5.53</span></span>
<span id="cb1-3"><a></a></span>
Expand Down Expand Up @@ -829,6 +779,54 @@ <h2>Many Quarto formats</h2>
</tr>
</tbody>
</table>
</section></section>
<section>
<section id="working-with-quarto-in-vscode-with-codespaces" class="title-slide slide level1 center">
<h1>Working with Quarto in VSCode with Codespaces</h1>

</section>
<section id="setup" class="slide level2 smaller">
<h2>Setup</h2>
<div class="your-turn">
<p>For this workshop we’ll be using GitHub Codespaces.</p>
<p>Instructions below for using Codespaces or if you’re working locally.</p>
<section id="on-codespaces" class="slide level2">
<h2>On Codespaces</h2>
<p><strong>1. Quarto environment:</strong> Load the Quarto Codespaces container</p>
<ul>
<li>Go to <a href="https://github.com/mcanouil/quarto-codespaces">mcanouil’s Quarto Codespaces</a></li>
<li>Click ‘Use this template’ and then ‘Open in a codespace’</li>
<li>Wait for the codespace to load!</li>
</ul>
<p><strong>2. Tools:</strong> Install some VS Code extensions.</p>
<ul>
<li>The Quarto extension and Quarto CLI are already installed. You’re all set there!</li>
<li>Install the Jupyter Extension: <a href="https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter" class="uri">https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter</a></li>
</ul>
<p><strong>3. Environment:</strong> Set up the environment</p>
<ul>
<li>Go to View -&gt; Command Palette</li>
<li>Search for and select <code>Python: Create Environment...</code> and choose <code>Venv</code>, then choose the (latest) Python version.</li>
<li>Install jupyter. At the terminal type <code>python3 -m pip install jupyter</code></li>
</ul>
<p><strong>4. Exercises:</strong> Get the exercises from <a href="https://github.com/tracykteal/quarto-GT-pyopensci-exercises"><code>https://github.com/tracykteal/quarto-GT-pyopensci-exercises</code></a>.</p>
<ul>
<li>Go to the Terminal in your codespace</li>
<li>Type <code>git clone https://github.com/tracykteal/quarto-GT-pyopensci-exercises.git</code></li>
<li>You’ll see the directory <code>quarto-GT-pyopensci-exercises</code> appear in your file navigator.</li>
<li>Go into that directory.</li>
</ul>
<p><strong>5. Packages:</strong> Install some packages.</p>
<p>Open <code>setup.qmd</code> and run the installation code block to install:</p>
<ul>
<li>polars</li>
<li>pandas</li>
<li>great_tables</li>
<li>selenium</li>
<li>plotnine</li>
</ul>
</section>
</div>
</section>
<section id="your-turn" class="slide level2">
<h2>Your turn</h2>
Expand All @@ -841,7 +839,7 @@ <h2>Your turn</h2>
<li><p>Change the html theme to <code>sketchy</code>. See <a href="https://quarto.org/docs/output-formats/html-themes.html" class="uri">https://quarto.org/docs/output-formats/html-themes.html</a> for documentation on HTML theming.</p></li>
</ul>
</div>
<div id="timer_b12c6ed9e1006794122caa567e4604a06d1aea32" class="countdown" data-warn-when="0" data-update-every="1" data-play-sound="false" data-blink-colon="false" data-start-immediately="false" tabindex="0" style="right: 0;bottom: 0;">
<div id="timer_6c49686404f1501232ed21d03ee44ea17e122f6e" class="countdown" data-warn-when="0" data-update-every="1" data-play-sound="false" data-blink-colon="false" data-start-immediately="false" tabindex="0" style="right: 0;bottom: 0;">
<div class="countdown-controls">
<button class="countdown-bump-down">−</button>
<button class="countdown-bump-up">+</button>
Expand Down Expand Up @@ -882,9 +880,9 @@ <h2>Questions</h2>
</div>

<div class="quarto-auto-generated-content">
<p><img src="../images/quarto-scipy24-slide-logo.png" class="slide-logo"></p>
<p><img src="../images/pyQuartoGT.png" class="slide-logo"></p>
<div class="footer footer-default">
<p>🔗 <a href="https://bit.ly/quarto-scipy24">bit.ly/quarto-scipy24</a></p>
<p>🔗 <a href="https://tracykteal.github.io/quarto-GT-pyopensci/">https://tracykteal.github.io/quarto-GT-pyopensci/</a></p>
</div>
</div>
</section></section>
Expand Down
Loading

0 comments on commit b2256fe

Please sign in to comment.