Bug 130273 - HELP: Improve documentation for wrapped images in page headers (see comment 7)
Summary: HELP: Improve documentation for wrapped images in page headers (see comment 7)
Status: NEW
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
Version:
(earliest affected)
6.3.4.2 release
Hardware: All Linux (All)
: medium normal
Assignee: Not Assigned
URL:
Whiteboard:
Keywords:
Depends on:
Blocks: Writer-Images Help-Changes-Features
  Show dependency treegraph
 
Reported: 2020-01-30 02:07 UTC by Jambunathan K
Modified: 2020-05-08 18:35 UTC (History)
2 users (show)

See Also:
Crash report or crash signature:


Attachments
Screen recording of my actions (1.23 MB, video/mp4)
2020-01-30 02:07 UTC, Jambunathan K
Details
test.odt: Original file that I am editing (21.32 KB, application/vnd.oasis.opendocument.text)
2020-01-30 02:09 UTC, Jambunathan K
Details
test-after-header.odt: The document with replicated image (26.19 KB, application/vnd.oasis.opendocument.text)
2020-01-30 02:10 UTC, Jambunathan K
Details
A screenshot of the problem (27.26 KB, image/png)
2020-01-30 02:13 UTC, Jambunathan K
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Jambunathan K 2020-01-30 02:07:31 UTC
Created attachment 157515 [details]
Screen recording of my actions

When I replicate (i.e., copy-paste) a captioned image from text body to the page header,  the original wrapping is not preserved
Comment 1 Jambunathan K 2020-01-30 02:09:01 UTC
Created attachment 157516 [details]
test.odt: Original file that I am editing
Comment 2 Jambunathan K 2020-01-30 02:10:02 UTC
Created attachment 157517 [details]
test-after-header.odt:  The document with replicated image
Comment 3 Jambunathan K 2020-01-30 02:13:08 UTC
Created attachment 157518 [details]
A screenshot of the problem

The image in the header is a "replica" of the image in the body text.  Note how they are formatted differently.
Comment 4 Jambunathan K 2020-01-30 02:16:48 UTC
Version: 6.3.4.2.0+
Build ID: 1:6.3.4-2
CPU threads: 4; OS: Linux 5.4; UI render: default; VCL: gtk3; 
Locale: en-IN (en_IN.UTF-8); UI-Language: en-US
Calc: threaded

~$ uname -a
Linux debian 5.4.0-2-amd64 #1 SMP Debian 5.4.8-1 (2020-01-05) x86_64 GNU/Linux

~$ dpkg -l | grep writer
ii  libreoffice-writer                    1:6.3.4-2                            amd64        office productivity suite -- word processor
Comment 5 Justin L 2020-02-07 17:37:09 UTC
Text wrapping is intentionally not allowed in headers/footers in order to enhance compatibility with MS Office.  See bug 39155.

