9.2 – Meldungen

Alle Meldungen beginnen mit [layout-box] und erscheinen einmal je Ursache, nicht einmal je Seite. Das ist Absicht: Bei 300 Seiten und einer fehlenden Datei wären 300 gleiche Zeilen keine Hilfe.

Refusing to read "…" outside of "…"

Der Pfad in file führt aus dir hinaus. Die Box gibt nichts aus.

Meist ein .. zu viel, oder ein dir, das nicht das ist, was man dachte. Siehe 2.2.

Snippet file not found: /voller/pfad/zur/datei

Die Datei gibt es an dieser Stelle nicht. Die Meldung nennt den vollen Pfad — der Vergleich mit dem, wo die Datei wirklich liegt, ist damit der schnellste Weg zur Ursache.

Im Modus --serve erscheint zusätzlich eine gestrichelte Box auf der Seite. Im normalen Bau bleibt die Stelle leer.

Could not read snippet file (…)

Die Datei ist da, ließ sich aber nicht lesen — Rechte, ein Verzeichnis statt einer Datei, ein kaputter Symlink. In Klammern steht, was das Betriebssystem gemeldet hat. Sonst verhält sie sich wie die vorige: nichts im normalen Bau, eine Box unter --serve.

`collapsible` requires a `title`; rendering non-collapsible

collapsible: true ohne title. Die Box wird normal gerendert, nur eben nicht aufklappbar. Steht die Ursache in einem byLang-Eintrag, nennt die Meldung ihn mit.

Sie entsteht beim Aufbau der Instanz und kennt deshalb nur die Konfiguration. Kommt collapsible aus dem Frontmatter einer Seite, bleibt die Konsole still, und die Box wird stumm nicht aufklappbar gerendert.

Keine Meldung, keine Box

Dafür gibt es zwei Ursachen, und beide sind kein Fehler:

• Das Schnipsel ist leer. Eine Box ohne Inhalt gibt nichts aus — bewusst, siehe 6.2.
• Die Seite hat die Box im Frontmatter ausgeblendet.

Wenn gar nichts passiert

Steht die Box nicht da und schweigt auch die Konsole, ist meist der Eintrag selbst nicht wirksam: enabled: false, oder das Plugin ist installiert, aber nicht in der quartz.config.yaml eingetragen.

Wenn die Box woanders steht

Ein Eintrag ohne layout-Block erzeugt trotzdem eine Instanz. Quartz stellt jede Komponente, die keine Stelle nennt, an die Vorgabe ihres Manifests — bei diesem Plugin links, mit priority: 15 (3.2). Wer eine Box durch Löschen des layout-Blocks abschalten will, bekommt sie also in der linken Spalte; abschalten lässt sie sich mit enabled: false.