Document options "Use style defined in templa

[skiwi]

Document options "Use style defined in template for notes" (shame subject is too short)

The help says

Use style defined in template for notes
 Apply the template-defined style for notes instead of the RTF styles defined within the element.

Whoop de do, but what does it mean when I set the option on?

Specifically what is the name of the style that EA uses for the bulletted and numbered lines.
In other words what named style (perhaps 'bullet 1', or 'list number' 1) that I need to have defined in normal.rtf or the rtf template so that note formatting works?

When I generate with the option off Word shows the style as
Normal + Style Custom Color(RGB(0128255)) Pattern: Clear


When I generate with the option on Word shows the style as
Normal + Style Left:  0 cm Hanging:  0.63 cm After:  0.05 pt Pattern: Clear


See the problem in the above - no formatting!
Note that when the option is on ALL formatting in the note is lost!



Note that the help is a bit misleading - check the help page - the picture in the help is not the same as the document options displayed when editing the template

[Eve]

It's doing exactly what it says.  Overriding the styles specified in your notes, with the style in your template.  What were you expecting?

[RoyC]

I should also point out that the Document Options topic describes and depicts the Options and Advanced tabs of the Generate RTF Documentation dialog, and does not depict the Document Options dialog.

It does, however, explain that the Document Options dialog combines the options from the Options and Advanced tabs of the Generate RTF Documentation dialog, and includes the Element Filters and Other Filters tabs from that dialog, with three minor differences (which are identified at the end of the topic).

Because the options are identical, we have not documented them twice. We followed the flow of the topics (tabs/facilities of the Generate RTF Documentation dialog) and pointed out the parallel of the Document Options dialog.

[skiwi]

What were you expecting?

I was expecting that EA would generate a "named" style in the generated document that I could then use to customise the formatting for the note styling.

I certainly wasn't expecting that it would remove all styling, because then the option would have (should have) been named "remove all styling".

[skiwi]

Because the options are identical, we have not documented them twice. We followed the flow of the topics (tabs/facilities of the Generate RTF Documentation dialog) and pointed out the parallel of the Document Options dialog.

Thanks for that clarification. It certainly wasn't easy to follow at first glimpse.

[skiwi]

It's doing exactly what it says.?

I don't agree with this, in fact I don't even understand what it means.

What does it means when it says "style in template". Perhaps an example in the documentation would be a good idea to clarify this.

Perhaps you could explain, in great detail (because I have literally struggled with this for several weeks, including submitting a bug report - for which there has been no resolution) exactly how the following quote is to be interpreted

Apply the template-defined style for notes instead of the RTF styles defined within the element.

[Eve]

If the text used for that field in the template is italics, 16pt, yellow and times new roman.  That is the template style, this will be used in preference to the bold red styling that is used for part of the note.

The option is changing where styling information is obtained from.  It is not removing all styling information.

[skiwi]

The option is changing where styling information is obtained from.  It is not removing all styling information.

OK, thanks, that is closer to what I expected.

I have looked in the normal.rtf template and can see no (named) style that supports numbered or bulleted lists.
So where does the "template style" come from?

When you say "field" what do you mean. Do you mean the "note field" as substituted into the document from the EA model?

I'm guessing then that the underlying style for the "note field" as formatted in the template document will format the note, so I can't see how the note text can have any styling retained from the model source. And this is what I have observed.

I have observed that different formatting is generated depending on the setting of the option.
However this formatting is problematic because it does not use either a named style (preferred) or built in numbering or bulleting.

This is why I expected that bullet and numbered lists would have a named style (cf heading 1) that could then be customised (as can heading 1, normal, etc).

While understanding a little more about how this option works,
my problem remains that I have a scenario where no matter what the setting of this option what is bulleted in a model note IS NOT bulleted in the generated document.
It looks like the formatting/style information has been removed.

[RoyC]

Can you clarify something?

In your initial post, you show an example of the Note text when the Use style defined in template for notes option is NOT SELECTED. This shows black 'normal text', blue bulleted text, and red numbered text.  

In your last post, you say that you now get unformatted text regardless of whether or not the option is selected. Is that true? You no longer get the blue bulleted text and red numbered text when the option is not selected?

If THAT is the case, there might be a bug.

Setting that aside, when you show the formatted Notes text in your initial post, you say that Word "shows the style as ..."   What is the style that Word is showing as ...?  Because that is the style that you need to define the way you want it in your template, if you don't want to use the RTF style as used in the Notes field in the element Properties dialog.

[skiwi]

Formatting with Use style option set to OFF


Formatting with Use style option set to ON


I'll have to investigate further about whether I think there is a bug. I'm not clear about when the option is set in the template, and when the option is only set in the Resource document. So this morning (with a rebooted machine) I am getting formatting whenever the option is OFF.

In the images above I show the formatting as displayed by Word for each of the settings of the option. Note that in neither case is there a "named style", the style is set to 'Normal' and formatting appears to be placed on to of that. This means there is no opportunity to modify a style (with a name)  (say in normal.rtf) for bullets (eg to change the symbol, indenting, spacing etc).

[skiwi]

Here is the number and the bullet selected (rather than the text) to show the style/formatting

[skiwi]

The spell checker is most revealing when it comes to the underlying storage format for notes, viz

Code: [Select]

This example shows that bullets are not correctly rendered in build 858,
when the document is generated with a model template.

The underlying repository is SQL Server 2005.
EA is running on WXP SP3.

The following line is a <u>bullet</u>
<ul>
      <li><font color="#0080ff">this is a bulleted line coloured <b>blue</b></font></li>
</ul>

The following line is <u>numbered</u>
<ol>
      <li><font color="#ff0080">this is a numbered line coloured <i>red</i></font></li>
</ol>

When generated with the system template "(model document: basic template)" the bullets display.
When generated with the model template &ldquo;MinEdu: Packages, Diagrams, Elements, Diagrams&rdquo;, the bullets, numbers, and colours do not show.

<font color="#0080ff">This is a line coloured <b>blue</b>.</font>
<font color="#ff0000">This is a line coloured <i>red</i>.</font>

[skiwi]

Bump. Does anyone else have some experiences with this?

I suggest that bullets and numbering be specifically styles in notes, eg

Code: [Select]

<ul class="EA-bullet-style-for-word">
      <li>etc</li>
</ul>

<ol class="EA-numbered-style-for-word">
      <li>etc</li>
</ol>

[skiwi]

Let me rephrase the question here.

When I set the option to "on", ie use styles in my template (aka the template from the resources tab),
How do I apply those styles to bullet lists, or numbered lists, in the notes, if, as it appears EA has stripped all the underlying HTML (and not just the font/CSS) from the note?

[Eve]

Bulleting is a text style.  In the build of EA your signature says you are using it is overridden by the template.  You may be interested in the release notes for build 864...

Style for notes fields in generated documentation improved.
    . Paragraph spacing, alignment and indents.  Font face and size will always be copied from template.
    . Font color and styles such as bold or italics can be copied from template if 'Use Style Defined in Templates for notes' is set.