[dev] wicked page export architecture

[Ralf Lang]

Am 31.01.2018 um 14:55 schrieb Jan Schneider:
> 
> Zitat von Sebastian Birnbach <birnbacs at gmail.com>:
> 
>> Wicked permits page exports in plain text, HTML, LaTeX and reStructured
>> Text via links at the end of each page.
>>
>> Over the attempt to print out a page I went for the HTML format, to find
>> out (thanks for pointing this out, Jan) that the corresponding link
>> returns
>> just a HTML fragment, lacking the header with the charset and everything.
>> Bad for printing.
>>
>> Could someone please explain what the rationale behind the fragments
>> is? I
>> see that for automated export his may come handy, piping a page into a
>> larger text structure and everything. But said export is not API
>> functionality but user-clickable links. What use would a fragment be to a
>> user? And why is there no support for creating a printable page?
>>
>> Thanks for any architectural clarification.
>>
>>   Sebastian
> 
> There is no special reasoning for this. We send what the different
> renderers produce straight to the browser. Those links *are* APIs
> though, and definitely are used as such. We for example use the ReST
> export to synchronize documentation between the source code and the
> wiki. Thus we cannot simply change the output, since it may break
> existing consumers.
> The correct way would be to add a print CSS theme, so that the page can
> be printed correctly.
> 
There should be a decorator layer between the API output and what the
user sees when clicking the link. Breaking the API itself may not be best.

-- 
Ralf Lang
Linux Consultant / Developer
Tel.: +49-170-6381563
Mail: lang at b1-systems.de
B1 Systems GmbH
Osterfeldstraße 7 / 85088 Vohburg / http://www.b1-systems.de
GF: Ralph Dehner / Unternehmenssitz: Vohburg / AG: Ingolstadt,HRB 3537

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: OpenPGP digital signature
URL: <https://lists.horde.org/archives/dev/attachments/20180201/571fe3f2/attachment.bin>