Re: [oXygen-user] Going from FrameMaker to oXygen -- Print-ready/Outline view issues

[Oxygen XML Editor Support (Radu Coravu)]

Hi Frank,


About this specific request:


So I thought maybe I could perhaps quickly toggle the "Print-ready" 
style on and off to see the tags and better find the correct cursor 
position. Can I create a keyboard shortcut for doing this?



We do not yet have a means to set a certain keyboard shortcut for 
applying a CSS layer, we have an internal issue for this, I added your 
contact details to it and I'm pasting the issue ID below for future 
reference:



    EXM-22482 Assign hot keys for the alternate styles (CSS API)


There are other ways in which someone could for example create a custom 
Author action which sets a certain pseudo class on an element and then 
the CSS selectors can use that pseudo class to enable or disable certain 
properties. For example with the "custom.css" file I'm attaching I added 
a button directly in the Author visual editor and when the button is 
clicked, a certain CSS pseudo class is set on the root element and the 
tags are shown or hidden based on it.



Regards,

Radu

Radu Coravu
Oxygen XML Editor

On 1/3/23 19:36, Frank Dissinger wrote:


Hi all,


This is my first posting to this list.


I am in the process of switching from FrameMaker V11 + DITA-FMx to 
oXygen V25 as my DITA editing tool. I have been using oXyen for quite 
a while as a transformation engine, but not as an editor. So in this 
respect I am still at the bottom of the learning curve.



I'd like to set up the Author mode in a way which comes close to what 
I was used in FrameMaker. I mainly worked in WYSIWYG view and with the 
Structure View, Elements and Attributes windows.



I have spent some effort on making oXygen's "Print-ready" view for the 
Editor window (in Author mode) look as WYSIWYG-ish as possible, with 
custom CSS styles that give me visual clues to the underlying XML 
structure. I then thought that I could use oXygen's Outline view in a 
similar way as FM's Structure View, but I feel quite lost in this window.


  * It does not allow me to position the cursor between the elements
  * It shows only a single attribute, not all attributes that are set
  * It shows only the attribute value, not the name
  * ...

I therefore find it hard to see the XML structure in the Outline view 
and to place the cursor precisely when I want to insert new elements.



So I thought maybe I could perhaps quickly toggle the "Print-ready" 
style on and off to see the tags and better find the correct cursor 
position. Can I create a keyboard shortcut for doing this?



Thank you.


Regards,


Frank


--

*Frank Dissinger*

Documentation Manager



*CGS Publishing Technologies International GmbH*

*Email *frank.dissin...@cgs-oris.com | *Web* www.cgs-oris.com 



*Address* Kettelerstr. 24 | D-63512 Hainburg | Germany

*Phone* +49 6182 9626-27 | *Fax* +49 6182 9626-99

*Commercial register* Offenbach, HRB no. 21495

*Managing directors* Bernd Rückert, Christoph Thommessen


https://www.cgs-oris.com/Signatur.png 

___
oXygen-user mailing list
oXygen-user@oxygenxml.com
https://www.oxygenxml.com/mailman/listinfo/oxygen-user
:root:before{
display:block;
content: oxy_button(action, oxy_action(
  name, 'Toggle Full Tags', 
  description, 'Toggle Full Tags', 
  operation, 'ro.sync.ecss.extensions.commons.operations.TogglePseudoClassOperation', 
  arg-elementLocation, '.',
  arg-name, 'no-tags'
));
}

:root:no-tags, :root:no-tags * {
-oxy-display-tags:none;
}___
oXygen-user mailing list
oXygen-user@oxygenxml.com
https://www.oxygenxml.com/mailman/listinfo/oxygen-user

Re: [oXygen-user] Going from FrameMaker to oXygen -- @type not added automatically

[Oxygen XML Editor Support (Radu Coravu)]

Hi Frank,


Please see some remarks below:


I understand that the "type" and "format" attributes are required or 
at least a good practice for "topicref" elements.



They are not required and they are not a best practice either.

From what I've experienced along these years, most end users who want 
these attributes to be added automatically are usually the ones 
migrating from Framemaker or using both Oxygen and Framemaker on the 
same set of DITA files.


My general best practice for these attributes would be:


1) For the "type" attribute, never set it on any link or topicref as the 
publishing engine will infer it from the target.


2) For the "format" attribute, Oxygen by default sets it on references 
to DITA Maps and non-DITA topics, but when referencing DITA topics, the 
@format attribute is not set automatically as it's default value when 
not set is "dita".





When I insert a new dita resource into a ditamap (i.e. a new topic or 
map which I create and insert in one go), oXygen should add these 
attributes automatically. I have set the options under "Options > 
Preferences > DITA > Maps" accordingly.



