.. _specs_pruvodka:

========
Průvodka
========

Průvodka informačního balíčku je soubor, který je povinně součástí 
informačního balíčku (:ref:`specs_aip`). 
Soubor poskytuje vazbu mezi jednotlivými komponentami v informačním 
balíčku a jejich popisem. Soubor současně obsahuje popisná metadata 
archiválií. Tato metadata mohou pocházet ze zdrojového souboru 
:ref:`mets.xml <specs_zdroj_mets>` a nebo jsou vložena v průběhu přejímky.

Průvodka je uložen v AIPu v adresáři :file:`objects` pod názvem :file:`pruvodka.xml`.


---------------
Migrace formátů
---------------

Při uložení do Archivematica může docházet k migraci formátu komponent
(souborů). V takovém případě je jedna komponenta reprezentována více 
soubory - původní soubor a migrovaný. Tato skutečnost je zachycena 
v uloženém :ref:`AIPu <specs_aip>` v kořenovém souboru :file:`mets.xml`
a v jeho strukturální mapě.


--------------
Formát souboru
--------------

Soubor je XML dokument ve formátu `METS <https://www.loc.gov/standards/mets/>`_.

Soubor obsahuje:

 - právě jednu sekci :token:`dmdSec` obsahující popisná metadata
   ve formátu `EAD <http://www.loc.gov/ead/>`_ 
   ve `verzi 3 <http://www.loc.gov/ead/ead3.xsd>`_, 
   popisná metada jsou vložena jako XML pomocí tagu :token:`<mdWrap>`   

 - soubor musí obsahovat popis všech :file:`komponent` a 
   jejich originálních souborů. Ty musí být odkazovány 
   v části :token:`fileSec`

 - soubory jsou umístěny v části :token:`fileSec`, která je tvořena elementy
   :token:`fileGrp`. Ty tvoří plochý seznam a nejsou již dále vnořeny.
   Soubory které spolu přímo souvisí je možné spojit do jedné skupiny.

 - pomocí strukturální mapy jsou propojeny jednotlivé soubory s odkazy na ně 
   z popisné části. Strukturální mapa je plochý seznam mapování mezi DAO 
   v EADu a konkrétním souborem. Seznam je zapouzdřen v právě jednom 
   kořenovém elementu. Elementy :token:`div` v sobě nejsou dále vnořeny a
   vždy obsahují právě jeden element :token:`fptr`.
   

`EAD <http://www.loc.gov/ead/>`_ je velmi bohatý formát. 
Z toho důvodu je v samostatném dokumentu :ref:`specs_ead` popsán 
způsob jeho užití, povinné a možné prvky popisu.


-------
Příklad
-------

Příklad průvodky s jedním souborem. 

.. literalinclude:: pruvodka/priklad1.xml
   :language: xml