website - new guides scaffolding

cscheid · cscheid · commit 72888959cee5 · 2026-06-11T12:23:35.000-05:00
diff --git a/docs/_quarto.yml b/docs/_quarto.yml
@@ -20,6 +20,33 @@ website:
       - href: errors/index.qmd
         text: Errors
   sidebar:
+    - id: Guides
+      collapse-level: 1
+      contents:
+        - section: "Guides"
+          href: guides/index.qmd
+          contents:
+            - guides/authoring/index.qmd
+            - guides/publishing/index.qmd
+    - id: Authoring
+      collapse-level: 1
+      contents:
+        - section: "Authoring Quarto Documents"
+          href: guides/authoring/index.qmd
+          contents:
+            - guides/authoring/markdown-basics.qmd
+            - guides/authoring/figures.qmd
+            - guides/authoring/tables.qmd
+            - guides/authoring/diagrams.qmd
+            - guides/authoring/shortcodes.qmd
+            - guides/authoring/brand.qmd
+            - guides/authoring/layout.qmd
+            - guides/authoring/scholarly-writing.qmd
+            - guides/authoring/computations.qmd
+            - guides/authoring/navigation.qmd
+            - guides/authoring/extensions.qmd
+            - guides/authoring/templates.qmd
+            - guides/publishing/index.qmd
     - id: guide
       collapse-level: 1
       contents:
diff --git a/docs/guide/index.qmd b/docs/guide/index.qmd
@@ -5,8 +5,8 @@ sidebar:
     - text: "Introduction"
       href: introduction.qmd
     - text: "Markdown"
-      href: ../authoring/markdown/index.qmd
-    - text: "Brand themes (_brand.yml)"
+      href: ../guides/authoring/markdown-basics.qmd
+    - text: "Brand themes (`_brand.yml`)"
       href: themes/brand.qmd
     - text: "Reading configuration (get-config)"
       href: get-config.qmd
diff --git a/docs/guides/authoring/brand.qmd b/docs/guides/authoring/brand.qmd
@@ -0,0 +1,5 @@
+---
+title: Brand
+---
+
+TBD.
diff --git a/docs/guides/authoring/computations.qmd b/docs/guides/authoring/computations.qmd
@@ -0,0 +1,5 @@
+---
+title: Computations
+---
+
+TBD.
diff --git a/docs/guides/authoring/diagrams.qmd b/docs/guides/authoring/diagrams.qmd
@@ -0,0 +1,5 @@
+---
+title: Diagrams
+---
+
+TBD.
diff --git a/docs/guides/authoring/elephant.png b/docs/guides/authoring/elephant.png
diff --git a/docs/guides/authoring/extensions.qmd b/docs/guides/authoring/extensions.qmd
@@ -0,0 +1,5 @@
+---
+title: Using Quarto extensions
+---
+
+TBD.
diff --git a/docs/guides/authoring/figures.qmd b/docs/guides/authoring/figures.qmd
@@ -0,0 +1,5 @@
+---
+title: Figures
+---
+
+TBD.
diff --git a/docs/guides/authoring/index.qmd b/docs/guides/authoring/index.qmd
@@ -0,0 +1,5 @@
+---
+title: Authoring Quarto Documents
+---
+
+TBD.
diff --git a/docs/guides/authoring/layout.qmd b/docs/guides/authoring/layout.qmd
@@ -0,0 +1,5 @@
+---
+title: Layout
+---
+
+TBD.
diff --git a/docs/guides/authoring/markdown-basics.qmd b/docs/guides/authoring/markdown-basics.qmd
@@ -2,10 +2,6 @@
 title: Authoring Markdown documents in Quarto 2
 ---
 
-## TBD
-
-- add tbl-colwidths to list-tables
-
 ## Overview
 
 Quarto 2 uses its own dialect of Markdown as its underlying document syntax.
diff --git a/docs/guides/authoring/navigation.qmd b/docs/guides/authoring/navigation.qmd
@@ -0,0 +1,5 @@
+---
+title: Navigation
+---
+
+TBD.
diff --git a/docs/guides/authoring/scholarly-writing.qmd b/docs/guides/authoring/scholarly-writing.qmd
@@ -0,0 +1,5 @@
+---
+title: Scholarly Writing
+---
+
+TBD.
diff --git a/docs/guides/authoring/shortcodes.qmd b/docs/guides/authoring/shortcodes.qmd
@@ -0,0 +1,5 @@
+---
+title: Shortcodes
+---
+
+TBD.
diff --git a/docs/guides/authoring/tables.qmd b/docs/guides/authoring/tables.qmd
@@ -0,0 +1,5 @@
+---
+title: Tables
+---
+
+TBD.
diff --git a/docs/guides/authoring/templates.qmd b/docs/guides/authoring/templates.qmd
@@ -0,0 +1,5 @@
+---
+title: Using doctemplates in Quarto
+---
+
+TBD.
diff --git a/docs/guides/index.qmd b/docs/guides/index.qmd
@@ -0,0 +1,5 @@
+---
+title: Guides
+---
+
+TBD.
diff --git a/docs/guides/publishing/index.qmd b/docs/guides/publishing/index.qmd
@@ -0,0 +1,5 @@
+---
+title: Publishing
+---
+
+TBD.

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +title: Brand
 +---
++
 +TBD.