Is it possible to disable quarto file path processing in projects?

[kbvernon]

Description

On Windows, paths like /path/to/image.png are converted to .\path/to/image.png. I want to disable this behavior. Is that possible?

[mcanouil]

@kbvernon Could you please add some context? Where does this happen? In single document? In projects? In YAML? In the prose?

[kbvernon]

i have this in _quarto.yml:

format:
  commonmark:
    from: "markdown-smart-implicit_figures"
    variant: "+yaml_metadata_block"
    wrap: preserve

and i run quarto render foo.qmd with this in foo.qmd:

![Rust language logo](/images/cuddlyferris.svg)

and the resulting foo.md shows:

<img src=".\images/Rlogo.svg" alt="R language logo"/>

the big picture context is processing code chunks with quarto/knitr and passing commonmark to zola to render a website, so I can bypass all the hardcoded bootstrap styling in quarto. i have everything working but paths are tripping me up, and im hoping to avoid lua at all costs.

[mcanouil]

To be clear, you want ![Rust language logo](/images/cuddlyferris.svg) to be <img src="/images/Rlogo.svg" alt="R language logo"/> or <img src="./images/Rlogo.svg" alt="R language logo"/>?

The root cause of the issue is during the project path normalisation/resolution pandoc.path.join is used. This function uses Windows specific separator:

• quarto-cli/src/resources/filters/quarto-pre/project-paths.lua

  Lines 6 to 13 in ff77c43

  	local function resolveProjectPath(path)
  	local offset = _quarto.projectOffset()
  	if offset and path and startsWith(path, '/') then
  	return pandoc.path.join({offset, pandoc.text.sub(path, 2, #path)})
  	else
  	return nil
  	end
  	end

There are no workaround that does not involve post-processing.

It's possible to change the internal behaviour, but not sure about all the possible side-effects.

local function resolveProjectPath(path)
  local offset = _quarto.projectOffset()
  if offset and path and startsWith(path, '/') then
    local joined = pandoc.path.join({offset, pandoc.text.sub(path, 2, #path)})
    return (joined:gsub('\\', '/'))
  else
    return nil
  end
end