Added syntax suggestions for accessing meta information in Ikiwiki links.
[ikiwiki.git] / doc / ikiwiki / wikilink / discussion.mdwn
1 # Creating an anchor in Markdown
2
3 Is it a native Markdown "tag" for creating an anchor? Unfortunately,
4 I haven't any information about it at
5 [Markdown syntax](http://daringfireball.net/projects/markdown/syntax) page.
6
7 Of course, I know that I can use HTML tag to do it,
8 for example <a name="foo" />, but I don't want to mix Markdown
9 and HTML code if it's not necessary.
10
11 BTW, ikiwiki doesn't displays the #foo anchor in the example
12 ("To link to an anchor inside a page...") at [[WikiLink]] page...
13
14 --[[Paweł|ptecza]]
15
16 > No such syntax exists in markdown.  ikiwiki could certainly have a
17 > [[preprocessor_directive|directive]] for it, though.
18 > --[[JoshTriplett]]
19
20 >> [[!tag wishlist]]
21 >> I'd like to implement such a thing.  Joey, what is this supposed to look like?
22 >> `\[[anchor WHATEVER]]`?  --[[tschwinge]]
23
24 >>> Why would you want to use a preprocessor directive for something that can
25 >>> be more shortly and clearly done with plain HTML? Markdown is *designed*
26 >>> to be intermixed with HTML. --[[Joey]]
27
28 >>>> I tend to disagree.
29 >>>> It just doesn't feel right for me to put HTML code straight into Markdown files.
30 >>>>
31 >>>> Quoting <http://daringfireball.net/projects/markdown/>:
32 >>>>
33 >>>>> The idea is that a Markdown-formatted document should be publishable as-is, as plain text, *without looking like it’s been marked up with tags or formatting instructions*.
34 >>>>
35 >>>> Also, in theorie at least, Markdown might also support other output formats than HTML.
36 >>>> Those wouldn't know about how to deal with the intermingled HTML code.
37 >>>>
38 >>>> --[[tschwinge]]
39 >>>>>Not sure \[[anchor WHATEVER]] looks any better than &lt;a name="WHATEVER"&gt;...?  --[[sabr]]
40
41 > The lack of the `#foo` anchor in the anchor example on [[wikilink]]
42 > definitely looks like a bug.  --[[JoshTriplett]]
43
44 >> Fixed that --[[Joey]]
45
46 ---
47
48 Considering a hierarchy like `foo/bar/bar`, I had the need to link from the
49 `foo/bar/bar` page to the `foo/bar` one.  It would have been convenient to
50 simply write [[wikilink]]s like `\[[../bar]]` (or even just `\[[..]]`?), but
51 this doesn't work, so I had to resort to using `\[[foo/bar]]` instead.
52 --[[tschwinge]]
53
54 ----
55
56 How do I make images clickable?  The obvious guess, \[[foo.png|/index]], doesn't work.  --[[sabr]]
57
58 > You can do it using the img plugin. The syntax you suggested would be ambiguous,
59 > as there's no way to tell if the text is meant to be an image or displayed as-is.
60 > --[[Joey]]
61
62 ----
63
64 Is it possible to refer to a page, say \[[foobar]], such that the link text is taken from foobar's title [[directive/meta]] tag? --Peter
65
66 > Not yet. :-) Any suggestion for a syntax for it? Maybe something like \[[|foobar]] ? --[[Joey]]
67
68 I like your suggestion because it's short and conscise. However, it would be nice to be able to refer to more or less arbitrary meta tags in links, not just "title". To do that, the link needs two parameters: the page name and the tag name, i.e. \[[pagename#metatag]]. Instead of '#', any sufficiently weird separater could be used. I like \[[pagename->metatag]], too, because it reminds me of accessing a data member of a structure (which is what referencing a meta tag is, really). --Peter