Direktiva meta
je poskytována modulem meta.
Direktiva umožňuje do zdrojové stránky vkládat libovolná metadata. Syntaxe je následující:
[[!meta pole="hodnota"]]
[[!meta pole="hodnota" param="hodnota" param="hodnota"]]
The first form sets a given field to a given value, while the second form
also specifies some additional sub-parameters. You can have only one field
per meta
directive, use more directives if you want to specify more
fields.
Hodnoty polí jsou považovány za HTML text, takže můžete používat entity jako
"
místo uvozovek a podobně.
Podporovaná pole:
title
Přepíše název stránky, který je obvykle stejný jako jméno stránky.
Pokud je název stránky přepsán, nastaví se v šabloně proměnná „title_overridden“ na hodnotu true; toho můžete využít například pro odlišné formátování takovýchto stránek.
An optional
sortas
parameter will be used preferentially when sorting bymeta(title)
:[[!meta title="The Beatles" sortas="Beatles, The"]]
[[!meta title="David Bowie" sortas="Bowie, David"]]
license
Zadá licenci stránky, například „GPL“. Může obsahovat wiki odkazy a libovolné značkovací příkazy.
copyright
Zadá copyright stránky, například „Copyright 2007 by Joey Hess“. Může obsahovat wiki odkazy a libovolné značkovací příkazy.
author
Zadá autora stránky.
An optional
sortas
parameter will be used preferentially when sorting bymeta(author)
:[[!meta author="Joey Hess" sortas="Hess, Joey"]]
authorurl
Zadá url autora stránky.
description
Specifies a short description for the page. This will be put in the html header, and can also be displayed by eg, the map directive.
keywords
Specifies keywords summarizing the contents of the page. This information will be put in the html header. Only letters, numbers, spaces and commas are allowed in this string; other characters are stripped. Note that the majority of search engines, including Google, do not use information from the keywords header.
permalink
Zadá permanentní odkaz na stránku - například pokud je jiný, než stránka vygenerovaná ikiwiki.
date
Zadá datum vytvoření stránky. Datum je možno zadat v téměř libovolném formátu, protože je zpracováno perlovým modulem TimeDate.
stylesheet
Přidá do stránky odkaz na soubor se stylem. Styl je chápán jako wiki odkaz na
.css
soubor, tudíž takto nelze přidávat odkazy na externí styly. Příklad:[[!meta stylesheet=mujstyl rel="alternate stylesheet" title="mujstyl"]]
However, this will be scrubbed away if the htmlscrubber plugin is enabled, since it can be used to insert unsafe content.
script
Adds a script to a page. The script is treated as a wiki link to a
.js
file in the wiki, so it cannot be used to add links to external scripts. The optionaldefer
andasync
keywords can be used to set the corresponding HTML4 and HTML5 script options. Example:[[!meta script=somescript defer async]]
The tag is subject to scrubbing as with the stylesheet and link fields.
openid
Přidá html značky <link>, aby delegoval OpenID na externí OpenID server. Tímto můžete použít stránku v ikiwiki jako své OpenID.
Implicitně se deleguje
openid
iopenid2
. Chcete-li delegovat pouze jedno z nich, přidejte parametrdelegate
, napřdelegate=openid
.Volitelný parametr
xrds-location
vám umožní zadat umístění libovolných eXtensible Resource DescriptorS.Příklad:
[[!meta openid="http://joeyh.myopenid.com/" server="http://www.myopenid.com/server" xrds-location="http://www.myopenid.com/xrds?username=joeyh.myopenid.com"]]
link
Vytvoří odkaz na jinou stránku. Toho se dá využít pro to, aby ikiwiki věděla, že stránka odkazuje na jinou stránku, ale přitom se nezobrazil viditelný wiki odkaz:
[[!meta link=jinastranka]]
Také se dá využít pro vložení html značky <link>. Například:
[[!meta link="http://joeyh.myopenid.com/" rel="openid.delegate"]]
Tato druhá syntaxe bude fungovat pouze pokud máte povolený také modul htmlscrubber, protože jinak byste mohli do stránky vložit nebezpečný obsah.
redir
Přesměruje návštěvníky na jinou stránku ve wiki.
[[!meta redir=jinastranka]]
The default is to redirect without delay. Optionally, a delay (in seconds) can be specified: "delay=10"
Je možné přesměrování i na externí url. Například:
[[!meta redir="http://www.debian.org/"]]
Tato druhá syntaxe bude fungovat pouze pokud máte povolený také modul htmlscrubber, protože jinak byste mohli do stránky vložit nebezpečný obsah.
V obou případech je možné skočit na konkrétní místo v cílové stránce (kotvu) pomocí běžné syntaxe
#KOTVA
.robots
Zapíše metaznačku pro webové roboty:
[[!meta robots="index, nofollow"]]
Platné hodnoty jsou: „index“, „noindex“, „follow“ a „nofollow“. Je povoleno více hodnot oddělených čárkou, ale smysl mají pochopitelně pouze některé kombinace. Pokud ve stránce žádná metaznačka robots není, použije se automaticky „index, follow“.
Hodnota je chráněná proti nebezpečným znakům, ale jinak se samotný obsah nijak nekontroluje.
guid
Specifies a globally unique ID for a page. This guid should be a URI, and it will be used to identify the page's entry in RSS and Atom feeds. If not given, the default is to use the page's URL as its guid.
This is mostly useful when a page has moved, to keep the guids for pages unchanged and avoid flooding aggregators (see tips/howto avoid flooding aggregators).
updated
Pro RSS a Atom kanály použije falešný čas změny stránky. To se občas hodí jako prevence proti zaplavení agregátorů, které zobrazují články dle času změny (jako třeba Planeta). Například pokud do staršího blogu přidáváte štítky, můžete nastavit
updated
o jednu sekundu před původním časem. Datum/čas můžete stejně jako u jiných časových polí zadat v libovolném formátu, kterému rozumí modul TimeDate.foaf
Adds a Friend of a Friend (FOAF) reference to a page.
Příklad:
[[!meta foaf=foaf.rdf]]
Pokud zadané pole není některé z předdefinovaných polí výše, zapíší se metadata do vygenerované html stránky jako hlavička <meta>. Aby to však fungovalo, musíte mít povolený modul htmlscrubber, protože jinak byste mohli do stránky vložit nebezpečný obsah.