[forrás](https://fletcher.github.io/MultiMarkdown-6/syntax/metadata.html#standardmetadatakeysÖ) # Metaadat A Markdown dokumentumok elejére speciális metaadatokat is felvehet, például címet, szerzőt stb. Ez az információ felhasználható annak ellenőrzésére, hogy a Markdown miként dolgozza fel a dokumentumot, vagy felhasználható bizonyos kimeneti formátumokban különleges módon. Például: ``` Title: Minta MultiMarkdown dokumentum Author: Fletcher T. Penney Date: 2011. February 9. Comment: Ez egy megjegyzés, amelynek célja annak a bemutatása, hogy ezt a több sort átfogó metaadatot egyetlen értékként kezelik. CSS: http://example.com/standard.css ``` A metaadatok használatának szintaxisa egyszerű. - A metaadatoknak a dokumentum tetején kell kezdődniük - üres sor sem lehet előttük. Opcionálisan lehet - a a metaadatok elõtt és után üres sor. A metaadatok utáni sor is lehet üres… Azért, hogy jobb kompatibilitást biztosítson a YAML-rel, bár a MultiMarkdown nem támogatja az összes YAML-metaadatot. - A metaadatok a `key/kulcsból` és a `value/értékből` állnak. - A metaadat-kulcsnak a sor elején ASCII betűvel vagy számmal kell kezdődnie. A következő karakterek állhatnak ASCII betűkből, számokból, szóközből, kötőjelekből vagy aláhúzott karakterekből. - A metaadat-kulcs végét kettőspont (':') jelzi. - A kettőspont után jön a metaadat érték, amely nagyjából bármilyen karakterből állhat (beleértve az új sorokat is). Annak érdekében, hogy a többvonalas metaadat-értékeket ne lehessen összetéveszteni a további metaadatokkal, minden azonos kulcshoz tartozó új metaadat-sor behúzását javaslom. Ha a metaadat értéke tartalmaz kettőspontot, akkor **azt be kell "csomagolni"**, hogy ne lehessen új kulcs-érték párként kezelni. `példa: a kettőspont \: csomagolása` - Bár nem kötelező, azt javaslom, hogy két szóközt használjon az egyes metaadatsorok végén. Ez javítja a metaadat szakasz megjelenésének kompatibilitását. - A metaadat-kulcsok nem érzékenyek a kis- és nagybetűkre, és a feldolgozás során az összes szóközt figyelmen kívűl hagyják. Ez azt jelenti, hogy az `AlapFejléc Szintje`, az `alapfejléc szintje` és az `alapfejlécszintje` azonos. - A metaadatokat egyszerű szövegként dolgozzák fel, tehát nem tartalmazhatják a MultiMarkdown jelölést. - A metaadatok elkészítése után egy üres sor indítja el a dokumentum többi részét. Metaadat „Változók” A metaadat-kulcs értékét a dokumentum testében helyettesítheti a következő formátumban, ahol a foo és a sáv a kívánt metaadatok kulcsai. ``` foo: foo-test bar: bar-test # Változó egy címsorban [% foo] Változó a kenyérszövegben [% bar]. ``` ## “Standard” Metaadat kulcsok Van néhány metaadat-kulcs, amelyeket a MultiMarkdown szabványosít. Bármely más kívánt kulcsot használhat, de ezeket saját maga kell használni. Célom, hogy a „szabványos” metaadat-kulcsok listáját a lehető legrövidebbre tartsam. **Author:** (Szerző) Ez az érték a dokumentum szerzőjét képviseli, és a LaTeX, ODF és RTF dokumentumokban használják a címadatok előállításához. **Affiliation:** (Munkahely) Ezzel további információkat írunk a szerzőről - egy linket egy weboldalra, a munkáltató nevét, a tudományos tagságot stb. **Base Header Level** (Alap fejléc szint) Ezzel megváltoztathatja a dokumentum legfelső szintű szervezeti szintjét. Például: ``` Base Header Level: 2 # Introduction # ``` Általában a bevezetés HTML formátumban `<h1>`, vagy a LaTeX `part{}` lesz. Ha rövidebb dokumentumot ír, akkor érdemes lehet, ha a dokumentum legnagyobb osztásos része `<h2>` vagy `chapter{}`. Az alapfejléc-metaadatok azt mondják, hogy a MultiMarkdown változtassa meg a legnagyobb osztási szintet a megadott értékre. Ez akkor is hasznos lehet, ha a beillesztést több dokumentum egyesítésére használja. `Base Header Level` nem indítja el a teljes dokumentumot. Ezenkívül vannak különféle ízek ennek a metaadat-kulcsnak a különféle kimeneti formátumokhoz, így különféle fejlécszintet adhat meg a különböző kimeneti formátumokhoz - pl. `LaTeX Header Level`, `HTML Header Level`, és `ODF Header Level`. Ha valami érdekes dolgot csinál a [File Transclusion] segítségével, itt is használhat negatív számot. Mivel a metaadatokat nem használják, amikor egy fájl „átkerül”, ez lehetővé teszi, hogy más szintű címsort használjon, amikor a fájl önállóan dolgozik fel. Biblio stílus Biblio Style Ez a metaadat meghatározza a használni kívánt BibTeX stílus nevét, ha nem natbib. BibTeX Ez a metaadat meghatározza a hivatkozási információk tárolására használt BibTeX fájl nevét. Nem tartalmazza a „.bib” jelölést. Copyright Ez felhasználható szerzői jog biztosításához. CSS Ez a metaadat egy URL-t határoz meg, amelyet CSS fájlként kell használni a létrehozott dokumentumhoz. Nyilvánvaló, hogy ez csak akkor hasznos, ha HTML-formátumba nyomtatunk. Date Adja meg a dokumentumhoz társítandó dátumot. HTML Header A nyers HTML-információkat felveheti a dokumentum `<head>` szakaszába. A MultiMarkdown nem végez ezen adatok validálását vagy feldolgozását - csak másolja azokat a jelenlegi formájában. Példaként ez hasznos lehet, ha összekapcsolja a dokumentumot egy működő MathJax telepítéssel (nem én szolgáltattam): ``` HTML header: <script type="text/javascript" src="http://example.net/mathjax/MathJax.js"> </script> ``` HTML Footer A nyers HTML itt felvehető, és a dokumentum végén lesz, csatolva lábjegyzetek után stb. Hasznos szkriptekhez való hivatkozáshoz, amelyeket lábjegyzetek után kell feltüntetni. Language A nyelvi metaadat-kulcs a szabványos kétbetűs kóddal határozta meg a dokumentum tartalmának nyelvét (például angolul en). Ahol ez lehetséges, ez az idézőjelek nyelvét a megfelelő értékre állítja. LaTeX Author / LaTeX szerző Mivel a MultiMarkdown szintaxisa nem kerül feldolgozásra a metaadatokban, a `LaTeX Author`-i metaadatokkal felülírhatja a szokásos szerzői metaadatokat, amikor a LaTeX-be exportálják. Ennek a metaadatnak a szokásos `Author` metaadat után kell lennie, ha azt szintén használják. LaTeX Begin Ez egy LaTeX fájl neve, amelyet bele kell foglalni (az `\input{foo}`-on keresztül), amikor a LaTeX-be exportálják. Ez a fájl a metaadatok után és a dokumentum törzse előtt kerül beillesztésre. Általában itt fordul elő a `\begin{document}` parancs, innen származik a név. LaTeX Config Ez egy gyorsbillentyű a LaTeX-be történő exportáláskor, amely automatikusan kitölti a `latex leader/latex vezérlő`, a `latex begin/latex kezdés` és a `latex footer/latex lábléc` metaadatait egy szabványos elnevezési konvenció alapján. `latex config`: tartalma megegyezik a következő beállítással: ``` latex leader: mmd6-article-leader latex begin: mmd6-article-begin latex footer: mmd6-article-footer ``` A szabványos LaTeX támogatási fájlokat frissítettük az elnevezési konfiguráció támogatása érdekében: [**https://github.com/fletcher/MultiMarkdown-6/tree/master/texmf/tex/latex/mmd6**](https://github.com/fletcher/MultiMarkdown-6/tree/master/texmf/tex/latex/mmd6) LaTeX Footer/Lábléc A LaTeX dokumentum végére felveendő fájl neve. LaTeX Header/Fejrész Nyers LaTeX forrás, amelyet hozzá kell adni a dokumentum metaadat szakaszához. Megjegyzés: Ez különbözik a latex vezérlőtől, a latex kezdő és a latex lábléc metaadatoktól, amelyek csak fájlnevet tartalmazhatnak. LaTeX Leader/Vezető A LaTeX dokumentum legelején, a metaadatok előtt feltüntetendő fájl neve. LaTeX Mode Amikor egy dokumentumot LaTeX-hez ad ki, két speciális lehetőség van, amelyek kissé megváltoztatják a kimenetet - `memoir` és `beamer`. Ezeket az opciókat úgy tervezték, hogy kompatibilisek legyenek az azonos nevű LaTeX osztályokkal. LaTeX Title/Cím Mivel a MultiMarkdown szintaxisa nem kerül feldolgozásra a metaadatokban, a `LaTeX Title` metaadatait felhasználhatja a szokásos `Title` metaadatainak felülbírálására, amikor a LaTeX-be exportálják. Ennek a metaadatnak a rendes `Title` metaadat után kell lennie, ha azt is használják. Az MMD fejléc olyan szöveget biztosít, amelyet beilleszt a szöveg első része előtt, a dokumentum elemzése előtt. Ha külső fájlt szeretne felvenni, akkor használja a beillesztési szintaxist (`{{foo.txt}}`). MMD Footer Az MMD lábléc metaadatai olyanok, mint az MMD fejléc, de a dokumentum végére, az elemzés előtt csatolja a szöveget. Használjon átírást, ha hivatkozni kíván egy külső fájlra. Ez hasznos, ha a hivatkozások, rövidítések, lábjegyzetek, hivatkozások stb. Listáját egyetlen fájlban tárolja, amelyet több dokumentumban újra felhasználhat. Ha nagyobb dokumentumot készít kisebb dokumentumokból, ez lehetővé teszi, hogy egy listát használjon az összes fájlban, anélkül, hogy több példányt helyezne be a törzsfájlba. ODF Header/Fejléc A nyers XML-t felveheti az OpenDocument formátumú fájlkimenet fejlécébe. Az ön feladata, hogy megfelelően formázza az XML-et, és működőképessé tegye - a MultiMarkdown csak szó szerint másolja azt a kimenetre. Quotes Language Ezzel határozható meg, hogy az „intelligens” idézetek milyen stílusúak legyenek a kimeneti dokumentumban. A választható lehetőségek a következők: * dutch (or nl) * english (en) * french (fr) * german (de) * germanguillemets * spanish (es) * swedish (sv) Az alapértelmezés angol, ha nincs megadva. Ez befolyásolja a HTML kimenetet. A dokumentum nyelvének a LaTeX-ben történő megváltoztatása az egyén döntése. A `Quotes Language` nem vonatkozik a teljes dokumentumra. Title/Cím Magától értetődő.. Transclude Base Amikor a [File Transclusion] szolgáltatást a „MultiMarkdown” dokumentumon belüli más dokumentumok „összekapcsolásához” használja, ez a metaadat egy mappát határoz meg, amely tartalmazza a csatolt fájlokat. Ha kihagyja, akkor az alapértelmezés szerint a mappa tartalmazza a kérdéses fájlt. Ez lehet relatív út vagy teljes út. Ez a metaadat különösen akkor hasznos lehet, ha a MultiMarkdown segítségével szöveges szöveget szekretál, amely nem létezik fájlként a számítógépen, és ezért nem rendelkezik szülőmappával (amikor `stdin` vagy más alkalmazás, amely MultiMarkdown támogatást kínál). Ebben az esetben az útnak teljes útnak kell lennie. `{{../highlighting.txt}}`