6  Turning it off

This chapter uses position: none. There is no automatically injected control anywhere on this page — not in the sidebar, not in the navigation bar and not floating in a corner. The extension ran and deliberately skipped injection.

6.1 Why a page might opt out

A book rarely wants the same treatment on every page. An index, a preface, a list of abbreviations or a landing page usually has nothing worth citing on its own, and offering a citation there is noise.

---
title: "Preface"
extensions:
  cite-this:
    position: none
---

6.2 none against inline

They look similar and are not the same thing:

	injected control	shortcode still works
none	no	yes
inline	no	yes

Both values leave shortcodes available. Use inline when that is the intended project-wide placement mode; use none when automatic injection is disabled for a page but an explicitly authored shortcode should still be respected.

6.3 Turning it off for a whole project

Setting it in _quarto.yml disables the extension across every page, which is useful when you want the filter installed but dormant — for a draft, or for a build where citations are not wanted:

extensions:
  cite-this:
    position: none

Individual pages can still opt back in, because page front matter overrides project configuration:

---
title: "Methods"
extensions:
  cite-this:
    position: title
---

6.4 Restricting by format

position decides where; formats decides whether. A project that renders to both HTML and PDF can emit the control only in HTML:

extensions:
  cite-this:
    formats: [html]

This is the default. The PDF then carries no citation block at all — not even the static fallback described in The shortcode.