From 323c9d4f576ec3f9e0f9c21cbf50454d3a1e5eef Mon Sep 17 00:00:00 2001
From: Charlotte Wickham <cwickham@gmail.com>
Date: Wed, 26 Jun 2024 11:43:20 -0700
Subject: [PATCH] Rework advanced section

---
 _quarto.yml                                | 32 ++++++++++------------
 docs/{extensions => advanced}/nbfilter.qmd |  3 ++
 docs/guide/guide.yml                       | 16 -----------
 3 files changed, 17 insertions(+), 34 deletions(-)
 rename docs/{extensions => advanced}/nbfilter.qmd (93%)

diff --git a/_quarto.yml b/_quarto.yml
index 8f8478bbea..17b4066e4e 100644
--- a/_quarto.yml
+++ b/_quarto.yml
@@ -121,13 +121,7 @@ website:
                 - docs/authoring/figures.qmd
                 - docs/authoring/tables.qmd
                 - docs/authoring/diagrams.qmd
-                - section: "Shortcodes"
-                  href: docs/authoring/shortcodes.qmd
-                  contents:
-                    - text: "Placeholder Image"
-                      href: docs/authoring/placeholder.qmd
-                    - text: "Lorem Lipsum Text"
-                      href: docs/authoring/lipsum.qmd
+                - docs/authoring/shortcodes.qmd            
                 - docs/authoring/videos.qmd
                 - text: "Embeds"
                   href: docs/authoring/notebook-embed.qmd
@@ -151,6 +145,16 @@ website:
                           href: docs/authoring/cross-references-custom.qmd
                     - docs/authoring/create-citeable-articles.qmd
                     - docs/authoring/appendices.qmd
+                - section: Advanced Authoring
+                  contents:
+                    - docs/authoring/includes.qmd
+                    - docs/authoring/variables.qmd
+                    - docs/authoring/conditional.qmd
+                    - text: "Placeholder Images"
+                      href: docs/authoring/placeholder.qmd
+                    - text: "Placeholder Text"
+                      href: docs/authoring/lipsum.qmd
+                    - docs/authoring/language.qmd
             - section: "Computations"
               contents:
                 - docs/computations/python.qmd
@@ -204,6 +208,7 @@ website:
                     - docs/output-formats/html-multi-format.qmd
                     - docs/output-formats/html-lightbox-figures.qmd
                     - docs/output-formats/html-publishing.qmd
+                    - docs/output-formats/page-layout.qmd
                 - section: "PDF"
                   contents:
                     - docs/output-formats/pdf-basics.qmd
@@ -404,17 +409,8 @@ website:
                 - docs/projects/scripts.qmd
                 - docs/projects/virtual-environments.qmd
                 - docs/projects/binder.qmd
-            - section: "Advanced"
-              contents:
-                - docs/authoring/includes.qmd
-                - docs/authoring/variables.qmd
-                - docs/output-formats/page-layout.qmd
-                - docs/authoring/language.qmd
-                - docs/authoring/conditional.qmd
-                - docs/extensions/nbfilter.qmd
-                - section: "Jupyter"
-                  contents:
-                    - docs/advanced/jupyter/kernel-execution.qmd
+            - text: "Advanced"
+              href: docs/advanced/index.qmd
     - id: extensions
       title: "Extensions"
       contents:
diff --git a/docs/extensions/nbfilter.qmd b/docs/advanced/nbfilter.qmd
similarity index 93%
rename from docs/extensions/nbfilter.qmd
rename to docs/advanced/nbfilter.qmd
index af309c5e5c..5bb637f428 100644
--- a/docs/extensions/nbfilter.qmd
+++ b/docs/advanced/nbfilter.qmd
@@ -1,5 +1,8 @@
 ---
 title: "Notebook Filters"
+summary: Pre-processing Jupyter notebooks prior to conversion to markdown
+aliases:
+  - /docs/extenstions/nbfilter.html
 ---
 
 ## Overview
diff --git a/docs/guide/guide.yml b/docs/guide/guide.yml
index aee18ba4b2..edec445aee 100644
--- a/docs/guide/guide.yml
+++ b/docs/guide/guide.yml
@@ -180,19 +180,3 @@
       href: ../projects/scripts.qmd
     - text: Virtual Environments
       href: ../projects/virtual-environments.qmd
-
-- title: Advanced
-  subtitle: Refine documents with advanced tools
-  links:
-    - text: "Includes"
-      href: ../authoring/includes.qmd
-    - text: "Variables"
-      href: ../authoring/variables.qmd
-    - text: "Page Layout"
-      href: ../output-formats/page-layout.qmd
-    - text: "Document Language"
-      href: ../authoring/language.qmd
-    - text: "Conditional Content"
-      href: ../authoring/conditional.qmd
-    - text: "Notebook Filters"
-      href: ../extensions/nbfilter.qmd