The ability to wrap in headers/footers is a compatibility option.  (Options - Writer - compatibility -  and enable "Use OpenOffice.org 1.1 text wrapping around objects". I tested that and it worked with your sample document.
Comment 6 Dieter 2020-02-10 15:44:21 UTC
Jambunathan, as far as I understand Justins comment it is the intended behaviour and not a bug. So can we close the report as RESOLVED NOTABUG?

=> NEEDINFO
Comment 7 Jambunathan K 2020-02-11 02:50:15 UTC
(In reply to Justin L from comment #5)
> Text wrapping is intentionally not allowed in headers/footers in order to
> enhance compatibility with MS Office.  See bug 39155.
> 
> The ability to wrap in headers/footers is a compatibility option.  (Options
> - Writer - compatibility -  and enable "Use OpenOffice.org 1.1 text wrapping
> around objects". I tested that and it worked with your sample document.

Ok. Thanks. I am now seeing that the  text is wrapped around header image.

I would appreciate if you could consider improving documentation as a part of resolving this bug.

1. The contextual Help for 'Wrap' (i.e., https://help.libreoffice.org/6.4/en-US/text/swriter/01/05060200.html?&DbPAR=WRITER&System=UNIX) MUST link to the 'Compatibility' node, and specifically mention that wrapping behaviour on 


2. The 'Compatibility' (i.e., https://help.libreoffice.org/6.4/en-US/text/shared/optionen/01041000.html?DbPAR=SHARED#bm_id3577990) says   

> To access this command...
> Open a text document, choose Tools - Options - LibreOffice Writer - > Compatibility.
> Some of the settings defined here are only valid for the current document and must be defined separately for each document.

The node should tell clearly which of the options are per-document options.  I confirm that the ""Use OpenOffice.org 1.1 text wrapping around objects" is a per-document option.  The 'settings.xml' now has 

```
<config:config-item-set config:name="ooo:configuration-settings">
   <config:config-item config:name="UseFormerTextWrapping" config:type="boolean">true</config:config-item>
</config:config-item-set>
```


> Use OpenOffice.org 1.1 text wrapping around objects

> Microsoft Word and Writer have different approaches on wrapping text around floating screen objects. Floating screen object are Writer frames and drawing objects, and the objects 'text box', 'graphic', 'frame', 'picture' etc. in Microsoft Word.

(IIUC, this is no longer true. As far as wrapping on header text is concerned, LibreOffice works in "compatible" mode.)

My suggestion .... remove the above paragraph.

> In Microsoft Word and in current versions of Writer, page header/footer content and footnote/endnote content does not wrap around floating screen objects. Text body content wraps around floating screen objects which are anchored in the page header.

This paragraph is very very confusing on some many levels.  

a) "current version" ===>  "current" here means /whenever/ StarOffice 8 or OpenOffice.org 2.0 was released.  That is "current" refers to some ancient time.

b) The first sentence says "does NOT wrap" and the second sentence says "wraps".     This is confusing.  The second sentences also seems to suggest that besides various anchor points like character, paragraph, frame etc. there is one more anchor point called "page header".  When I invoke the UI for object's anchor there really is no way to "anchor to page header".

(This paragraph has to moved / copied to the 'Wrap' help node)  

I suggest the following re-wording ...

By default, the page header/footer content and footnote/endnote
content does not wrap around floating screen objects.  This behaviour
is same as how Microsoft Word treats these objects.  In order to wrap
text around floating screen objects, in header/footer or
footnote/endnote turn on "Use OpenOffice.org 1.1 text wrapping around
objects"



> In Writer versions prior to StarOffice 8 or OpenOffice.org 2.0, the opposite was true.
> If the option is off, which is the default setting, the new text wrapping will be applied. If the option is on, the former text wrapping will be applied. 

(This may be of interest to LibreOffice developers.   This is of no interest to  "current" users of LibreOffice)

My suggestion ... Remove this paragraph.
Comment 8 Jambunathan K 2020-02-11 02:54:05 UTC
(In reply to Jambunathan K from comment #7)

> 
> By default, the page header/footer content and footnote/endnote
> content does not wrap around floating screen objects.  This behaviour
> is same as how Microsoft Word treats these objects.  In order to wrap
> text around floating screen objects, in header/footer or
> footnote/endnote turn on "Use OpenOffice.org 1.1 text wrapping around
> objects"

This paragraph (possibly with some improvements) should be in 'Wrap' help node.
Comment 9 Jambunathan K 2020-02-11 03:04:26 UTC
> Options - Writer - compatibility -  and enable "Use OpenOffice.org 1.1 text wrapping around objects". 

(In reply to Dieter from comment #6)
> Jambunathan, as far as I understand Justins comment it is the intended
> behaviour and not a bug. So can we close the report as RESOLVED NOTABUG?
> 
> => NEEDINFO


As part of resolving this issue consider improving the existing documentation.

(a) I have made some suggestions for 'Wrap' and 'Compatibility' nodes.


(b) Event after all those suggestions,  I am still left with one question ... 

    How do I wrap text around header images in "Microsoft Word" compatible way? 

The help documentation (or the Writer Guide) should tell me how to do it.  
(Right now, the documentation advises me to sacrifice compatibility ... and anyone who shares documents with others will have reservations about sacrificing MS compatibility)  

A quick Google search suggests, that wrapping text around header images does crop up very often, and I would very much want to the alternative means to achieve it in "compatible" manner.
Comment 10 QA Administrators 2020-02-11 03:31:19 UTC Comment hidden (obsolete)
Comment 11 Dieter 2020-02-11 13:56:43 UTC
I changed component to documentation

cc: Olivier Hallot