updated branch; this is ready for review for inclusion in IkIWiki

[git.ikiwiki.info.git] / doc / ikiwiki / wikilink / discussion.mdwn

diff --git a/doc/ikiwiki/wikilink/discussion.mdwn b/doc/ikiwiki/wikilink/discussion.mdwn
index 58bb8ca065f2633b21de4dfd9c4c02b987820481..65a45b99ff0978eb2c2a6f6f8501cfb950a8081b 100644 (file)
--- a/doc/ikiwiki/wikilink/discussion.mdwn
+++ b/doc/ikiwiki/wikilink/discussion.mdwn
@@ -13,6 +13,13 @@ BTW, ikiwiki doesn't displays the #foo anchor in the example
 
 --[[Paweł|ptecza]]
 
+> Just found out that headers are already indexed with `index1h1 ... indexMhN`.
+> So one can link to headings with `\[[page|#index2h3]]` for example. 
+> It would be much easier though if it was translated to the heading's name,
+> so on could to `\[[page#name]]`. --Timoses
+
+>> That's [[plugins/headinganchors]]. --smcv
+
 > No such syntax exists in markdown.  ikiwiki could certainly have a
 > [[preprocessor_directive|directive]] for it, though.
 > --[[JoshTriplett]]
@@ -91,3 +98,21 @@ I like your suggestion because it's short and conscise. However, it would be nic
 > I'm not sure that it is a good idea to refer to arbitrary meta tags in links in the first place - what other meta tags would you really be interested in?  Description?  Author?  It makes sense to me to refer to the title, because that is a "label" for a page.
 > As for syntax, I do like the \[[|foobar]] idea, or perhaps something like what <a href="http://www.pmwiki.org">PmWiki</a> does - they have their links the other way around, so they go \[[page|label]] and for link-text-as-title, they have \[[page|+]].  So for IkiWiki, that would be \[[+|page]] I guess.
 > --[[KathrynAndersen]]
+
+----
+
+I am thinking that it would be useful to parse parts of one wiki page into another. Here something like `\[[page=anchor]]` would be really nice to simply parse the content of that section, as opposed to `\[[page#anchor]]` which only creates a link to that section. -- [[Timoses]]
+
+> When you say "parse parts" do you mean taking a section of a wiki page and including its text
+> in a different wiki page? So for instance you might want `/installation` to include the
+> `Downloading binaries` section of `/download`, but not the rest of that page?
+>
+> That's really a separate feature request (inlining isn't linking), and is also rather difficult
+> to do in IkiWiki's processing model: at the time that [[wikilinks|ikiwiki/wikilink]] and
+> [[directives|ikiwiki/directive]] are processed, the page content is still Markdown or
+> whatever other format is relevant, not HTML. That makes sections difficult to identify.
+>
+> I would suggest making the desired section a separate page (for example you might
+> call it `/download/binaries`), and including that whole page everywhere it should
+> appear (for example in both `/download` and `/installation`) using
+> `\[[!inline pages="download/binaries" raw=yes]]`. --[[smcv]]