doc/bugs/urlto_API_change_breaks_wikis_with_po_plugin.mdwn

   1 The po plugin needs to be updated to match the urlto sub API and
   2 signature changes. Else a wiki with the po plugin enabled cannot be
   3 refreshed / rebuilt because of (correct) Perl errors.
   4
   5 My po branch contains a fix.
   6 --[[intrigeri]]
   7
   8 > The commit looks sane to me, for what it's worth. Joey, please
   9 > consider merging? --[[smcv]]
  10
  11 >> Merged. --[[Joey]]
  12
  13 Also, I fear the lack of any useful `$from` parameter might break some
  14 l10n'd link niceness when using `po_link_to = current` but I have not
  15 investigated this yet.
  16 --[[intrigeri]]
  17
  18 > If `urlto` is called without a second parameter, it means we need
  19 > a URL valid from either the CGI URL or any page in the wiki,
  20 > (so we'd previously have set the third parameter true), but we
  21 > don't *necessarily* need an absolute URL - so return what you'd
  22 > have returned if asked for an absolute URL, but looking like
  23 > `/bugs/` rather than `http://ikiwiki.info/bugs/` if possible.
  24 >
  25 > It looks as though `beautify_urlpath` under `po_link_to = current`,
  26 > and 3-argument `urlto`, aren't tested by `t/po.t` - perhaps you
  27 > could add some test cases there? To test 3-argument `urlto` you'd
  28 > need to add `$config{baseurl} = "http://example.com"` or
  29 > something. --[[smcv]]
  30
  31 >> I'm leaving this bug report open until this can be checked. --[[Joey]]
  32
  33 >>> My `ready/urlto` branch improves the test coverage. The bugfix from
  34 >>> that branch fixes most of `po` too, but leaves behind some perhaps
  35 >>> less-than-ideal behaviour: links where the current language is unknown,
  36 >>> with `po_link_to = current`, always go to the master language,
  37 >>> whereas perhaps it'd be better to go to the negotiated language in
  38 >>> this case? --[[smcv]]
  39
  40 >>>> Thanks for taking care, thanks for these improvements!
  41 >>>>
  42 >>>> OTOH I consider any of these behaviours (either the brand new one
  43 >>>> = link to master language, or the alternative one = link to
  44 >>>> negotiated) as a regression. Any of these is contrary to what
  45 >>>> `po_link_to = current` is supposed to do according to the
  46 >>>> documentation.
  47 >>>>
  48 >>>> Let's be less technical, let me display my practical usecase
  49 >>>> (making this possible was one of the main reasons I initially
  50 >>>> implemented `po_link_to = current`).
  51 >>>>
  52 >>>> Summary: the current state of things is an annoying regression
  53 >>>> and it needs to be fixed.
  54 >>>>
  55 >>>> Context: I participate in building a Live system based on Debian
  56 >>>> Live; the project's multilingual website
  57 >>>> ([T(A)ILS](https://amnesia.boum.org/) is built using ikiwiki. A
  58 >>>> static / offline copy is shipped on ISO images; this is the way
  59 >>>> end-user documentation lands on the CDs. Note that no webserver
  60 >>>> runs on the Live system to serve this wiki, so `po_link_to =
  61 >>>> current` is compulsory. A user can choose her preferred language
  62 >>>> at boot time. Depending on her decision, The desktop shortcut
  63 >>>> that points to the embedded documentation (i.e. static wiki)
  64 >>>> links to a different entry point depending on the chosen
  65 >>>> language.
  66 >>>>
  67 >>>> The previous (documented) behaviour was deadly simple:  if I am
  68 >>>> presented a page in English (master language) it means it does
  69 >>>> not exist in my preferred language; the computer always displays
  70 >>>> me the best available version according to my needs. The new
  71 >>>> behaviour brings a troubling seemingly random factor into the
  72 >>>> user navigation experience and IMHO is a mess from a web
  73 >>>> ergonomics point of view (no content negotiation available,
  74 >>>> remember): I sometimes am shown an English page although it is
  75 >>>> fully translated in my language one click away, and on the
  76 >>>> contrary I sometimes I am shown the optimal page. This, is, well,
  77 >>>> interesting. This practically forces the non-English speaking
  78 >>>> website visitor to check the otherlanguages list on every single
  79 >>>> page to make sure *herself* there is nothing better available,
  80 >>>> and sometimes click on her preferred language link to get a page
  81 >>>> she actually can read.
  82 >>>>
  83 >>>> I unfortunately might not be able to dedicate the needed time to
  84 >>>> help fix this in a timely manner, so I don't want to urge anyone.
  85 >>>> Take care!  --[[intrigeri]]
  86
  87 >>>>> I can see why this is bad, but to the best of my knowledge it's
  88 >>>>> not a regression: each of the calls to 1-argument `urlto` was
  89 >>>>> previously a call to 3-argument `urlto`, which always produces
  90 >>>>> a fully absolute URL, so in either case there isn't enough
  91 >>>>> context to know the current language. Links that were previously
  92 >>>>> 2-argument `urlto` still have a defined second argument. --[[smcv]]