Konfigurasjon av Quartz
Under følger en oversikt over det utvalget av konfigurasjonsmuligheter jeg anbefaler å se over. For en komplett liste, se Quartz sin dokumentasjon.
Fil: quartz.config.ts
Konfigurasjonsblokk
Alt under configuration inneholder innstillinger som påvirker hele nettsiden.
| Konfigurasjon | Beskrivelse |
|---|---|
pageTitle | Tittel på nettsiden; vises øverst til venstre |
analytics | Hvilken tilbyder som skal brukes for analytics; sett null for å deaktivere |
locale | Språk for nettsiden; krever at tilsvarende språk er satt opp |
baseUrl | URL for nettsiden; for Vercel bør denne settes til <project name>-<scope name>.vercel.app |
ignorePatterns | En liste av GLOB-mønstre for mapper og filer fra Obsidian-hvelvet som ikke skal brukes i den ferdiggenererte nettsiden |
theme.typography | Hvilke fonter som skal brukes på nettsiden |
theme.colors | Hvilke farger som skal brukes på nettsiden; støtter lightMode og darkMode |
Utvidelser og transformasjoner
Quartz tilbyr et sett av transformative funksjoner, og kaller disse for plugins. Disse definerer hvilke sider som vises, og hvordan de vises.
| Utvidelse | Beskrivelse |
|---|---|
transformers.Plugin.ObsidianFlavoredMarkdown() | Fjern enableInHtmlEmbed (eller sett til true) dersom du opplever problemer med Mermaid |
transformers.Plugin.Latex() | Endre renderEngine til mathjax om du foretrekker denne |
filters.Plugin.RemoveDrafts() | Fjerner filer med draft: true i frontmatter. Kan byttes ut med Plugin.ExplicitPublish() |
filters.Plugin.ExplicitPublish() | Fjerner filer uten publish: true i frontmatter. |
emitters.Plugin.ContentIndex() | Sitemap og RSS kan deaktiveres her dersom dere ikke ønsker dette |
Fil: quartz.layout.ts
Oppsettet - layout-en - til den genererte nettsiden kan alltid overskrives av enkelte utvidelser (emitters), men standardoppsettet er konfigurert i quartz.layout.ts. Full dokumentasjon for hvordan dette fungerer finner dere her.
| Fra | Til | Beskrivelse |
|---|---|---|
Component.Breadcrumb() | ...({ rootName: "Hjem" } | Endrer første node i brødsmulerekken til “Hjem” |
Component.DarkMode() | // ... | Deaktiver mørk modus for nettsiden |
Merk at disse komponentene kan dukke opp flere ganger i quartz.layout.ts, og må endres alle steder for at oppførselen skal bli konsekvent.