However, only "format" attributes are set, "type" attributes are not 
set although I have checked both options.
Checking those "Format" and "Type" checkboxes in the "Options > 
Preferences > DITA > Maps" preferences page should work...


I tested and indeed, if in the DITA Maps Manager I insert a reference to 
an existing topic file, the attributes are automatically added, but if I 
use for example the contextual action "Append child->New" to create a 
topic and insert a reference to it, then indeed the attributes are not 
set on the topicref. Is this close to how you are doing things on your side?


I added an internal issue to look into fixing this problem on our side, 
adding the issue ID below for future reference:



    EXM-52131 DITA Maps Manager creating new topic does not 
automatically add type and format attributes to topicref



Hope this helps.


Regards,

Radu

Radu Coravu
Oxygen XML Editor


On 1/3/23 21:08, Frank Dissinger wrote:


Hi list,


I understand that the "type" and "format" attributes are required or 
at least a good practice for "topicref" elements.



When I insert a new dita resource into a ditamap (i.e. a new topic or 
map which I create and insert in one go), oXygen should add these 
attributes automatically. I have set the options under "Options > 
Preferences > DITA > Maps" accordingly.



However, only "format" attributes are set, "type" attributes are not 
set although I have checked both options.



Is this a bug or am I missing something?


I use oXygen V25.


Regards,


Frank


--

*Frank Dissinger*

Documentation Manager



*CGS Publishing Technologies International GmbH*

*Email *frank.dissin...@cgs-oris.com | *Web* www.cgs-oris.com 



*Address* Kettelerstr. 24 | D-63512 Hainburg | Germany

*Phone* +49 6182 9626-27 | *Fax* +49 6182 9626-99

*Commercial register* Offenbach, HRB no. 21495

*Managing directors* Bernd Rückert, Christoph Thommessen




___
oXygen-user mailing list
oXygen-user@oxygenxml.com
https://www.oxygenxml.com/mailman/listinfo/oxygen-user
___
oXygen-user mailing list
oXygen-user@oxygenxml.com
https://www.oxygenxml.com/mailman/listinfo/oxygen-user

Re: [oXygen-user] Going from FrameMaker to oXygen -- Print-ready/Outline view issues

[Kristen James Eberlein]

Hi, Frank.

I have not used FrameMaker for almost two decades, so I cannot be of much help 
in your quest to “set up the Author mode in a way which comes close to what I 
was used in FrameMaker”. Whether or not you can do that, I truly don’t know.

It might be the case that it would be helpful for you to state your needs as 
functional requirements – While Oxygen might not offer the same authoring 
nuances/interface as FrameMaker, if it can be done in XML, Oxygen offers a way 
to do it!

For example, here are the requirements that I inferred from your e-mail:


  *   As an author, I want to have a WYSIWYG interface that looks similar to 
how content is rendered for my company. (Easy to do with CSS and an Oxygen 
framework.)
  *   As an author, I want to easily navigate in a lengthy XML document. (This 
is what the Outline view is optimized for, to enable you to locate a specific 
element rapidly.)
  *   As an author, I want to have a WYSIWYG view where I can easily view the 
underlying structure, both elements and attributes. (For me, here is where I 
use the authoring view with full tags and attributes turned on.)

Some of this, of course, might depend on what you mean by WYSWYG … Does WYSIWYG 
encompass the Oxygen Author view with “full tags and attributes”? Or are you 
primarily interested in the “no tags” view? If the latter, you can view the 
structure by looking at the breadcrumbs that are displayed at the top of the 
window, under the topic title, and the attributes by keeping the “Attributes” 
view open.

I think all Oxygen users have slightly different preferences, and they 
certainly can also be affected by whether one has an external monitor or is 
simply working within the confines of a small laptop or tablet screen.

Change is hard. Inevitably, when you switch tools, I think you run into a need 
to shift at least a little of your habits and preferences.

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Owner, Eberlein Consulting LLC
k...@eberleinconsulting.com
Skype: kriseberlein; voice: +1 (919) 622-1501

From: oXygen-user  On Behalf Of Frank 
Dissinger
Sent: Tuesday, January 3, 2023 12:36 PM
To: Oxygen User Mailing List 
Subject: [oXygen-user] Going from FrameMaker to oXygen -- Print-ready/Outline 
view issues


Hi all,



This is my first posting to this list.



I am in the process of switching from FrameMaker V11 + DITA-FMx to oXygen V25 
as my DITA editing tool. I have been using oXyen for quite a while as a 
transformation engine, but not as an editor. So in this respect I am still at 
the bottom of the learning curve.



I'd like to set up the Author mode in a way which comes close to what I was 
used in FrameMaker. I mainly worked in WYSIWYG view and with the Structure 
View, Elements and Attributes windows.



