quarto-dev / quarto-dev/quarto-cli

Internal links in "About" templates

Open
#10,437 10 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

about-page bug websites
Dominant language
JavaScript
Stars
6k
Forks
458
Avg merge
1d 9h
Merged PRs (30d)
41

Description

Bug description

When using one of the built-in "About" templates, internal links (to pages or files) are broken and result in the message "can’t find the file at /index.html." It appears that the host url does not get properly inserted.

Steps to reproduce

Make a Quarto website using the built-in RStudio template and edit the file about.qmd to read:

---
title: "Finley Malloc"
about:
  id: hero-heading
  template: jolla
  image: profile.jpg
  links:
    - icon: twitter
      text: twitter
      href: https://twitter.com
    - icon: file-pdf
      text: broken link to index
      href: index.qmd
---

About this site

```{r}
1 + 1
```

[A link to index that does work](index.qmd)

(Or any other internal page or file in place of index.qmd).

Expected behavior

The rendered html page contains a link to the page "index.html" (or any other internal page or file).

*When using the RStudio browser the link does work, but the rendered html does not work in a browser

Actual behavior

The rendered html has a link that tries to go to the page "file:///index.html" (no host url or local location) which produces the error message "File not found".

Your environment
  • IDE: RStudio Version 2024.04.2+764 (2024.04.2+764)
  • MacOS 14.2.1
Quarto check output
Quarto 1.4.554
[✓] Checking versions of quarto binary dependencies...
      Pandoc version 3.1.11: OK
      Dart Sass version 1.69.5: OK
      Deno version 1.37.2: OK
[✓] Checking versions of quarto dependencies......OK
[✓] Checking Quarto installation......OK
      Version: 1.4.554
      Path: /Applications/quarto/bin

[✓] Checking tools....................OK
      TinyTeX: (external install)
      Chromium: (not installed)

[✓] Checking LaTeX....................OK
      Using: TinyTex
      Path: /Users/elissa/Library/TinyTeX/bin/universal-darwin
      Version: 2024

[✓] Checking basic markdown render....OK

[✓] Checking Python 3 installation....OK
      Version: 3.11.7
      Path: /opt/homebrew/opt/python@3.11/bin/python3.11
      Jupyter: 5.7.1
      Kernels: python3

[✓] Checking Jupyter engine render....OK

[✓] Checking R installation...........OK
      Version: 4.4.1
      Path: /Library/Frameworks/R.framework/Resources
      LibPaths:
        - /Library/Frameworks/R.framework/Versions/4.4-arm64/Resources/library
      knitr: 1.46
      rmarkdown: 2.27

[✓] Checking Knitr engine render......OK

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Reproduce the issue with the built-in RStudio template by editing about.qmd and rendering the site. Inspect the generated HTML for the href produced by the template link and compare it with the working Markdown link; done means internal links from the About template resolve to the rendered page or file rather than file:///index.html.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
web-dev
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.