Reorganize Menus: Get Started and Concepts (no tutorials) (#261)

* get started and concept changes from #250 4751da3

* fix / remove title case from welcome page

* fix nav (rm top deploy and concepts workflow), fix run title

* tutorials don't exist in this PR

* remove the docs/shinylive pages and images (moved to get-started)

* re-direct+re-name learn shiny to get started

* replace screenshot of template dashboard with actual dashboard

* make dashboard example 90% width, fix trailing :::: link to create and run

* remove *.quarto_ipynb

* add reactivity example and clean up template example

* fix link to shiny create video in get started to link to docs

* add emojis to get started to match concepts

* round of edits + the component buttons aren't right

* make the buttons a bit smaller (still not flowing correctly)

* match colors to top menu, leave a reference to posit blue

* don't use bullets with emojis, just list with the emojis

* fix font awesome, and buttons not flowing correctly

* fix typo

* remove copy+pasted repeted text

* write a short blurb about the shiny example

* 200px button size a bit too big. moving to 150px

* split up welcome, now with more links

* add a point to open source

* fix same typo in #268

* chore: Use quarto v1.7.23

* feat: initial shiny app preview

* feat: cards design for gallery links

* chore(welcome): Tweak CTA section

* fix gallery image link and remove anchor

* chore: remove component section, plus more edits

* rename: what_is_shiny -> what-is-shiny

* chore(what-is-shiny): style link buttons, use bsicons, small edits

* fix(css): Fix source code blocks in tab content

* fix(css): Fix margins on code blocks in tabs only when direct children

* chore: simplify gallery highlight listing template

* Update get-started/install.qmd

Co-authored-by: Garrick Aden-Buie <[email protected]>

* Update get-started/install.qmd

Co-authored-by: Garrick Aden-Buie <[email protected]>

* Update get-started/create-run.qmd

Co-authored-by: Garrick Aden-Buie <[email protected]>

* Update get-started/create-run.qmd

Co-authored-by: Garrick Aden-Buie <[email protected]>

* Update get-started/create-run.qmd

Co-authored-by: Garrick Aden-Buie <[email protected]>

* Update get-started/create-run.qmd

Co-authored-by: Garrick Aden-Buie <[email protected]>

* Update get-started/create-run.qmd

Co-authored-by: Garrick Aden-Buie <[email protected]>

* edits to what is shiny

* some copy edits and changes

* move around text in extensibility

* fix css on mobile

* delete ipynb file

* add posit connect cloud help in debug

* add and update links

* feat: home page links, text color, etc.

* theming link to built-in theming link

* alt text for code, with image update, code, and settings for reproducibility

* Update get-started/what-is-shiny.qmd

Co-authored-by: Garrick Aden-Buie <[email protected]>

* Update get-started/what-is-shiny.qmd

Co-authored-by: Garrick Aden-Buie <[email protected]>

* Update get-started/install.qmd

Co-authored-by: Garrick Aden-Buie <[email protected]>

* copy edit what is shiny page

* what is shiny copy edit and links

* update shiny create video

* add fixed.py to error app examples

* debug with positron and vscode debugger and images

* link for positon and vs code

* add hover overlay to code and app for gallery

* add wording about production-ready

* add missing linebreak

* update install instructions to include uv

* fix links to components page where components not loading

* add code comment to copy + paste solution

* fix grammar

* turn off repo actions for index and what is shiny page

* revert get-started index gallery to ec5d46f

* point to template page whenever possible

* fix link similar to #282

* tweak(gallery-cards): Adjust alignment and links

* feat: editable code block

Co-authored-by: Daniel Chen <[email protected]>

* chore: use assets/code-welcome.py as source of truth for app code

* chore: adjust selection color in code block

* update why shiny bullets

* chore(why-shiny): Formatting and add link

* chore: add aliases for moved/renamed files

* clean up linking styles

* chore(what-is-shiny): Edit and improve Extensibility section

* chore: tweak wording

---------

Co-authored-by: Daniel Chen <[email protected]>
Co-authored-by: Garrick Aden-Buie <[email protected]>

Author: chendaniely

.github/workflows/deploy-docs.yml

@@ -7,7 +7,7 @@ on:
   workflow_dispatch:
 
 env:
-  QUARTO_VERSION: 1.6.42
+  QUARTO_VERSION: 1.7.23
 
 jobs:
   build:

.vscode/settings.json

@@ -44,5 +44,5 @@
     "flake8.args": [
         "--ignore=E501,E203"
     ],
-    "quarto.path": "~/.local/share/qvm/versions/v1.6.42/bin/quarto"
+    "quarto.path": "~/.local/share/qvm/versions/v1.7.23/bin/quarto"
 }