I have spent some effort on making oXygen's "Print-ready" view for the Editor 
window (in Author mode) look as WYSIWYG-ish as possible, with custom CSS styles 
that give me visual clues to the underlying XML structure. I then thought that 
I could use oXygen's Outline view in a similar way as FM's Structure View, but 
I feel quite lost in this window.

  *   It does not allow me to position the cursor between the elements
  *   It shows only a single attribute, not all attributes that are set
  *   It shows only the attribute value, not the name
  *   ...

I therefore find it hard to see the XML structure in the Outline view and to 
place the cursor precisely when I want to insert new elements.



So I thought maybe I could perhaps quickly toggle the "Print-ready" style on 
and off to see the tags and better find the correct cursor position. Can I 
create a keyboard shortcut for doing this?



Thank you.



Regards,



Frank


--

Frank Dissinger

Documentation Manager



CGS Publishing Technologies International GmbH

Email frank.dissin...@cgs-oris.com | Web 
www.cgs-oris.com

Address Kettelerstr. 24 | D-63512 Hainburg | Germany

Phone +49 6182 9626-27 | Fax +49 6182 9626-99

Commercial register Offenbach, HRB no. 21495

Managing directors Bernd Rückert, Christoph Thommessen


[https://www.cgs-oris.com/Signatur.png]
___
oXygen-user mailing list
oXygen-user@oxygenxml.com
https://www.oxygenxml.com/mailman/listinfo/oxygen-user

[oXygen-user] Going from FrameMaker to oXygen -- @type not added automatically

[Frank Dissinger]

Hi list,


I understand that the "type" and "format" attributes are required or at 
least a good practice for "topicref" elements.



When I insert a new dita resource into a ditamap (i.e. a new topic or 
map which I create and insert in one go), oXygen should add these 
attributes automatically. I have set the options under "Options > 
Preferences > DITA > Maps" accordingly.



However, only "format" attributes are set, "type" attributes are not set 
although I have checked both options.



Is this a bug or am I missing something?


I use oXygen V25.


Regards,


Frank


--

*Frank Dissinger*

Documentation Manager



*CGS Publishing Technologies International GmbH*

*Email *frank.dissin...@cgs-oris.com | *Web* www.cgs-oris.com 



*Address* Kettelerstr. 24 | D-63512 Hainburg | Germany

*Phone* +49 6182 9626-27 | *Fax* +49 6182 9626-99

*Commercial register* Offenbach, HRB no. 21495

*Managing directors* Bernd Rückert, Christoph Thommessen


___
oXygen-user mailing list
oXygen-user@oxygenxml.com
https://www.oxygenxml.com/mailman/listinfo/oxygen-user

[oXygen-user] Going from FrameMaker to oXygen -- Print-ready/Outline view issues

[Frank Dissinger]

Hi all,


This is my first posting to this list.


I am in the process of switching from FrameMaker V11 + DITA-FMx to 
oXygen V25 as my DITA editing tool. I have been using oXyen for quite a 
while as a transformation engine, but not as an editor. So in this 
respect I am still at the bottom of the learning curve.



I'd like to set up the Author mode in a way which comes close to what I 
was used in FrameMaker. I mainly worked in WYSIWYG view and with the 
Structure View, Elements and Attributes windows.



I have spent some effort on making oXygen's "Print-ready" view for the 
Editor window (in Author mode) look as WYSIWYG-ish as possible, with 
custom CSS styles that give me visual clues to the underlying XML 
structure. I then thought that I could use oXygen's Outline view in a 
similar way as FM's Structure View, but I feel quite lost in this window.


 * It does not allow me to position the cursor between the elements
 * It shows only a single attribute, not all attributes that are set
 * It shows only the attribute value, not the name
 * ...

I therefore find it hard to see the XML structure in the Outline view 
and to place the cursor precisely when I want to insert new elements.



So I thought maybe I could perhaps quickly toggle the "Print-ready" 
style on and off to see the tags and better find the correct cursor 
position. Can I create a keyboard shortcut for doing this?



Thank you.


Regards,


Frank


--

*Frank Dissinger*

Documentation Manager



*CGS Publishing Technologies International GmbH*

*Email *frank.dissin...@cgs-oris.com | *Web* www.cgs-oris.com 



*Address* Kettelerstr. 24 | D-63512 Hainburg | Germany

*Phone* +49 6182 9626-27 | *Fax* +49 6182 9626-99

*Commercial register* Offenbach, HRB no. 21495

*Managing directors* Bernd Rückert, Christoph Thommessen


https://www.cgs-oris.com/Signatur.png ___
oXygen-user mailing list
oXygen-user@oxygenxml.com
https://www.oxygenxml.com/mailman/listinfo/oxygen-user