quarto-dev / quarto-dev/quarto-cli
`quarto publish confluence` fails to find, or correctly link parent pages.
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 6k
- Forks
- 458
- Avg merge
- 1d 9h
- Merged PRs (30d)
- 41
Description
Bug description
I created a git repository to reproduce this issue. Please clone this git repo for a reprex.
It seems that sub pages cannot reference parent pages accurately with the [text](PATH/To/QMD) syntax specifically for quarto publish confluence and when using ../File.qmd or /file.qmd.
It should be noted that this syntax works perfectly when viewing the rendered html pages from RStudio, but otherwise not.
Description of the Project structure
├── index.qmd
├── _quarto.yml
├── README.md
├── reports
│ ├── 2022-01.qmd
│ └── 2022-03.qmd
└── section.qmd
Files and their links:
index.qmdcontains 4 links: one link to each of the sub pages and then 2 links tosection.qmd.- Both of the table links work on confluence 👍
[go to section](section.qmd#Challenges and Opportunities)links to the page but not the section 👎 .- When copying the link from confluence and manually pasting it (the second link), the following works:
[New syntax](section.qmd#Challenges-and-Opportunities%5BinlineExtension%5D)
2022-01.qmdcontains 2 links, both trying to reference the top levelindex.qmdexcept one using../index.qmdand the other using/index.qmd. 👎 Does not work but for different reasons.- In the
../index.qmdsyntax, the link is never created. - In the
/index.qmdsyntax, A link is created but it redirects to the root uri on confluence, i.e. if your confluence site was namedsite.atlassian.netthen/index.qmdsyntax creates a link that redirects tohttps://site.atlassian.net/index.qmd
- In the
2022-03.qmdcontains only 1 link, still using../index.qmdsyntax except this file doesn't try and specify a section to jump to, still doesn't work 👎
Steps to reproduce
git@github.com:jtlandis/quarto-confluence-link.git
cd quarto-confluence-link
quarto publish confluence
Expected behavior
No response
Actual behavior
No response
Your environment
- IDE: RStudio
- OS: RHEL8
- Confluence: Cloud
Quarto check output
quarto check
[✓] Checking versions of quarto binary dependencies...
Pandoc version 3.1.1: OK
Dart Sass version 1.55.0: OK
[✓] Checking versions of quarto dependencies......OK
[✓] Checking Quarto installation......OK
Version: 1.3.450
Path: /usr/local/quarto-1.3.450/bin
[✓] Checking basic markdown render....OK
[✓] Checking Python 3 installation....OK
Version: 3.6.8
Path: /usr/bin/python3
Jupyter: (None)
Jupyter is not available in this Python installation.
Install with python3 -m pip install jupyter
[✓] Checking R installation...........OK
Version: 4.3.2
Path: /usr/lib64/R
LibPaths:
- /home/justinlandis/R/x86_64-redhat-linux-gnu-library/4.3
- /usr/lib64/R/library
- /usr/share/R/library
knitr: 1.43
rmarkdown: 2.23
[✓] Checking Knitr engine render......OK
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Clone the linked quarto-confluence-link repository and run quarto publish confluence with the listed index.qmd, section.qmd, and reports pages. Compare the generated Confluence links for parent pages, relative paths, absolute paths, and anchors with the working rendered HTML links. Done means all documented parent-page and section links resolve correctly in Confluence Cloud.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript
- Domain
- tooling
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 52/100