Merge branch 'main' into docs/number-offset-html-only

Author: mcanouil

.github/DISCUSSION_TEMPLATE/feature-requests.yml

@@ -1,7 +1,8 @@
-title: "<The (missing) feature you want to discuss>"
+title: "The (missing) feature you want to discuss"
+labels: ["enhancement"]
 body:
   - type: markdown
-    attributes: 
+    attributes:
       value: |
         First, please check [Quarto Issues](https://github.com/quarto-dev/quarto-cli/issues) and [Feature Requests GitHub Discussions](https://github.com/quarto-dev/quarto-cli/discussions/categories/feature-requests) to see if your feature request has already been discussed.
         If it has, please consider adding a comment to the existing discussion instead of creating a new one.

.github/DISCUSSION_TEMPLATE/q-a.yml

@@ -1,44 +1,73 @@
-title: "<Your question in one sentence (e.g., How do I preview documents with Quarto?)>"
+title: "Your question in one sentence (e.g., How do I preview documents with Quarto?)"
 body:
   - type: markdown
-    attributes: 
+    attributes:
       value: |
         First, please check [Quarto Issues](https://github.com/quarto-dev/quarto-cli/issues) and [Q&A GitHub Discussions](https://github.com/quarto-dev/quarto-cli/discussions/categories/q-a) first to see if your question has already been asked.
         If it has, please consider adding a comment to the existing discussion instead of creating a new one.
 
         After checking, if you are not sure if your question has already been asked, please create a new discussion.
         We look forward to hearing from you.
 
-        Finally, try to describe the best you can what you want to achieve or what is your issue, especially by providing a complete self-contained reproducible example (as demonstrated in the below form).
+        Finally, try to describe the best you can what you want to achieve or what is your issue, especially by providing a complete self-contained reproducible example (consider reading our ["Bug Reports" guide](https://quarto.org/bug-reports.html)).
         This will help us to understand your question and answer it.
 
+        `````md
+        ````qmd
+        ---
+        title: "Reproducible Quarto Document"
+        format: html
+        engine: jupyter
+        ---
+
+        This is a reproducible Quarto document using `format: html`.
+        It is written in Markdown and contains embedded Python code.
+        When you run the code, it will produce a message.
+
+        ```{python}
+        print("Hello, world!")
+        ```
+
+        ![A placeholder image](https://placehold.co/600x400.png)
+
+        The end.
+        ````
+        `````
+
+        You can add some additional information that can help us to help you:
+
+        - What Quarto version are you using?  
+          You can find the version of Quarto you used by running `quarto --version` in your terminal.
+        - What operating system are you using?  
+          Linux Ubuntu 20.04, macOS 11.2.3, Windows 10, _etc._
+
         _Thank you for opening this discussion either to ask for help or to report a possible bug!_
   - type: textarea
     attributes:
       label: Description
       description: Start your question/report!
       placeholder: |
-          You can include Quarto document code which includes code blocks like this:
+        You can include Quarto document code which includes code blocks like this:
 
-          ````qmd
-          ---
-          title: "Hello Quarto!"
-          format: html
-          ---
+        ````qmd
+        ---
+        title: "Hello Quarto!"
+        format: html
+        ---
 
-          ```py
-          print("Hello Quarto!")
-          ```
-          ````
+        ```py
+        print("Hello Quarto!")
+        ```
+        ````
 
-          ---
+        ---
 
-          ### Additional information that can help us to help you
+        ### Additional information that can help us to help you
 
-          - What Quarto version are you using?  
-            You can find the version of Quarto you used by running `quarto --version` in your terminal.
-          - What operating system are you using?  
-            Linux Ubuntu 20.04, macOS 11.2.3, Windows 10, _etc._
+        - What Quarto version are you using?  
+          You can find the version of Quarto you used by running `quarto --version` in your terminal.
+        - What operating system are you using?  
+          Linux Ubuntu 20.04, macOS 11.2.3, Windows 10, _etc._
     validations:
       required: true
   - type: markdown

.github/DISCUSSION_TEMPLATE/show-and-tell.yml

@@ -1,7 +1,7 @@
-title: "<The item you want to talk about>"
+title: "The item you want to talk about"
 body:
   - type: markdown
-    attributes: 
+    attributes:
       value: |
         If you want to ask for a feature, please use the [Feature Requests GitHub Discussions](https://github.com/quarto-dev/quarto-cli/discussions/categories/feature-requests).
         If you want to ask for help, please use the [Q&A GitHub Discussions](https://github.com/quarto-dev/quarto-cli/discussions/categories/q-a).

.github/ISSUE_TEMPLATE/documentation.yml

@@ -0,0 +1,39 @@
+name: Documentation issue
+description: Report issues on quarto.org, give documentation feedback, or suggest documentation improvements
+labels: ["documentation"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Welcome to the quarto GitHub repository!
+
+        We are always happy to hear feedback from our users.
+
+        When reporting an issue with the documentation, please consider adding a link to the page you are referring to and a screenshot of the issue.
+
+        If you want to report a bug, please use the [Bug Reports GitHub Issues](https://github.com/quarto-dev/quarto-cli/issues/new?assignees=&labels=bug&projects=&template=bug_report.yml).
+        If you want to ask for a feature, please use the [Feature Requests GitHub Discussions](https://github.com/quarto-dev/quarto-cli/discussions/categories/feature-requests).
+        If you want to ask for help, please use the [Q&A GitHub Discussions](https://github.com/quarto-dev/quarto-cli/discussions/categories/q-a).
+
+        Thank you for using Quarto!
+
+  - type: dropdown
+    id: type-documentation
+    attributes:
+      label: What would you like to do?
+      options:
+        - Report an issue on quarto.org
+        - Give feedback or suggest an improvement
+      default: 0
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Description
+      description: Describe the issue, give feedback or suggest an improvement.
+      placeholder: Please describe your issue/feedback/improvement here. For issues on quarto.org, include a link to the page you are referring to and a screenshot of the issue.
+
+  - type: markdown
+    attributes:
+      value: "_Thanks for submitting this bug report, feedback or improvement suggestion!_"

.github/actions/docker/action.yml

@@ -34,11 +34,15 @@ runs:
 
     - if: ${{ inputs.daily == 'false' }}
       shell: bash
-      run: echo "LATEST_TAG=-t ${{ env.BASE_NM }}:latest" >> $GITHUB_ENV
+      run: |
+        echo "LATEST_TAG_BASE=-t ${{ env.BASE_NM }}:latest" >> $GITHUB_ENV
+        echo "LATEST_TAG_FULL=-t ${{ env.FULL_NM }}:latest" >> $GITHUB_ENV
 
     - if: ${{ inputs.daily == 'true' }}
       shell: bash
-      run: echo "DAILY_TAG=-t ${{ env.BASE_NM }}:daily" >> $GITHUB_ENV
+      run: |
+        echo "DAILY_TAG_BASE=-t ${{ env.BASE_NM }}:daily" >> $GITHUB_ENV
+        echo "DAILY_TAG_FULL=-t ${{ env.FULL_NM }}:daily" >> $GITHUB_ENV
 
     - name: Create Base DockerFile
       shell: bash
@@ -53,7 +57,7 @@ runs:
       shell: bash
       run: |
         echo ${{ inputs.token }} | docker login https://ghcr.io -u ${{ inputs.username }} --password-stdin
-        docker build -t ${{ env.BASE_NM }}:${{ inputs.version }} ${{ env.LATEST_TAG }} ${{ env.DAILY_TAG }} .
+        docker build -t ${{ env.BASE_NM }}:${{ inputs.version }} ${{ env.LATEST_TAG_BASE }} ${{ env.DAILY_TAG_BASE }} .
         docker push ${{ env.BASE_NM }} --all-tags
 
     - name: Create Full DockerFile
@@ -67,11 +71,10 @@ runs:
         RUN dpkg -i quarto-linux-amd64.deb && rm quarto-linux-amd64.deb
         RUN quarto install tinytex --no-prompt
         EOF
-    
+
     - name: Push Full Image
       shell: bash
       run: |
         echo ${{ inputs.token }} | docker login https://ghcr.io -u ${{ inputs.username }} --password-stdin
-        docker build -t ${{ env.FULL_NM }}:${{ inputs.version }} ${{ env.LATEST_TAG }} ${{ env.DAILY_TAG }} .
+        docker build -t ${{ env.FULL_NM }}:${{ inputs.version }} ${{ env.LATEST_TAG_FULL }} ${{ env.DAILY_TAG_FULL }} .
         docker push ${{ env.FULL_NM }} --all-tags
-        

.github/workflows/actions/launcher/action.yml

@@ -7,7 +7,7 @@ description: 'Builds the Quarto Launcher'
 runs:
   using: "composite"
   steps: 
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
       uses: actions-rs/toolchain@v1
       with:
         toolchain: 1.63.0

.github/workflows/actions/quarto-dev/action.yml

@@ -34,9 +34,19 @@ runs:
     - name: Basic dev mode sanity check
       shell: pwsh
       run: |
-        If ( "$(quarto --version)" -ne "99.9.9") { Exit 1 }
-        If ( $(quarto --paths | Select-String -Pattern "package[/\\]+dist[/\\]+share") -ne $null ) { Exit 1 }
-        If ( "$(git status --porcelain)" -ne "" ) { Exit 1 }
+        If ( "$(quarto --version)" -ne "99.9.9") { 
+          echo "Unexpected version detected: $(quarto --version)"
+          Exit 1 
+        }
+        If ( $(quarto --paths | Select-String -Pattern "package[/\\]+dist[/\\]+share") -ne $null ) { 
+          echo "Unexpected package/dist/share path detected: $(quarto --paths)"
+          Exit 1 
+        }
+        If ( "$(git status --porcelain)" -ne "" ) {
+          echo "Uncommitted changes detected:"
+          git status --porcelain
+          Exit 1 
+        }
 
     - name: Quarto Check
       if:  runner.debug == '1'