makro/a

Version 2 (modified by fiki, 12 years ago)

--

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>

Podrobnosti naleznete v  oznámení verze 0.3.