jspwiki-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Dave Koelmeyer (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (JSPWIKI-895) Haddock template links contain raw URL information when printed
Date Wed, 01 Jul 2015 09:46:05 GMT

    [ https://issues.apache.org/jira/browse/JSPWIKI-895?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14609838#comment-14609838

Dave Koelmeyer commented on JSPWIKI-895:

Hi Dirk, 

Not only does it look odd, it severely negatively impacts the quality of printed output, and
is several backwards steps from, say, the Plain Vanilla skin which generally renders very
nicely to hard copy. See for example page 4 of [http://www.apertura.co.nz/whitepapers/APWiki.pdf].
In its present state, I would not want to distribute hard copy printouts from JSPWiki with
Haddock enabled.

Automatic generation of underlying URLs sounds like a good idea in theory, in practice results
in a mess. In this regard, there is equally very little gain to be had above not including
underlying URLs by default. At very the least, as I've rapidly found out, it's a waste of
paper – as printed documents are longer than they need to be to account for the extra lines.

If users wish to include URL information in printouts, this simply needs to be at the user's
discretion and factored in when they formatting the page – *exactly* the same as if one
prints a LibreOffice Writer document which may also contain web links (which are also not
converted to the underlying address by default). The method used in Haddock seems to be indiscriminate,
resulting in URL information printed where there is zero benefit advantage (I don't need to
see the URL of the user who modified the page, or the URL of the page title for example, but
this is also inserted in the print view).

URLs commonly are also quite lengthy, which is another reason I would think not to have them
automatically inserted for printing. I could go on, but in short I find this a very confusing
design decision. While not a bug, it's certainly an issue of some sort.

> Haddock template links contain raw URL information when printed
> ---------------------------------------------------------------
>                 Key: JSPWIKI-895
>                 URL: https://issues.apache.org/jira/browse/JSPWIKI-895
>             Project: JSPWiki
>          Issue Type: Bug
>          Components: Templates and UI
>    Affects Versions: 2.10.2
>         Environment: Client is: 
> - Firefox 38 (Ubuntu 14.04). 
> Server is:
> - JSPWiki v2.10.2-svn-20 running in GlassFish v4
> - Container managed authentication is enabled using a file-based realm
> - HTTPS is enabled
> - JSPWiki policy is locked down such that only authenticated users have access (both
read and write)
>            Reporter: Dave Koelmeyer
>            Assignee: brushed
>         Attachments: JSPWiki-Printout-1.png
> With the Haddock template enabled, a page containing regular internal links encased in
square brackets will, when printed out, display with the underlying URL. 

This message was sent by Atlassian JIRA

View raw message