[Libreoffice-bugs] [Bug 108278] [HELPAUTHORING] Implement tag in Help Authoring extension

[bugzilla-daemon]

https://bugs.documentfoundation.org/show_bug.cgi?id=108278

Olivier Hallot  changed:

   What|Removed |Added

 Status|NEW |RESOLVED
 Resolution|--- |WONTFIX

--- Comment #1 from Olivier Hallot  ---
Helpauthoring extension is deprecated. closing wontfix.

-- 
You are receiving this mail because:
You are the assignee for the bug.___
Libreoffice-bugs mailing list
Libreoffice-bugs@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/libreoffice-bugs

[Libreoffice-bugs] [Bug 108278] [HELPAUTHORING] Implement tag in Help Authoring extension

[bugzilla-daemon]

https://bugs.documentfoundation.org/show_bug.cgi?id=108278

Yousuf Philips (jay)  changed:

   What|Removed |Added

 Status|UNCONFIRMED |NEW
 CC||philip...@hotmail.com
 Ever confirmed|0   |1

-- 
You are receiving this mail because:
You are the assignee for the bug.___
Libreoffice-bugs mailing list
Libreoffice-bugs@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/libreoffice-bugs

[Libreoffice-bugs] [Bug 108278] New: [HELPAUTHORING] Implement tag in Help Authoring extension

[bugzilla-daemon]

https://bugs.documentfoundation.org/show_bug.cgi?id=108278

Bug ID: 108278
   Summary: [HELPAUTHORING] Implement  tag in Help
Authoring extension
   Product: LibreOffice
   Version: unspecified
  Hardware: All
OS: All
Status: UNCONFIRMED
  Severity: normal
  Priority: medium
 Component: Documentation
  Assignee: libreoffice-bugs@lists.freedesktop.org
  Reporter: olivier.hal...@documentfoundation.org
CC: olivier.hal...@documentfoundation.org
Blocks: 93580

An  tag exist in help files XHP DTD, that allows to include objects
with specific mimetypes in the help content.

see https://wiki.documentfoundation.org/HelpContentAuthoring/3#object

e.g.


The Help Authoring tool does not support this tag, and the tag is erased on
saving the file. 

The task is to let helpauthoring tool read and save  tag *without
touching* its content (i.e. be transparent).

At best, also implement visual indication of the  in the document
opened in HA extension thru a Frame or OLE object. If there is a 1:1 mapping of
 and ODT OLE objects, then even better to display it (not checked).

Note: the  tag is *not* implemented into the help content because the
Writer/Web rendering engine is outdated and the XSLT transformation
main_transform.xsl does not transform this tag. But new rendering engines such
as browsers can implement a wider set of object types.


Referenced Bugs:

https://bugs.documentfoundation.org/show_bug.cgi?id=93580
[Bug 93580] [META] HELPAUTHORING Issues
-- 
You are receiving this mail because:
You are the assignee for the bug.___
Libreoffice-bugs mailing list
Libreoffice-bugs@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/libreoffice-bugs

Re: Help Authoring Extension

[Christian Lohmaier]

Hi Alex, *,

On Mon, Jul 27, 2015 at 9:34 AM, Alex Thurgood alex.thurg...@gmail.com wrote:
 Le 24/07/2015 23:06, Jan Holesovsky a écrit :
 [...]
   https://wiki.documentfoundation.org/Documentation/Help


 When I go to that page, there is a link to the extension:

 https://dev-www.libreoffice.org/helpauthoring/

Not true - it links to http://... (not https - that is your browser's
plugin at work)

 which leads to an error message in Firefox that the page can not be loaded.

That domain is not setup for https - you http to access it.

ciao
Christian
___
LibreOffice mailing list
LibreOffice@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/libreoffice

Re: Help Authoring Extension

[Alexander Thurgood]

Le 27/07/2015 15:37, Christian Lohmaier a écrit :

Hi Christian,




 Not true - it links to http://... (not https - that is your browser's
 plugin at work)
 

Indeed, I'm so used to forcing https everywhere, I kind of forget that
its not...


 
 That domain is not setup for https - you http to access it.
 


Thanks, will correct in my browser.


Alex

___
LibreOffice mailing list
LibreOffice@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/libreoffice

