Changes between Version 1 and Version 2 of makro/a

Timestamp:

01/09/12 17:17:11 (13 years ago)

Author:

fiki

Comment:

--

makro/a

@@ -1 @@
-== Odkazy na jiné generované stránky ==
+= Odkazy =
 
-Makro pro převod interních odkazů:
- - doplnění správné přípony
- - URL kódování znaků
-
-
-Definice makra:
+Odkazy samozřejmě můžeme vkládat pomocí klasické XHTML značky, jak jsme zvyklí:
 
 {{{
 #!xml
-<xsl:template match="m:a">
-        <a>
-                <xsl:copy-of select="@*"/>
-                <xsl:attribute name="href">
-                        <xsl:value-of select="fn:encode-for-uri(concat(@href, $výstupníPřípona))"/>
-                </xsl:attribute>
-                <xsl:apply-templates/>
-        </a>
-</xsl:template>
+<a href="http://example.com/">nějaká stránka</a>
+<a href="mailto:anonym@example.com">nějaký e-mail</a>
 }}}
 
 
-Do textu stránky vložíme např.:
+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`). 
 
 {{{
 #!xml
-<m:a href="naše produkty" title="Klikni zde!">odkaz</m:a>
+<m:a href="služby">Služby</m:a>
 }}}
 
-A ve vygenerovaném výstupu se objeví:
+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 ==
 
 {{{
 #!xml
-<a href="na%C5%A1e%20produkty.xhtml" title="Klikni zde!">odkaz</a>
+<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 ==
+
+{{{
+#!xml
+<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 ==
+
+{{{
+#!xml
+<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 ==
+
+{{{
+#!xml
+<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 ==
+
+{{{
+#!xml
+<m:a href="1855" typ="rfc">Netiketa</m:a>
+}}}
+
+
+----
+
+Podrobnosti naleznete v [https://frantovo.cz/blog/?q=xml-web-generator-verze-0-3 oznámení verze 0.3].