Kontakty

Połączenie

Naciśnij „połącz” na karcie Kontaktów. Panel otworzy się w folderze AddressBook, ~/Library/Application Support/AddressBook: naciśnij „Wybierz ten folder”. Exporter czyta tylko ten folder, bez pytania o uprawnienia, i czyta z niego także twoje wizytówki z iCloud i Exchange. Potem naciśnij „wybierz folder eksportu”.

Gdzie trafiają pliki

Jeden plik Markdown na wizytówkę, Anna Kowalski.md. Dwie osoby o tym samym imieniu i nazwisku dostają krótki przyrostek z id, więc żaden plik nie nadpisuje drugiego. Folder leżący bezpośrednio w twoim folderze domowym, na przykład ~/Documents, dostaje w środku folder contacts-export; głębszy, na przykład ~/Documents/contacts, jest używany bez zmian.

Zakładka, na której jest karta, wyznacza też układ folderów:

zakładka	pliki trafiają do
Wsz., Ostatnie	głównego poziomu folderu eksportu
Grupy	groups/<group>/; wizytówka w dwóch grupach jest zapisywana raz, w pierwszej
Firmy	companies/<company>/

Zmiana zakładki przenosi pliki przy następnej synchronizacji, a karta informuje o tym pod zakładkami. Ostatnie pokazuje 100 ostatnio zmienionych wizytówek; drzewa Grupy i Firmy kończą się pozycjami „Bez grupy” i „Bez firmy”.

Co jest eksportowane

Wizytówki zaznaczone na karcie, z każdym polem, jakie mają. Pomijane: wpisy zawierające tylko adres e-mail, które Gmail zbiera dla każdego adresu, do którego pisałeś. Nie ma eksportu vCard ani CSV: plik .vcf zrobisz w Kontaktach przez Plik > Eksportuj > Eksportuj vCard.

Format

Zawsze Markdown.

Plik

Każdy klucz pojawia się tylko wtedy, gdy wizytówka ma wartość. Wartości na listach mają swoją etykietę, na przykład +1 415 555 0123 (mobile).

klucz	zawiera
title	imię i nazwisko
aliases	pseudonim i nazwisko panieńskie
id, source_url	id wizytówki i link addressbook://, który otwiera ją w Kontaktach
created, modified	kiedy wizytówka powstała i kiedy ostatnio się zmieniła
organization, job_title, department	dane zawodowe
birthday	urodziny
email, phone	pierwszy e-mail i telefon, bez etykiety, do szablonów
emails, phones, addresses, urls	wszystkie, z etykietami
social, im	profile społecznościowe i konta komunikatorów
dates, relationships	inne daty i powiązane osoby, na przykład father: Tom Kowalski
groups	grupy w Kontaktach, do których należy wizytówka
conversations	linki do rozmów z tą osobą, jeśli eksportujesz też Wiadomości

W treści jest imię i nazwisko, stanowisko i notatka z wizytówki:

---
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.

Darmowe i odblokowane

Pierwsze 100 wizytówek spośród zaznaczonych eksportujesz i synchronizujesz za darmo, a usunięta wizytówka zwalnia swoje miejsce; reszta wymaga jednorazowego odblokowania (cennik).

Synchronizacja i pełna resynchronizacja

Po pierwszym „synchronizuj teraz” edycja wizytówki nadpisuje jej plik, dopóki Exporter działa, a plik usuniętej wizytówki znika przy następnej synchronizacji.

„pełna resynchronizacja” najpierw pyta, potem usuwa tylko pliki zapisane przez Exporter, ponownie zapisuje każdą wizytówkę i od nowa wybiera darmową setkę. Wszystko inne w folderze eksportu zostaje.

Problemy i poprawki

• „brak bazy danych kontaktów w tym folderze (wybierz sam folder AddressBook)”: naciśnij ponownie „połącz” i wybierz folder, w którym otworzy się panel
• pliki przeniosły się do innych folderów: karta przeszła na inną zakładkę. Wróć na zakładkę, którą chcesz, i naciśnij „synchronizuj teraz”
• brakuje wizytówki: jest poza darmową setką, jest odznaczona albo to wpis z samym adresem e-mail z Gmaila
• wizytówka z błędem: ostatnia synchronizacja pokazuje czerwony link „szczegóły” z wizytówkami, których eksport się nie udał, i linkiem „otwórz” do każdej z nich