Welcome to 2019
[ikiwiki.git] / doc / bugs / htmltidy_has_no_possibilty_to_use_an_alternative_config_file_which_may_break_other_usages.mdwn
1 The htmltidy plugin as in the Backports.org version 2.32.3~bpo40+1 of ikiwiki does not play well with other usages of HTML Tidy since it has no possibility to use an alternative config file.
2
3 E.g. since I usually use HTML Tidy manually only to check and not to fix HTML, I have "markup: no" in my $HOME/.tidyrc which throws an awful lot of Perl warnings and renders all ikiwiki pages empty as soon as I enable htmltidy.
4
5 I see two possibilities how to fix this:
6
7 1) Replace "$pid=open2(*IN, *OUT, 'tidy -quiet -asxhtml -utf8 --show-body-only yes -
8 -show-warnings no --tidy-mark no');" by "$pid=open2(*IN, *OUT, 'tidy -quiet -asxhtml -utf8 --show-body-only yes -
9 -show-warnings no --tidy-mark no --markup yes');" -- This is the fastest fix, but not very elegant, since it doesn't solve the general problem.
10
11 2) Make it configurable via ikiwiki.setup as e.g.with the tags plugin. Haven't looked into this code yet.
12
13 > I don't understand why you're talking about setting --write-back. The
14 > htmltidy plugin communicates with tidy using stdio. No files are used, so
15 > write-back settings should be irrelevant. --[[Joey]]
16
17 >> Hmmm, ok. Well, it didn't work. Empty pages, Perl Warnings. I moved my $HOME/.tidyrc away and it worked again. Had a short look into it and the only obvious non-default setting I found was write-back. I'll check what exactly caused the breakage and let you know. --[[XTaran]]
18
19 >>> Ok, found it. It indeed wasn't `write-back`, but `markup: no`. (I usually only want to see warnings and errors, not the fixed markup.) I now've corrected this in the bug report above. --[[XTaran]]
20
21 > Ok, so should I pass --markup yes, or should I force it not to use
22 > ~/.tidyrc? I can do that (by setting HOME to /dev/null), but there seems
23 > to be no way to override it reading /etc/tidy.conf, so options there can
24 > still screw things up. I guess I'll pass --markup yes and deal with
25 > overriding other problem settings from config files if they're found
26 > later. --[[Joey]] [[!tag done]]