aboutsummaryrefslogtreecommitdiff
path: root/doc/ikiwiki/wikilink/discussion.mdwn
blob: b5cb848edead4cfb61938286e734f4a0d8b13c13 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
# Creating an anchor in Markdown

Is it a native Markdown "tag" for creating an anchor? Unfortunately,
I haven't any information about it at
[Markdown syntax](http://daringfireball.net/projects/markdown/syntax) page.

Of course, I know that I can use HTML tag to do it,
for example <a name="foo" />, but I don't want to mix Markdown
and HTML code if it's not necessary.

BTW, ikiwiki doesn't displays the #foo anchor in the example
("To link to an anchor inside a page...") at [[WikiLink]] page...

--[[Paweł|ptecza]]

> No such syntax exists in markdown.  ikiwiki could certainly have a
> [[preprocessor_directive|directive]] for it, though.
> --[[JoshTriplett]]

>> [[!tag wishlist]]
>> I'd like to implement such a thing.  Joey, what is this supposed to look like?
>> `\[[anchor WHATEVER]]`?  --[[tschwinge]]

>>> Why would you want to use a preprocessor directive for something that can
>>> be more shortly and clearly done with plain HTML? Markdown is *designed*
>>> to be intermixed with HTML. --[[Joey]]

>>>> I tend to disagree.
>>>> It just doesn't feel right for me to put HTML code straight into Markdown files.
>>>>
>>>> Quoting <http://daringfireball.net/projects/markdown/>:
>>>>
>>>>> 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*.
>>>>
>>>> Also, in theorie at least, Markdown might also support other output formats than HTML.
>>>> Those wouldn't know about how to deal with the intermingled HTML code.
>>>>
>>>> --[[tschwinge]]
>>>>>Not sure \[[anchor WHATEVER]] looks any better than &lt;a name="WHATEVER"&gt;...?  --[[sabr]]

> The lack of the `#foo` anchor in the anchor example on [[wikilink]]
> definitely looks like a bug.  --[[JoshTriplett]]

>> Fixed that --[[Joey]]

---

Considering a hierarchy like `foo/bar/bar`, I had the need to link from the
`foo/bar/bar` page to the `foo/bar` one.  It would have been convenient to
simply write [[wikilink]]s like `\[[../bar]]` (or even just `\[[..]]`?), but
this doesn't work, so I had to resort to using `\[[foo/bar]]` instead.
--[[tschwinge]]

----

How do I make images clickable?  The obvious guess, \[[foo.png|/index]], doesn't work.  --[[sabr]]

> You can do it using the img plugin. The syntax you suggested would be ambiguous,
> as there's no way to tell if the text is meant to be an image or displayed as-is.
> --[[Joey]]

----

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

> Not yet. :-) Any suggestion for a syntax for it? Maybe something like \[[|foobar]] ? --[[Joey]]