Merge branch 'main' of https://github.com/mine-cetinkaya-rundel/quart…

…o-tdg
mine-cetinkaya-rundel · Jan 8, 2024 · 82978fd · 82978fd
2 parents 43163a0 + 5824a06
commit 82978fd
Show file tree

Hide file tree

Showing 11 changed files with 69 additions and 45 deletions.
diff --git a/.gitignore b/.gitignore
@@ -1,2 +1,3 @@
 /.quarto/
 _book/
+.Rproj.user
diff --git a/_quarto.yml b/_quarto.yml
@@ -20,13 +20,11 @@ book:
   chapters:
     - index.qmd
 
-    - part: hello.qmd
+    - part: overview.qmd
       chapters:
-        - quarto.qmd
-        - installation.qmd
-        - authoring.qmd
-        - computation.qmd
+        - hello.qmd
         - tools.qmd
+        - authoring.qmd
         - projects.qmd
         - publishing.qmd
         - look-under-hood.qmd

diff --git a/authoring.qmd b/authoring.qmd
@@ -1,9 +1,11 @@
----
-title: Authoring
----
+# Authoring {#sec-authoring}
 
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Mauris vel volutpat dui. Praesent vitae urna nec lorem feugiat consequat. Nunc ex nisi, posuere a lorem a, iaculis euismod tellus. Sed laoreet justo sit amet commodo suscipit. Curabitur gravida elit fermentum leo pulvinar, ac laoreet lectus iaculis. Quisque eu fringilla tellus, sit amet sollicitudin massa. In justo lorem, imperdiet laoreet interdum non, finibus in risus. In egestas fringilla nisl eu blandit.
+## Markdown text
 
-A change.
+## Code cells
 
-Another change.
+## Tables
+
+## Figures
+
+## etc.
diff --git a/computation.qmd b/computation.qmd
diff --git a/hello.qmd b/hello.qmd
@@ -1,14 +1,11 @@
----
-title: Hello Quarto
----
-
-In this section we introduce you to Quarto...
-
-- In [Chapter -@sec-quarto] we tell you what Quarto is...
-- In [Chapter -@sec-installation] we tell you how to install Quarto...
-- [Chapter -@sec-authoring] introduces you to components of a Quarto document such as markdown text, figures, tables, etc.
-- [Chapter -@sec-computation] discusses using executable code cells with Quarto in Python, R, Julia, and Observable. In this chapter we also go deeper into the execution engines: Jupyter and knitr.
-- In [Chapter -@sec-tools], we walk you through the experience of authoring with Quarto in JupyterLab, RStudio, and VSCode.
-- [Chapter -@sec-projects] introduces you to the concept of Quarto projects which allow you to combine and render Quarto documents in a given directory in harmony.
-- In [Chapter -@sec-publishing] is an overview of publishing options.
-- In [Chapter -@sec-look-under-hood] you can find more details on the orchestration Quarto does in going from plain text source code (or mixed-format Jupyter notebooks) to elegant outputs in multiple formats.
+# Hello Quarto {#sec-hello-quarto}
+
+## What is Quarto?
+
+## Installation
+
+## Tools for authoring
+
+At a minimum you need a (plain) text editor.
+
+But we recommend using an IDE.
diff --git a/installation.qmd b/installation.qmd
diff --git a/overview.qmd b/overview.qmd
@@ -0,0 +1,14 @@
+---
+title: Hello Quarto
+---
+
+In this section we introduce you to Quarto...
+
+- In [Chapter -@sec-quarto] we tell you what Quarto is...
+- In [Chapter -@sec-installation] we tell you how to install Quarto...
+- [Chapter -@sec-authoring] introduces you to components of a Quarto document such as markdown text, figures, tables, etc.
+- [Chapter -@sec-computation] discusses using executable code cells with Quarto in Python, R, Julia, and Observable. In this chapter we also go deeper into the execution engines: Jupyter and knitr.
+- In [Chapter -@sec-tools], we walk you through the experience of authoring with Quarto in JupyterLab, RStudio, and VSCode.
+- [Chapter -@sec-projects] introduces you to the concept of Quarto projects which allow you to combine and render Quarto documents in a given directory in harmony.
+- In [Chapter -@sec-publishing] is an overview of publishing options.
+- In [Chapter -@sec-look-under-hood] you can find more details on the orchestration Quarto does in going from plain text source code (or mixed-format Jupyter notebooks) to elegant outputs in multiple formats.
diff --git a/quarto-tdg.Rproj b/quarto-tdg.Rproj
@@ -0,0 +1,13 @@
+Version: 1.0
+
+RestoreWorkspace: Default
+SaveWorkspace: Default
+AlwaysSaveHistory: Default
+
+EnableCodeIndexing: Yes
+UseSpacesForTab: Yes
+NumSpacesForTab: 2
+Encoding: UTF-8
+
+RnwWeave: Sweave
+LaTeX: pdfLaTeX
diff --git a/quarto-tdg.scss b/quarto-tdg.scss
@@ -53,6 +53,6 @@ code a:any-link {
   text-decoration-color: #ccc;
 }
 
-pre {
+.sourceCode pre {
   background-image: linear-gradient(160deg,#f8f8f8 0,#f1f1f1 100%);
 }
diff --git a/quarto.qmd b/quarto.qmd
diff --git a/tools.qmd b/tools.qmd
@@ -1,5 +1,19 @@
----
-title: Tools
----
+# Tools {#sec-tools}
 
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Mauris vel volutpat dui. Praesent vitae urna nec lorem feugiat consequat. Nunc ex nisi, posuere a lorem a, iaculis euismod tellus. Sed laoreet justo sit amet commodo suscipit. Curabitur gravida elit fermentum leo pulvinar, ac laoreet lectus iaculis. Quisque eu fringilla tellus, sit amet sollicitudin massa. In justo lorem, imperdiet laoreet interdum non, finibus in risus. In egestas fringilla nisl eu blandit.
+## Whole game
+
+Here is a qmd file, go to the folder in your terminal, run quarto render
+
+## RStudio
+
+## JupyterLab
+
+- ipynb vs. qmd: from now on Quarto document usually means qmd but things translate to ipynb -- orient for qmd-specific language throughout book and how that translates to ipynb
+   		* and maybe another chapter somewhere specifically about this if this gets too long
+
+## VSCode
+
+## Choosing a tool
+
+- whatever you already use
+- one possible criterion: visual editor with various tools and mention how it will be called out