please don't make use of [[!meta title]] in parentlinks mandatory...

[ikiwiki.git] / doc / bugs / pagetitle_function_does_not_respect_meta_titles.mdwn

diff --git a/doc/bugs/pagetitle_function_does_not_respect_meta_titles.mdwn b/doc/bugs/pagetitle_function_does_not_respect_meta_titles.mdwn
index 48fd7c647e17c3ea8389225ada3e7f52f6247ffe..86a72a4e2ee24a431ad4633e3d2d2c480fe14c56 100644 (file)
--- a/doc/bugs/pagetitle_function_does_not_respect_meta_titles.mdwn
+++ b/doc/bugs/pagetitle_function_does_not_respect_meta_titles.mdwn
@@ -162,14 +162,14 @@ So, looking at your meta branch: --[[Joey]]
   1) It needs the full page name, not basename.
   2) `titlepage(pagetitle($page))` reversability.
   
-  #1: If you look at all the callers
+  1) If you look at all the callers
   Of `pagetitle` most of them pass a complete page name, not just the
   basename. In most cases `pagetitle` is used to display the full name
   of the page, including any subdirectory it's in. So why not just make
   it consitently be given the full name of the page, with another argument
   specifying if we want to get back just the base name.
 
-  #2: I can't find any code that actually uses the reversability like that.
+  2) I can't find any code that actually uses the reversability like that.
   The value passed to `titlepage` always comes from some external
   source. Unless I missed one.
 * The use of `File::Spec->rel2abs` is a bit scary.
@@ -185,3 +185,20 @@ So, looking at your meta branch: --[[Joey]]
   `pagetemplate` hook. (Although this would eliminate handling of
   `title_overridden` -- but that is little used and would not catch
   all the other ways titles can be overridden with this patch anyway.)
+
+> I'm not a reviewer or anything, but can I chime in on changes to pagetitle?
+> I don't think having meta-titles in wikilinks and the parentlinks path by
+> default is necessarily a good thing. I don't consider the meta-title of a page
+> as used in `<title>` to be the same thing as the short title you
+> want in those contexts - IMO, the meta-title is the "formal" title of the page,
+> enough to identify it with no other context, and frequently too long to be used
+> as a link title or a parentlink, whereas the parentlinks title in particular
+> should be some abbreviated form that's enough to identify it in context.
+> [tbm](http://www.cyrius.com/) expressed a similar opinion when I was discussing
+> ikiwiki with him at the weekend.
+>
+> Having a `\[[!meta abbrev="..."]]` that took precedence over title
+> in such contexts might be a good way to fix this? Or if your preference goes
+> the other way, perhaps a `\[[!meta longtitle=""]]` could take precedence
+> when generating the `<title>` and the title that comes after the parentlinks.
+> --[[smcv]]