Makefile

@@ -13,7 +13,7 @@ VENV = venv
 PYBIN = $(VENV)/bin
 
 
-QUARTO_VERSION ?= 1.6.42
+QUARTO_VERSION ?= 1.7.23
 QUARTO_PATH = ~/.local/share/qvm/versions/v${QUARTO_VERSION}/bin/quarto
 
 .PHONY: install-quarto
@@ -23,7 +23,7 @@ install-quarto:
 		@echo "Error: qvm is not installed. Please visit https://github.com/dpastoor/qvm/releases/ to install it." >&2 \
 		exit 1; \
 	fi
-	qvm install ${QUARTO_VERSION}
+	qvm install v${QUARTO_VERSION}
 	@echo "🔹 Updating .vscode/settings.json"
 	@awk -v path="${QUARTO_PATH}" '/"quarto.path":/ {gsub(/"quarto.path": ".*"/, "\"quarto.path\": \"" path "\"")} 1' .vscode/settings.json > .vscode/settings.json.tmp && mv .vscode/settings.json.tmp .vscode/settings.json
 	@echo "🔹 Updating .github/workflows/deploy-docs.yml"

_quarto.yml

@@ -19,6 +19,7 @@ project:
     - api/core
     - api/testing
     - templates
+    - get-started
   resources:
     - /pypi/**
     - /robots.txt
@@ -73,7 +74,9 @@ website:
     logo-alt: The logo for Shiny for Python
     search: true
     left:
-      - text: "Learn Shiny"
+      - text: "Get Started"
+        file: get-started/index.qmd
+      - text: "Concepts"
         file: docs/overview.qmd
       - text: "Components"
         menu:
@@ -86,13 +89,6 @@ website:
           - text: "Templates"
             file: templates/index.qmd
             icon: code-square
-      - text: "Deploy"
-        menu:
-          - text: "Overview"
-            href: docs/deploy.qmd
-          - docs/deploy-cloud.qmd
-          - docs/deploy-on-prem.qmd
-          - docs/shinylive.qmd
       - text: "Gallery"
         file: gallery/index.qmd
       - text: "Playground"
@@ -227,8 +223,25 @@ website:
               href: "/layouts/arrange/index.html#column-nesting"
             - text: "Controlling for Page Size"
               href: "/layouts/arrange/index.html#controlling-for-page-width-and-height"
+    - id: get-started
+      style: "floating"
+      collapse-level: 1
+      align: left
+      contents:
+        - get-started/index.qmd
+        - get-started/what-is-shiny.qmd
+        - get-started/install.qmd
+        - get-started/create-run.qmd
+        - get-started/debug.qmd
+        - section: "Deploy"
+          contents:
+            - text: "Overview"
+              href: get-started/deploy.qmd
+            - get-started/deploy-cloud.qmd
+            - get-started/deploy-on-prem.qmd
+            - get-started/shinylive.qmd
 
-    - id: docs
+    - id: concepts
       style: "floating"
       collapse-level: 2
       align: left
@@ -237,10 +250,6 @@ website:
           contents:
             - docs/overview.qmd
             - docs/user-interfaces.qmd
-        - section: "<span class='emoji-icon'>💻</span>  __Workflow__"
-          contents:
-            - docs/install-create-run.qmd
-            - docs/debug.qmd
         - section: "<span class='emoji-icon'>🤖</span> __Generative AI__"
           contents:
             - docs/genai-inspiration.qmd

docs/_metadata.yml

@@ -1 +1 @@
-sidebar: get-started
+sidebar: concepts