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.dissinger@cgs-oris.com | *Web* www.cgs-oris.com <http://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 <https://www.cgs-oris.com/signatur>
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.dissinger@cgs-oris.com | *Web* www.cgs-oris.com <http://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
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.dissinger@cgs-oris.com | *Web* www.cgs-oris.com <http://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
Hi Radu, Thank you for this clarification. Good to know that the Type and Format attributes are neither required nor good practice. This makes life easier. /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 right-clicked in the Editor window and selected /"/Insert > Insert New DITA Resource", then I selected a custom framework template. / / Regards, Frank/ / ------------------------------------------------------------------------ Am 04.01.2023 um 06:57 schrieb 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.dissinger@cgs-oris.com | *Web* www.cgs-oris.com <http://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 <https://www.cgs-oris.com/signatur>
Hi Frank, So:
Good to know that the Type and Format attributes are neither required nor good practice. /.../ There is a problem which may occur if you are using the @type attribute on and off inconsistently.
So let's say you have a DITA Map which uses it a lot like:
<topicref href="topics/task.dita" type="task"/> and then you decide not to use it anymore on topicrefs, so you might end up with something like this:
<topicref href="topics/task.dita" type="task"> <topicref href="topics/concept.dita"/> </topicref> So the reference to "concept.dita" no longer has @type set on it, but the parent task.dita has type set on it. And the DITA specification states that in such cases the @type attribute value cascades to the child element. So when publishing the DITA Map content is interpreted as:
<topicref href="topics/task.dita" type="task"> <topicref href="topics/concept.dita" type="task"/> </topicref> which will trigger a publishing warning.
Oxygen's "Validate and check for completeness" action from the "DITA maps manager" view should report such problems. But in general, once you decide not to use @type in the DITA map, you should actively remove the attribute from the DITA Map otherwise you end up with @type attribute values cascading on to topicrefs which no longer have the @type attribute set.
I right-clicked in the Editor window and selected /"/Insert > Insert New DITA Resource", then I selected a custom framework template.
Thanks, I added your details to the already opened issue. Regards, Radu Radu Coravu Oxygen XML Editor On 1/9/23 17:02, Frank Dissinger wrote:
Hi Radu,
Thank you for this clarification. Good to know that the Type and Format attributes are neither required nor good practice. This makes life easier.
/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 right-clicked in the Editor window and selected /"/Insert > Insert New DITA Resource", then I selected a custom framework template.
/ /
Regards,
Frank/
/
------------------------------------------------------------------------ Am 04.01.2023 um 06:57 schrieb 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.dissinger@cgs-oris.com | *Web* www.cgs-oris.com <http://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 <https://www.cgs-oris.com/signatur>
_______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com https://www.oxygenxml.com/mailman/listinfo/oxygen-user
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 kris@eberleinconsulting.com Skype: kriseberlein; voice: +1 (919) 622-1501 From: oXygen-user <oxygen-user-bounces@oxygenxml.com> On Behalf Of Frank Dissinger Sent: Tuesday, January 3, 2023 12:36 PM To: Oxygen User Mailing List <oxygen-user@oxygenxml.com> 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.dissinger@cgs-oris.com<mailto:frank.dissinger@cgs-oris.com> | Web www.cgs-oris.com<http://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]<https://www.cgs-oris.com/signatur>
Hi Kris, Thank you for your reply. I fully agree with the requirements you describe. In FrameMaker I was used to work in WYSIWYG view with no tags displayed. The Structure View and the formatting styles in the Editor window gave me enough information about the DITA tags and structure. I used the Elements window to insert or wrap elements and edited Attributes using the Structure View or a DITA-FMx dialog. When I now view my DITA topics in oXygen I would like to see them in a similar way just because otherwise I wouldn't be sure if it is really the same document. Sounds strange perhaps, but it is indeed extremely confusing to me to see something that seems to be different. Perhaps after some time, when I am conversant with oXygen, I may have more confidence in other views... So in oXygen I prefer the "No tags" view. With this there are still lots of icons (for opening link targets, expand/collapse sections...) and additional text ("Short description", "Result", ...) which I would prefer to hide. Most of this can be done using the "Print-ready" style and lots of CSS code which I take from the CSS Inspector window and adapt. However, this means that I would have to rely on the Outline view, the Attributes window and the breadcrumbs to see the structure. These tools do not give me the same information, convenience and capabilities that I am used in FrameMaker. I therefore thought it could be a workaround to quickly toggle my preferred view ("Print ready") and "Full tags" (or "Full tags with attributs") using a keyboard shortcut. However, there are no shortcuts for styles. But I discovered that you can define keyboard shortcuts for "No tags", "Full tags", etc. And Radu gave me CSS code that creates a button in every topic that toggles between "No tags" and the last tags view chosen for the topic. I was able to get rid of some texts like "Short description" (which I indicate using a color) and the like using some more CSS code. The extra icons are still there, but they do not take up much room so I can live with them (and they are usful). Best regards, Frank ------------------------------------------------------------------------ Am 04.01.2023 um 06:42 schrieb 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 kris@eberleinconsulting.com
Skype: kriseberlein; voice: +1 (919) 622-1501
*From:* oXygen-user <oxygen-user-bounces@oxygenxml.com> *On Behalf Of *Frank Dissinger *Sent:* Tuesday, January 3, 2023 12:36 PM *To:* Oxygen User Mailing List <oxygen-user@oxygenxml.com> *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.dissinger@cgs-oris.com | *Web* www.cgs-oris.com <http://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
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.dissinger@cgs-oris.com | *Web* www.cgs-oris.com <http://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 <https://www.cgs-oris.com/signatur>
_______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com https://www.oxygenxml.com/mailman/listinfo/oxygen-user
Hi, Frank – I’m very interested in knowing what you are looking for, as Radu and I provided very different information! Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Owner, Eberlein Consulting LLC kris@eberleinconsulting.com Skype: kriseberlein; voice: +1 (919) 622-1501 From: oXygen-user <oxygen-user-bounces@oxygenxml.com> On Behalf Of Oxygen XML Editor Support (Radu Coravu) Sent: Wednesday, January 4, 2023 1:55 AM To: oxygen-user@oxygenxml.com Subject: Re: [oXygen-user] Going from FrameMaker to oXygen -- Print-ready/Outline view issues 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.dissinger@cgs-oris.com<mailto:frank.dissinger@cgs-oris.com> | Web www.cgs-oris.com<http://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]<https://www.cgs-oris.com/signatur> _______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com<mailto:oXygen-user@oxygenxml.com> https://www.oxygenxml.com/mailman/listinfo/oxygen-user
Thank you, Radu, for the CSS code. I have successfully implemented this button and it is a good workaround until a keyboard shortcut is available. I have made it to always stick at the top right of the Editor window using the CSS property "position: fixed". Unfortunately, this CSS code does not work with the "Print ready" style, only when it is disabled. As a result, I had to adjust a few more CSS styles to reimplement the visual representation that I wanted. Regards, Frank ------------------------------------------------------------------------ Am 04.01.2023 um 07:54 schrieb 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.dissinger@cgs-oris.com | *Web* www.cgs-oris.com <http://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 <https://www.cgs-oris.com/signatur>
_______________________________________________ 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
-- *Frank Dissinger* Documentation Manager .................................................................... *CGS Publishing Technologies International GmbH* *Email *frank.dissinger@cgs-oris.com | *Web* www.cgs-oris.com <http://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 <https://www.cgs-oris.com/signatur>
participants (3)
-
Frank Dissinger -
Kristen James Eberlein -
Oxygen XML Editor Support (Radu Coravu)