Welcome to 2019
[ikiwiki.git] / doc / plugins / shortcut / discussion.mdwn
1 The plugin depends on [[mdwn]].  If you have
2 disabled [[mdwn]], to get [[shortcut]] work, you need
3 commit in a shortcuts.ext (ext is `rcs|creole|html|txt|etc`),
4 and edit/patch [[shortcut]].
5
6 Maybe use the `default_pageext` is better than hardcode .mdwn?
7
8 --[[weakish]]
9
10 > done, it will use `default_pageext` now --[[Joey]] 
11
12 ---
13
14 Instead of modifying the [[basewiki]]'s [[shortcuts]] file for local needs --
15 thus copying it at some point and losing continuity with upstream enhancements --
16 what about handling a `shortcuts-local.mdwn` or `shortcuts/local.mdwn` (if such
17 a file exists in the wiki), and additionally process that one.  Possibily a
18 conditional `\[[!inline]]` could be used.  --[[tschwinge]]
19
20 ----
21
22 The page says
23
24 > Additionally, %W is replaced with the text encoded just right for Wikipedia
25
26 with the implication that this is odd. However, it appears the escapes
27 actually mean:
28
29 =%s=
30     If every character in the string is in the Latin-1 range, encode each
31     character as a http %xx escape: ö -> %F6. If not,
32     mangle the string: ☃ (U+2603 SNOWMAN) -> %2603 which
33     actually means "&03".
34 =%S=
35     Leave the string as-is.
36 =%W=
37     Encode the string as UTF-8, then encode each byte of the UTF-8
38     individually as a http %xx escape: ö -> %C3%B6, ☃ (U+2603 SNOWMAN) ->
39     %E2%98%83.
40
41 http %xx encoding is defined in terms of input bytes, not input characters,
42 so you can't encode arbitrary Unicode into URLs without knowing which
43 encoding the destination server is going to use. UTF-8 is what's
44 recommended by the [[!wikipedia Internationalized resource identifier]]
45 specification, so I suspect %W is right more often than it's wrong...
46
47 I wonder whether %s should mean what %W does now, with a new format
48 character - maybe %L for Latin-1? - for the version that only works
49 for strings that can be encoded losslessly in Latin-1? --[[smcv]]