Fwd: Re: offline help replacement

Sat Dec 23 10:13:32 UTC 2017

HI

Newbie seeking advice!

I am trying to implement Kendy's idea of a temp file with some HTML
inside, I seek a piece of code to open a temp file, write contents in
it, close it.

I started with
---------------
    OUString aExtension(".html");
    ::utl::TempFile aTempFile("newhelp", true, &aExtension, nullptr,
false );
    aTempFile.EnableKillingFile();
--------------

But then How do I write a simple OUString ("hello world") inside it?

Thanks in advance.
Seasons Greetings!
Olivier

Em 22/12/2017 07:00, Olivier Hallot escreveu:
> Hi
> For the records, the patch
> 
> https://gerrit.libreoffice.org/gitweb?p=help.git;a=commitdiff;h=0e5a56e81f63d2705f1083acda4b2d899783fdcd
> 
> now allows the pages to be equally navigated in browser with both
> http:// and file:// protocols.
> 
> Regards
> Olivier
> 
> Em 18/12/2017 14:44, Olivier Hallot escreveu:
>> Hi All
>>
>> To integrate the new offline help in LibreOffice we need to call the
>> browser from LibreOffice passing the help page parameters.
>>
>> The job is ready for the online help (*) and is in line 523 of the file
>> below.
>>
>> sfx2/source/appl/sfxhelp.cxx.
>>
>> For the offline help we still need a way to call the browser passing the
>> right url to
>>
>> ${Install}/help/
>>
>> in the same sfxhelp.cxx file
>>
>> David Tardon has prepared a set of makefiles for the new html help with
>> some new params as
>>
>> Usage:     --with-help    build the old local help
>>            --without-help     no local help (default)
>>            --with-help=html   build the new HTML local help
>>            --with-help=online build the new HTML online help
>>            --with-help=common bundle common files for the local
>>                        help but do not build the whole help
>>
>> Below are some findings we have from previous discussion on how to
>> address the issue.
>>
>> Any help is appreciated
>>
>> Kind regards
>> Olivier
>>
>>
>> -------- Mensagem encaminhada --------
>> Assunto: Re: offline help replacement
>> Data: Tue, 26 Sep 2017 10:29:02 +0200
>> De: Jan Holesovsky <kendy at collabora.com>
>> Para: Olivier Hallot <olivier.hallot at libreoffice.org>
>>
>> Hi Olivier,
>>
>> Olivier Hallot píše v Po 25. 09. 2017 v 14:46 -0300:
>>
>>> Simply replacing the URL + protocol does not work so easy because the
>>> protocols are handled by different applications: http:// is handled
>>> by
>>> the browser and file:// is handled by a file manager, or undefined.
>>>
>>> in my linux system the command invokes
>>>
>>> xdg-open: file
>>> '/home/tdf/git/core/instdir/help3/help.html?swriter/sfx/ui/startcente
>>> r/open_all?Language=fr&System=UNIX&Version=6.0'
>>> does not exist
>>
>> Oh yes, the problem is that xdg-open is confused about the parameters
>> there - it thinks it is still part of the filename :-(
>>
>> But if you do 'xdg-open file:///some/file/ending_with.html' , it opens
>> that in the browser; so I think whenever the help file is supposed to
>> be open, the easiest will be to write a temporary redirectXYZABC.html
>> file like:
>>
>> <!DOCTYPE HTML>
>> <html lang="en-US">
>>     <head>
>>         <meta charset="UTF-8">
>>         <meta http-equiv="refresh" content="1;
>> url=file:///<...>?Language=fr&System=UNIX&Version=6.0">
>>         <script type="text/javascript">
>>             window.location.href =
>> "file:///<...>?Language=fr&System=UNIX&Version=6.0"
>>         </script>
>>         <title>Help Page Redirection</title>
>>     </head>
>>     <body>
>>         ... a short explanation about the help maybe? ...
>>         <!-- Note: don't tell people to `click` the link, just tell them
>> that it is a link. -->
>>         If you are not redirected automatically, follow this <a
>> href='file:///<...>?Language=fr&System=UNIX&Version=6.0'>link to
>> example</a>.
>>     </body>
>> </html>
>>
>> and let xdg-open open that one.
>>
>> I've tested here, and xdg-open opens this in the webbrowser & the
>> redirect works fine :-)  So that + some proper cleanup of the temp
>> directory will do that I hope.
>>
>> All the best,
>> Kendy
>> _______________________________________________
>> LibreOffice mailing list
>> LibreOffice at lists.freedesktop.org
>> https://lists.freedesktop.org/mailman/listinfo/libreoffice
>>
> 

-- 
Olivier Hallot
LibreOffice Documentation Coordinator
Comunidade LibreOffice
Rio de Janeiro - Brasil - Local Time: UTC-02:00
http://tdf.io/joinus