Re: Help Authoring Extension

[Alex Thurgood]

Le 24/07/2015 23:06, Jan Holesovsky a écrit :

Hi Kendy,

This sounds like a really nice move forward for help content authoring.

 I've spent some time today fixing the HelpAuthoring extension, and
 together with the Regina's fix (thank you, Regina!), I think it got to a
 usable state :-)
 
   https://wiki.documentfoundation.org/Documentation/Help
 

When I go to that page, there is a link to the extension:

https://dev-www.libreoffice.org/helpauthoring/

which leads to an error message in Firefox that the page can not be loaded.


Alex


___
LibreOffice mailing list
LibreOffice@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/libreoffice

Help Authoring Extension

[Jan Holesovsky]

Hi,

I've spent some time today fixing the HelpAuthoring extension, and
together with the Regina's fix (thank you, Regina!), I think it got to a
usable state :-)

  https://wiki.documentfoundation.org/Documentation/Help

describes where to get it, and the basic usage.  More detailed user
manual can be found here:

  https://wiki.documentfoundation.org/HelpContent

The .xhp's generated by the extension are now nicely formatted, which
means that when you save a .xhp in the help repository, it will likely
be a big diff the first time (due to the changed formatting - strings
should be preserved); but from then on, the changes should be tiny, as
the format will be much better defined.

Also the editing directly in LibreOffice seems to be neat  usable.
There might be rough edges still - but I hope no blocker any more.

In other words - *no excuses* for not writing help any more ;-)

Please do use it, and if you experience trouble, either fix it yourself:

  
http://cgit.freedesktop.org/libreoffice/contrib/dev-tools/tree/helpauthoring/README

or let me know - the xslt that implements the export filter is trivial.

Would be good to start thinking of a workflow between the developers and
the documentation team - I imagine developers could stub help for things
they are developing, and the documentation team members would then
finalize and de-hackerize that, but ideas how to grow the community of
help authors much appreciated.

[BTW - if you are wondering about the editable wikihelp: no, I'm not
abandoning the idea; but that is a long-term quest, and the help needs
improving _now_.]

All the best,
Kendy

___
LibreOffice mailing list
LibreOffice@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/libreoffice

Re: Help Authoring Extension

[Olivier Hallot]

Hi Kendy

Thanks indeed to you and Regina for the fix.

Regards

On 24/07/2015 18:06, Jan Holesovsky wrote:
 Hi,
 
 I've spent some time today fixing the HelpAuthoring extension, and
 together with the Regina's fix (thank you, Regina!), I think it got to a
 usable state :-)
 
   https://wiki.documentfoundation.org/Documentation/Help
 
 describes where to get it, and the basic usage.  More detailed user
 manual can be found here:
 
   https://wiki.documentfoundation.org/HelpContent
 
 The .xhp's generated by the extension are now nicely formatted, which
 means that when you save a .xhp in the help repository, it will likely
 be a big diff the first time (due to the changed formatting - strings
 should be preserved); but from then on, the changes should be tiny, as
 the format will be much better defined.
 
 Also the editing directly in LibreOffice seems to be neat  usable.
 There might be rough edges still - but I hope no blocker any more.
 
 In other words - *no excuses* for not writing help any more ;-)
 
 Please do use it, and if you experience trouble, either fix it yourself:
 
   
 http://cgit.freedesktop.org/libreoffice/contrib/dev-tools/tree/helpauthoring/README
 
 or let me know - the xslt that implements the export filter is trivial.
 
 Would be good to start thinking of a workflow between the developers and
 the documentation team - I imagine developers could stub help for things
 they are developing, and the documentation team members would then
 finalize and de-hackerize that, but ideas how to grow the community of
 help authors much appreciated.
 
 [BTW - if you are wondering about the editable wikihelp: no, I'm not
 abandoning the idea; but that is a long-term quest, and the help needs
 improving _now_.]
 
 All the best,
 Kendy
 
 ___
 LibreOffice mailing list
 LibreOffice@lists.freedesktop.org
 http://lists.freedesktop.org/mailman/listinfo/libreoffice
 

-- 
Olivier Hallot
Comunidade LibreOffice
http://ask.libreoffice.org/pt-br
___
LibreOffice mailing list
LibreOffice@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/libreoffice