How do I remove a subdir from website project?

[ltbmb]

Description

I have a repository, that contains not only files for quarto. I want to use quarto (+profiles) to generate a website from the /site dir and pdf output from /docs dir. I want to have my _quarto.yaml file in the project root, so that the vs code extension works properly.

- /
  - docs/
    - chaper1.qmd
    - chapter2.qmd
    - ...
  - site/
    - dir1/
      - content1.1.qmd
      - content1.2.qmd
    - dir2/
      - content2.1.qmd
      - content2.2.qmd
    - index.qmd
  - _quarto.yaml

With the following _quarto.yaml

project:
  type: website
  output-dir: output

format:
  html: 
    theme: cosmo
    css: styles.css
    toc: true


website:
  title: "Awesome Page"
  navbar:
    left:
      - href: site/index.qmd
        text: Home
  sidebar:
    contents: site/**/*
    collapse-level: 1
  repo-url: https://gitlab.ourdomain.com/group/project
  repo-actions: [edit, source, issue]
  repo-subdir: site
  site-url: https://group.gitlab.ourdomain.com/project

With this setting I get a somewhat working website, however everything is located under the site directory inside of the output dir and I have to set the link in the navbar to site/index.qmd and sidebar contents to site/**/*.

Also directly inside the output directory another index.html is created. This just redirects to a (random?) page inside the wiki.

I want to remove the site dir in the output, and use my index.qmd as landing page. How can I achieve that?

[mcanouil]

Use post-render script to move the files.

This "issue" is because Quarto keeps the structure of your project. Since your source are under "site", the outputs also are because a _quarto.yml defines the root.

[ltbmb]

Just moving does not work. The links in html pages (e.g. sidebar) still contain the subdir.

[mcanouil]

Then either separate your projects or use render-targets (with all your documents in the same place) in your profile to render the appropriate documents.

As I said, _quarto.yml defines a single project where the file itself defines the root. That's the definition of a Quarto project so you have to design your structure with that in mind because it's very unlikely to change as it would be a very big breaking change.

Note that with post-render you are not limited to moving files, you can edit them.

[ltbmb]

Thank you for your incredible quick answers. I hoped there would be an option (which i missed previously) to specify the root directory like this which I could overwrite with profiles.

project:
  data-dir: site

I guess I will use seperate projects with _quarto.qmd in the respective directories.