"navbar" in single HTML document

[allefeld]

Description

I would like to activate the website project navbar at the top in a single HTML document (default project, format HTML). In this context it would not be a navigation bar, but describe an institutional setting, e.g. contain a logo and a programme name. The file is to be uploaded to a website which is generally differently managed (Moodle).

I was able to achieve that, but it is very hacky: I do declare a website project in _quarto.yml.

project:
  type: website
  post-render: ./post-render.sh
embed-resources: true

website:
  title: Programme Name
  navbar:
    logo: institution-logo.svg
    logo-href: "#"
  search: false

But then logo-href: "#" neutralizes the links enclosing logo and name, search: false suppresses the site search function,
embed-resources: true makes the HTML file self-contained, and the script post-render.sh copies only the needed HTML file out of the _site subdirectory and deletes the subdirectory:

#!/bin/bash

echo "$QUARTO_PROJECT_OUTPUT_FILES" | while IFS= read -r filename; do
    cp -p "$filename" .
done

rm -rf "_site/"

Is there a better way to do this?

---

Btw., _site contains site-libs despite embed-resources: true and search.json despite search: false.

[cscheid]

No good ones that I can think of - navbar was designed as a website-specific feature. (That's not to say we wouldn't like to eventually lift that restriction; only that this is how things are now.)

[allefeld]

Coming from Pandoc, I assumed that the feature is activated and populated via template variables, but I couldn't find anything navbar-related in https://github.com/quarto-dev/quarto-cli/tree/main/src/resources/formats/html/pandoc. I found https://github.com/quarto-dev/quarto-cli/tree/main/src/resources/projects/website/navigation but it only contains ejs files – so I think the navbar is not inserted using Pandoc's template language? Why not? The built-in templates are great, but customization is hard.

This somewhat related to my old #5134. Though I've since abandoned my quest to control everything (Quarto just has too many (great!) features for that), I still wish it would be easier to customize.

Maybe I should just copy & adapt the header code

<header id="quarto-header" class="headroom fixed-top headroom--top headroom--not-bottom">
    <nav class="navbar navbar-expand-lg " data-bs-theme="dark">
      <div class="navbar-container container-fluid">
      <div class="navbar-brand-container mx-auto">
…

and insert it via include-before-body.

[mcanouil]

You can customise single document via the HTML template or partials.
In addition, you can use a LUA filter to add control via YAML header/metadata.