Экспорт

Экспорт бүкіл кеңістікті (space) немесе жеке қалтаны Markdown-файлдардың жалғыз ZIP-архиві етіп жүктеп береді. Пайдаланушының файлдары — шындық көзі болғандықтан (file-first принципі), экспорт оларды индекстен қайта құрастырмай, дискіден тікелей оқиды: архивте нақты файлдардың өзі жатады, әр файлдың frontmatter-індегі notarium-id-мен қоса.

Экспорттың қайтымды болатыны да сондықтан: оны импорт арқылы кері қайтаруға немесе құрылымын, бірегейлігі мен күндерін жоғалтпай басқа данаға көшіруге болады. Мәні бойынша экспорт — «деректерді сыртқа шығару» емес, дискіде сіздің файлдарыңыз болып әрдайым жатқан нәрсені ыңғайлы қаптамаға салу.

Қалай экспорттау керек

Экспорт кеңістік параметрлеріндегі Export қойындысында тұрады:

Түйме тапсырманы кезекке қояды, содан соң пайызы көрсетілген прогресс-жолақ (жазба саны белгілі болғанда) және Cancel түймесі шығады.
Дайын болған соң архив өздігінен жүктеледі; қасында Download .zip (тағы жүктеп алу) және Export again (экспортты қайта жүргізу) түймелері қала береді.
Қойындыдан кетіп, қайта оралу қауіпсіз: оралғанда жүріп жатқан тапсырманы немесе жүктеп алуға дайын файлды қайтадан көресіз.

Жеке қалтаны экспорттау ағаштың контекстік мәзірінен қолжетімді — Export folder тармағы. Бұл — қосалқы ағашпен шектелген сол баяғы тапсырма; прогресс бас тарту түймесі бар «жабысқақ» тостта көрінеді.

Опциялар

Экспорттың екі жолы да параметрлердің бірдей жиынтығын қабылдайды:

Параметр	Мәндер	Не істейді
`scope`	`user` (әдепкі) · `all`	`user` — тек өз жазбаларыңыз; `all` — кеңістіктегі бүкіл мазмұн, агент жадының mount-ын қоса (`.notarium/memory`).
`frontmatter`	`keep` (әдепкі) · `strip`	`keep` файлды сол күйінде салады; `strip` YAML-блокты қиып тастайды — оқуға арналған таза көшірме.
`folder`	жол	Экспортты қосалқы ағашпен шектеу (Export folder істейтін нәрсе).

frontmatter=strip кері импортты бұзады

Frontmatter-ды қию шығынды көшірме береді: YAML-блокпен бірге notarium-id мен тегтер де жоғалады. Мұндай архив жазбаларды оқуға беруге ыңғайлы, бірақ оны енді шығынсыз кері импорттай алмайсыз. Көшіру үшін keep-ті (әдепкі мән) қалдырыңыз.

Экспорт — дананың сақтық көшірмесі емес

scope=all болғанның өзінде экспорт архиві кеңістіктің Markdown-файлдарынан басқа ештеңе алып жүрмейді. Онда метадеректер дерекқоры жоқ: есептік жазбалар да, рұқсаттар да, нұсқалар тарихы да, тапсырмалардың күйі де жоқ. Одан дананы қалпына келтіру мүмкін емес. Сақтық көшірме — образдың кіріктірілген командасымен орындалатын бөлек операция, Сақтық көшірме және қалпына келтіру бөлімін қараңыз.

Іші қалай жұмыс істейді

Экспорт ағынды түрде құрылған — білім қоры қаншалықты үлкен болса да, жадта жиналып қалмайды:

Әдепкіде — асинхронды тапсырма. Хостта метадеректер дерекқоры болғанда (өзіндік хостинг үшін бұл — қалыпты жағдай), экспорт тұрақты тапсырма болады: фондық воркер ZIP-ті артефакт қоймасына жинайды да, дайын файлды жүктеуді жалғастыру мүмкіндігімен береді. Жабылған қойынды, үзілген байланыс, серверді қайта іске қосу — бұлардың бірде-бірі экспортты бұзбайды.
Жүктеу буферленбейді. Дайын архивті браузер тікелей дискіге ағызады, файл атауы жауаптың HTTP-тақырыбынан (header) алынады — үлкен білім қоры қойынды жадында жиналып қалмайды.
Бас тарту жұмысты тоқтатады. Бас тартылған жүктеу жазбаларды тартуды доғарады — сервер бүкіл білім қорын босқа оқып отырмайды.

flowchart LR
  notes[(Markdown-жазбалар)] -->|дискіден оқу| worker[Фондық воркер]
  worker -->|ZIP| artifact[Тапсырма артефактісі]
  artifact -->|download| user([Браузер])

Метадеректер дерекқорынсыз экспорт

Метадеректер дерекқоры жоқ хостта (ол тек AUTH_MODE=none режимінде ғана болмайды) тапсырма қабаты жоқ: экспорт синхронды ағынды жолмен жүреді — сол ZIP бір сұраныстың аясында тікелей жүктеумен беріледі, прогрессіз және жүктеуді жалғастырусыз. Тек жеткізу тәсілі өзгереді, нәтиже сол қалпында.

Шектеулер

Бір мезгілде бір кеңістік. Кеңістіктер — өз рұқсаттары бар оқшауланған қоймалар; бірнешеуін жүктеп алу үшін әрқайсысын бөлек экспорттаңыз.
Артефакт TTL бойынша тіршілік етеді. Дайын ZIP шектеулі уақыт сақталады (әдепкіде — 7 күн), содан соң қоқыс жинағыш оны жояды; мерзімі өткенше қайта жүктеп алуға болады.
Бинарлық тіркемелер экспортталмайды. Архив жазбалардың мәтінін — Markdown-файлдарды алып жүреді.
Бас тарту бар, кідірту жоқ. Тапсырмадан бас тартуға болады; кідірту мен жалғастыру жоқ.

Әрі қарай

Импорт — архивті кері қайтару немесе білім қорын басқа данаға көшіру.
Бөлімге шолу — file-first импорт пен экспортты неге арзан ететіні туралы.