makro/a

Odkazy

Odkazy samozřejmě můžeme vkládat pomocí klasické XHTML značky, jak jsme zvyklí: 

<a href="http://example.com/">nějaká stránka</a>
<a href="mailto:anonym@example.com">nějaký e-mail</a>

Ale jsou tu i makra, která nám ušetří práci při vkládání určitých typů odkazů – zadáme jen konkrétní parametr a nemusíme psát celé URL. Typ těchto odkazů se určuje pomocí XML atributu typ.

Interní odkazy

Zadáme jen název souboru bez přípony a makro se postará o správné zakódování (důležité, když název obsahuje diakritiku nebo mezery) a doplnění přípony (ta se může měnit podle nastavení v build.xml). 

<m:a href="služby">Služby</m:a>

Zdroj se jmenuje služby.xml a vygenerovaná stránka služby.xhtml nebo taky služby.html (podle nastavení) a v odkazu je potřeba zakódovat URL jako: slu%C5%BEby.xhtml – díky makru tohle nemusíme řešit a zadáme jen název souboru, jak ho vidíme třeba v Dolphinu (správce souborů).

Trac

<m:a href="8" typ="trac">odkaz na úkol</m:a>
<m:a href="využití" typ="trac">odkaz na wiki stránku</m:a>

Wikipedia

<m:a href="Linus Torvalds" typ="wiki">Linus Torvalds</m:a>
<m:a href="Richard Stallman" typ="wiki" jazyk="en">Richard Stallman</m:a>

Javadoc

<m:a href="javax.xml.parsers.SAXParserFactory" typ="javadoc">SAXParserFactory</m:a>
<m:a href="java.lang.String" typ="javadoc" verze="5">String</m:a>

Vyhledávače

<m:a href="nejlepší linuxová distribuce" typ="seznam">Nejlepší distribuce</m:a>
<m:a href="GNU/Linux a tučňák Tux" typ="google">GNU/Linux a tučňák Tux</m:a>

RFC

<m:a href="1855" typ="rfc">Netiketa</m:a>

E-mail

Na Internetu se vyskytují i zlí lidé, kteří vás budou chtít obtěžovat svým spamem (nevyžádanou poštou). K tomu potřebují znát vaši adresu – aby jich měli co nejvíc, používají roboty, kteří procházejí webové stránky a vyhledávají na nich e-mailové adresy. Na druhou stranu ale chcete, aby návštěvníci vašich stránek mohli normálně kliknout na odkaz a napsat vám e-mail.

Kompromisním řešením je vkládat do stránek odkazy, které jsou pro roboty špatně čitelné, ale uživatelé na ně můžou klikat (většinou). To umožňuje následující makro: 

<m:a href="vaše.adresa@example.com" typ="email">Napište nám!</m:a>

V XHTML kódu vygenerované stránky se pak objeví text: vaše.adresa zavináč example tečka com (čemuž většina spamovacích robotů nebude rozumět a nepozná, že jde o e-mailovou adresu). Pokud má uživatel v prohlížeči podporu JavaScriptu (většina uživatelů má), zobrazí se mu na stránce normální klikatelný odkaz a může vám snadno napsat.

Obsah elementu (v příkladu: Napište nám!) je nepovinný – pokud ho vynecháte, vloží se e-mailová adresa.

Další čtení: