zettelkasten/README.md
2025-11-04 23:50:03 +01:00

1.5 KiB

ztlk (Zettelkasten)

Et enkelt shell-script for å søke gjennom BibTeX-filer og åpne tilhørende PDF-er.

Det er gitt navnet ztlk etter Zettelkasten på tysk, et kortsystem for å håndtere referanser som bl.a. Walter Benjamin brukte under produksjonen av Passasjeverket, se Zettelkasten på Wikipedia.

Funksjonalitet

Scriptet leser BibTeX-filer, viser dem i en meny, og lar deg:

  • Søke og velge referanser
  • Åpne tilhørende PDF-filer
  • Kopiere BibTeX-nøkler til utklippstavlen

Avhengigheter

  • wmenu - dmenu for Wayland
  • wl-copy - Wayland clipboard (fra wl-clipboard)
  • sioyek - PDF-leser
  • awk - For parsing av BibTeX-filer

Konfigurasjon

Rediger følgende variabler i scriptet:

BIB_FIL="/sti/til/dine/*.bib"    # BibTeX-filer
PDF_DIR="/sti/til/pdf/"          # PDF-mappe
MENU_CMD="wmenu ..."             # Meny-kommando og styling
FONT="Iosevka Term Light 8"      # Font
PDF_CMD="sioyek"                 # PDF-leser

Filstruktur

PDF-filene må ha samme navn som BibTeX-nøklene:

@article{Smith2020,
  ...
}

→ PDF-fil: Smith2020.pdf

Bruk

./ztlk
  1. Scriptet viser alle referanser i en søkbar meny
  2. Velg en referanse
  3. Hvis PDF finnes, åpner wmenu med følgende handlinger:
    • open - Åpner PDF og kopierer nøkkelen
    • yank [key] - Kopierer bare nøkkelen
    • .. - Går tilbake til hovedmenyen
  4. Hvis PDF ikke finnes, kopieres nøkkelen automatisk

Nøkkelen kopieres i formatet @Smith2020 for enkel innsetting i LaTeX/Markdown-dokumenter.