# Kontakty

Ako funguje export Kontaktov, od pripojenia po riešenie problémov.

## Pripojenie

Stlačte "Connect" pri Kontaktoch na úvodnej obrazovke Exportera a potom "Open Contacts Folder". Panel sa otvorí vo vašom priečinku AddressBook, `~/Library/Application Support/AddressBook`: stlačte "Select This Folder". Exporter číta iba tento priečinok, bez žiadosti o povolenie, a číta z neho aj vaše karty z iCloudu a Exchange. Potom zvoľte, kam pôjdu súbory, a stlačte "Use This Folder".

## Kam sa súbory ukladajú

Jeden súbor Markdown na kartu, `Anna Kowalski.md`. Dvaja ľudia s rovnakým menom dostanú každý krátku príponu s id, takže žiadny súbor neprepíše ten druhý. Priečinok priamo vo vašom domovskom priečinku, napríklad `~/Documents`, dostane vnútri priečinok `contacts-export`; hlbší priečinok, napríklad `~/Documents/contacts`, sa použije tak, ako je.

"Organize" na karte určuje rozloženie priečinkov a cesta na konci toho istého riadka ukazuje, kam karta príde:

| organize | kam sa súbory ukladajú |
| --- | --- |
| one folder | najvyššia úroveň priečinka exportu |
| by group | `groups/<group>/`; karta v dvoch skupinách sa zapíše raz, pod prvú |
| by company | `companies/<company>/` |

Jeho zmena presunie súbory pri ďalšej synchronizácii a karta to uvedie. By group a by company ukazujú strom, ktorý končí položkami "Not in a group" a "No company"; one folder ukazuje karty s tlačidlom recent pre 100 naposledy zmenených.

## Čo sa exportuje

Karty zaškrtnuté na karte zdroja, so všetkými poľami, ktoré majú. Vynechajú sa záznamy iba s e-mailom, ktoré Gmail zbiera pre každú adresu, na ktorú ste písali. Export do vCard ani CSV neexistuje: súbor `.vcf` získate v Kontaktoch cez Súbor > Exportovať > Exportovať vCard.

## Formát

Vždy Markdown.

## Súbor

Každý kľúč sa objaví iba vtedy, keď má karta hodnotu. Hodnoty v zoznamoch nesú svoje označenie, napríklad `+1 415 555 0123 (mobile)`.

| kľúč | obsahuje |
| --- | --- |
| `title` | meno |
| `aliases` | prezývka a rodné priezvisko |
| `id`, `source_url` | id karty a odkaz `addressbook://`, ktorý ju otvorí v Kontaktoch |
| `created`, `modified` | kedy bola karta vytvorená a naposledy zmenená |
| `organization`, `job_title`, `department` | pracovné údaje |
| `birthday` | narodeniny |
| `email`, `phone` | prvý e-mail a telefón, bez označenia, pre šablóny |
| `emails`, `phones`, `addresses`, `urls` | všetky, každý so svojím označením |
| `social`, `im` | sociálne profily a účty na posielanie správ |
| `dates`, `relationships` | ďalšie dátumy a súvisiace mená, napríklad `father: Tom Kowalski` |
| `groups` | skupiny v Kontaktoch, do ktorých karta patrí |
| `conversations` | odkazy na konverzácie karty, keď sa exportujú aj Správy |

Telo tvorí meno, pracovný riadok a poznámka karty:

```markdown
---
title: "Anna Kowalski"
id: "410FE041:ABPerson"
created: 2019-04-02T10:15:33
modified: 2026-08-30T19:02:11
source_url: "addressbook://410FE041:ABPerson"
organization: "Northwind Studio"
job_title: "Art director"
birthday: 1990-12-10
email: "anna@northwind.example"
phone: "+1 415 555 0123"
phones:
  - "+1 415 555 0123 (mobile)"
groups:
  - "Studio"
---

# Anna Kowalski

Art director · Northwind Studio

Met at the print fair.
```

## Zadarmo a po odomknutí

Vašich prvých 100 kariet spomedzi tých, ktoré ste zaškrtli, sa exportuje a ďalej synchronizuje zadarmo a vymazaná karta svoje miesto uvoľní; ostatné potrebujú jednorazové odomknutie ([ceny](https://exporter.dev/pricing)).

## Synchronizácia a úplná opätovná synchronizácia

Po prvom "Sync Now" upravená karta prepíše svoj súbor, kým Exporter beží, a súbor vymazanej karty zmizne pri ďalšej synchronizácii.

"Full Resync" sa najprv opýta, potom odstráni iba súbory, ktoré zapísal Exporter, znova zapíše všetky karty a znova vyberie 100 kariet zadarmo. Všetko ostatné v priečinku exportu zostane.

## Problémy a opravy

- "no contacts database in that folder (pick the AddressBook folder itself)": stlačte znova "Connect" a vyberte priečinok, v ktorom sa panel otvorí
- súbory sa presunuli do iných priečinkov: zmenilo sa "Organize". Zvoľte rozloženie, ktoré chcete, a stlačte "Sync Now"
- chýba karta: je za hranicou 100 kariet zadarmo, nie je zaškrtnutá, alebo ide o záznam iba s e-mailom z Gmailu
- karta zlyhala: `last sync` ukazuje červený odkaz "details" s kartami, ktoré zlyhali, a pri každej odkaz "open"

## Related

- [Kontakty](https://exporter.dev/sk/contacts): Každá karta kontaktu ako súbor Markdown
- [Návody pre Kontakty](https://exporter.dev/sk/guides/contacts): Poznámky o ľuďoch v Obsidiane
- [Správy](https://exporter.dev/sk/docs/messages): Konverzácie, médiá, polia a opravy

---

human version: https://exporter.dev/sk/docs/contacts
every page: https://exporter.dev/llms.txt