- oXygen-user - www.oxygenxml.com

[ANN] Webinar: Transforming DITA documents to PDF using CSS, Part 4 – Advanced CSS Rules (January 18)
by Alin Belu 12 Jan '23

12 Jan '23

Hello, If you thought that your PDF customization journey was finished, well we have some amazing news for you! On the *18th of January*, Julien Lacour (senior software developer at Syncro Soft) will be returning with the 4th part of his *Transforming DITA documents to PDF using CSS* webinar series! This latest installment will be called *Advanced CSS Rules* and it will target those of you that were thinking about controlling the change bars display, modifying your PDF viewer behavior or centering and rotating your tables. So, clear you schedule for next Wednesday and get ready to take a deep dive into the following topics: * Advanced images display * Advanced tables display * Change bars customization * PDF Viewer control This is a free event but registration is required. You can register at https://oxygenxml.com/evs2023-3.html To stay in touch with us and discover what other events we have planned for you, please make sure to check https://www.oxygenxml.com/events_programme.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

Going from FrameMaker to oXygen
by Frank Dissinger 11 Jan '23

11 Jan '23

Hi Radu, Thank you also for this reply (on the DITA Users List). Regards, Frank ------------------------------------------------------------------------ Am 07.12.2022 um 08:10 schrieb Radu Coravu via groups.io: > > Hi Frank, > > > Here are some answers to your remarks, if you need more help about how > Oxygen works you can contact us directly: > > >> * It seems that a DITA map loads all the referenced submaps and >> displays all of these maps in a single window panel (as if this >> was a single file). In FM I see only the references and open the >> submaps as separate files by double-clicking on them. >> > In Oxygen a DITA Map can be opened both in the DITA Maps Manager view > and in the main editing area where it can be edited in either the > Author or the Text editing modes. > > I will assume you are referring to opening a DITA Map in the Author > visual editing mode. In the Oxygen Preferences->"DITA / Maps" page you > have a checkbox named "Expand references to other maps when opening a > map in the Author mode". > >> * I feel lost in these maps. There are lots of big fonts, frames, >> colored backgrounds, icons... Can I customize the appearance? For >> example, by defining CSS-like styles for the DITA elements >> displayed on the screen? >> > Yes, sure. The visual editing is CSS based. We have a CSS inspector > view which can be used to debug what CSS styles apply to render a > certain element in a certain way: > > https://www.oxygenxml.com/doc/versions/25.0/ug-editor/topics/author-css-ins… > > and you can contribute your own CSS for customizing the editing aspects: > > https://blog.oxygenxml.com/topics/customizeDITACSS.html > >> * The Outline view is a bit similar to FM's Structure View. But I >> am used to setting the cursor into the Structure View to >> precisely define the point where to insert an element. This does >> not work in oXygen. >> > Different applications have different features. Oxygen has a tooltip > window showing the context which appears when moving the caret in the > content, it also has various tags display modes which may be useful to > properly place the cursor. Maybe you can use those instead of the Outline. >> >> * I'd like to see text and images without any tags in one window >> panel and the DITA structure with elements and attributes in a >> separate panel. I know I can switch off tags and use the Outline >> view, but I am not sure if this really gives me full control over >> everything... >> > The Oxygen Outline is mostly intended to show the structure of the > content and allow you to select elements. >> >> * How does oXygen visualize conditionalized content >> (included/excluded via a ditaval file)? >> > Here's a link to the Oxygen user guide: > > https://www.oxygenxml.com/doc/versions/25.0/ug-editor/topics/dita-profiling… > > with some videos/webinars referenced at the end. > >> * Can I define a fixed page size in oXygen? I'd like to set a page >> width (height is not important) to make sure that images fit on >> the page and that table columns are not too narrow (in PDF >> deliverables). Setting an image resolution is also important. >> > By default Oxygen shows a US-letter outline around an edited DITA > topic. But this does not impose maximum width constraints, in a way in > this regard Oxygen behaves more like a web browser, not like a PDF > renderer. > > > Hope this helps. > > > Regards, > > Radu > > Radu Coravu > Oxygen XML Editor > > > On 12/6/22 18:42, Frank Dissinger wrote: >> >> Hi all, >> >> >> Are there any passionate long-term structured FrameMaker users who >> have changed to oXygen as a DITA editor? Has anybody tried to set up >> the oXygen authoring environment as close as possible to FrameMaker's >> WYSIWYG view? Or at least in a way that makes the switch as painless >> as possible for a FrameMaker user? >> >> >> I've been using FrameMaker V11+DITA-FMx as a DITA editor for many >> years -- until recently also as a PDF transformation engine, which I >> have now replaced with MiramoPDF. I have used oXygen for a few years >> only and mostly as a transformation engine. With FM I am stuck with >> an old DITA implementation and the DITA-FMx plug-in is not developed >> any further. This is why I would like to use oXygen as a DITA editor >> instead. But I find it very hard to make the switch: The way DITA >> maps, topics, tags, structures... are presented is so different and I >> haven't the time to learn oXygen properly and in full detail. It's >> such a powerful tool with tons of features. So I thought there may be >> someone who can help me getting started -- at least with setting up >> the user interface and authoring environment. >> >> >> A few examples of things I am struggling with right away when I look >> at how oXygen presents my DITA files: >> >> * It seems that a DITA map loads all the referenced submaps and >> displays all of these maps in a single window panel (as if this >> was a single file). In FM I see only the references and open the >> submaps as separate files by double-clicking on them. >> * I feel lost in these maps. There are lots of big fonts, frames, >> colored backgrounds, icons... Can I customize the appearance? For >> example, by defining CSS-like styles for the DITA elements >> displayed on the screen? >> * The Outline view is a bit similar to FM's Structure View. But I >> am used to setting the cursor into the Structure View to >> precisely define the point where to insert an element. This does >> not work in oXygen. >> * I'd like to see text and images without any tags in one window >> panel and the DITA structure with elements and attributes in a >> separate panel. I know I can switch off tags and use the Outline >> view, but I am not sure if this really gives me full control over >> everything... >> * How does oXygen visualize conditionalized content >> (included/excluded via a ditaval file)? >> * Can I define a fixed page size in oXygen? I'd like to set a page >> width (height is not important) to make sure that images fit on >> the page and that table columns are not too narrow (in PDF >> deliverables). Setting an image resolution is also important. >> * ... >> >> Regards, >> >> >> Frank >> >> _._,_ > ------------------------------------------------------------------------ > *Frank Dissinger* Documentation Manager .................................................................... *CGS Publishing Technologies International GmbH* *Email *frank.dissinger(a)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

1 0

Going from FrameMaker to oXygen
by Frank Dissinger 11 Jan '23

11 Jan '23

Hi Chris, Thank you again for your reply (on the DITA Users List). I haven't had the time to read it in full detail and try out some of the suggestions until now. * /Selecting just the opening tag and pressing Enter will allow you to change the element from one type to another./ How would you select just the opening tag? If I do that in Author mode, the opening and closing tag with everything in between gets selected. When I then press Enter, I can surround the tag with another. In Text mode, the tag gets deleted when I press Enter. * /We have a "Show Page Width" alternative CSS style that helps writers visualize page width, as a guide to table and figure sizing./ Would you mind sharing this style with me? Thank you. Best regards, Frank ------------------------------------------------------------------------ Am 07.12.2022 um 13:24 schrieb Chris Papademetrious: > Hi Frank, > > If you are not using the DITA Perspective in Oxygen, I suggest > enabling it: > > https://www.oxygenxml.com/doc/versions/25.0/ug-author/topics/dita-perspecti… > > It applies a collection of settings that are useful for DITA editing. > > Some more random thoughts: > > * We also find the tag-based map view in an editing window to be > somewhat overwhelming. We primarily edit maps in the following views: > o DITA Maps Manager - adding and restructuring content > o Editor window, Text view - fine-timing map attributes or > element structures > * Use keyboard shortcuts in the DITA Maps Manager - cursor keys to > move around and expand/collapse, and type the names of files to > auto-move to that matching file. > * When you select a topic editing window, if a map referencing that > topic is open in the DITA Maps Manager, it will scroll to that > topic's map entry. > o This is useful when you have multiple topic editing tabs open > and you want to quickly see the map context of each one while > editing. > * We bind a Ctrl-` (backtick) hotkey to toggling full tags on/off, > which makes it effortless to switch them on and off during > editing. This is a huge help!! > o I can provide details on how to configure this. > * Oxygen has a lot of clever shortcuts for element operations in the > editor. For example, > o Selecting just the opening tag and pressing Enter will allow > you to change the element from one type to another. > o Placing the cursor just after the opening tag and pressing > Backspace will unwrap the tag but keep its content. > o Using Tab/Shift-tab at the beginning of list items can change > their list level, including the element structure work needed > to make it happen. > * In editing windows, there is an element ancestry shown at the top > for the current cursor position. This can be useful, especially > when tags are hidden and you want to select some containing > element (like an entire <note> element when the cursor is > somewhere inside its content). > * We use shared CSS that configures the Oxygen editor, PDF output, > and WebHelp output to all share a common style. > o As we also come from a FrameMaker background, our writers > wanted Oxygen's editing window to be as close to the PDF as > possible. > o We have a "Show Page Width" alternative CSS style that helps > writers visualize page width, as a guide to table and figure > sizing. > * Using Find in Files and XPath/XQuery Builder to quickly find > content in your maps can be helpful. Oxygen's search capability is > very fast. > > > Feel free to ask for more details on any aspect of this! > > - Chris *Frank Dissinger* Documentation Manager .................................................................... *CGS Publishing Technologies International GmbH* *Email *frank.dissinger(a)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

1 0

Git addon on M1 Mac?
by Scott Prentice 10 Jan '23

10 Jan '23

Hi... I'm seeing that when you install the Git addon, on Oxygen 25 installed on an M1 Mac, when you restart Oxygen, it generates an error and can't start the editor. This has been verified on two different systems. It works fine on a non-M1 Mac. Is anyone else seeing this? Oxygen .. is this something you're aware of? Thanks! ...scott

3 4

Going from FrameMaker to oXygen -- Print-ready/Outline view issues
by Frank Dissinger 10 Jan '23

10 Jan '23

Hi Stefan, Thank you for your input and the userful links. I am climbing up the learnign curve... Regards, Frank ------------------------------------------------------------------------ Am 04.01.2023 um 06:33 schrieb Stefan Jung: > > Hi Frank, > > Maybe you should not try to make Oxygen so FrameMaker-ish. I'm in a > similar transition phase and my "unstructured" FrameMaker writers get > used to the Oxygen way if working very fast. > > I'd recommend using the keyboard more and the mouse less. You can > navigate with your arrow keys, also between elements. You can press > Enter, to insert an element. You do not need to move, for example, > after a step element to insert a new one. This is not necessary. > Oxygen is smart enough to determine where you probably want to insert > the element and Oxygen will not allow you to create invalid XML > structures in Author mode. Use ALT+Enter to edit attributes. > > You don't need to place your caret between elements in outline view, > because it allows you to add elements after and element (here you > still think in FrameMaker UI). > > Please read > https://www.oxygenxml.com/doc/versions/24.1/ug-editor/topics/text-navigate-… > > and https://blog.oxygenxml.com/topics/general_tips_and_tricks.html and > https://www.oxygenxml.com/doc/versions/24.1/ug-editor/topics/common-shortcu… > > > BR > Stefan > > Gesendet mit OX Mail > > Frank Dissinger <frank.dissinger(a)cgs-oris.com > <http://frank.dissinger@cgs-oris.com>> hat am January 4, 2023 um 5:45 > AM geschrieben: > > 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(a)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

1 0

Going from FrameMaker to oXygen -- Print-ready/Outline view issues
by Frank Dissinger 10 Jan '23

10 Jan '23

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(a)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>

3 9

Going from FrameMaker to oXygen / Outline View / Text duplicates
by Frank Dissinger 10 Jan '23

10 Jan '23

Hi Jang, Just to be sure we are talking about the same thing: Current behavior: What I want is this: I see no point in the current behavior. Why are empty elements marked as "filled" elements in oXygen? *@SyncroSoft* Feature request : Can the current behavior of the Outline view be changed to show empty elements as empty? If the current behavior is required (for whichever reason...), I understand that I'd need to implement DITA contstraints. Can you be more specific about that? How would I do this with oXygen? Regards, Frank ------------------------------------------------------------------------ Am 09.01.2023 um 11:27 schrieb 4everJang: > Hello Frank, > > About the last point in your missing features list: the DITA specs > allow plain text as well as block elements like inside an <li>. If > you create constraints that disallow plain text (and inline elements) > in the <li> you should get rid of the extra Text indicators in > oXygen’s author view. > > And I do suggest everyone to create constraints before starting to > work with DITA, as the definitions in the so-called standard DITA > packages allows almost everything and is not meant to be a useful > subset of elements for anyone’s specific content domain. The first > step in any useful DITA implementation is defining constraints and > possibly specialisations. I often get the reply from newbie DITA users > that they want to stick with standard DITA. Fact is that constraints, > and even specialisations, do not take you away from the standard. DITA > was intended to be customised, i.e. adapted to your particular content > domain, so that it will become as useful as possible - without pushing > you out of the standard. Any DITA tool should support constraints and > specialisations (as long as you create them in the defined manner), > otherwise they cannot claim to be DITA compliant at all. > > Good luck with the transition from FM to oXygen. > > *4everJang* > *Amsterdam, Netherlands* > > On 9 Jan 2023, 10:37 +0100, Frank Dissinger > <frank.dissinger(a)cgs-oris.com>, wrote: >> >> Hi Alan, >> >> >> Thank you for your reply. I fully agree with what you wrote about >> FM's Structure View. An excellent tool. >> >> >> It would be great if oXygen could enhance its Outline View and make >> it work in a similar way. I am especially missing the following features: >> >> * Allow users to place the cursor between tags, or at the >> beginning/end of the element contents, and indicate the position >> * Display attributes: Toggle between all/all with a value/none (no >> need to waste room on the screen for a separate Attributes window) >> * Expand/collapse complete tree of elements or attributes in one go >> (Shift-click) >> * Element content should not be repeated for empty wrapping >> elements, this is confusing (show it only once) >> For exmaple, for <li>Text..., the "Text" is shown both for >> <li> and . It should only be shown for . >> >> Can I add this as feature request? >> >> >> I have now switched to the oXygen Users Mailing List and will post >> any further oXygen-related issues there. >> >> >> Regards, >> >> >> Frank >> >> >> ------------------------------------------------------------------------ >> Am 04.01.2023 um 22:05 schrieb Alan Houser: >>> Chiming in a bit late here. Longtime structured FrameMaker and >>> oXygen user... >>> >>> *Frank mentions the FrameMaker structure view. IMO, this is the best >>> and most distinctive part of the FrameMaker structured authoring >>> interface. Easy access to any part of the document. Expand/collapse >>> at any level of the document hierarchy; locally or globally (e.g. >>> expand/collapse "this" section; expand/collapse all sections). Full >>> navigation capabilities. Visual feedback (and shortcut control) over >>> cursor location -- beginning, middle, or end of an element. >>> Configurable and interactive attribute display.* >>> * >>> * >>> *While most XML editors provide some sort of outline view, I've >>> never seen one as full-featured and useful as the FrameMaker >>> structure view.* >>> >>> I occasionally use the oXygen Outline View for quick navigation in >>> larger XML documents. And the "folding" feature in the edit window >>> to expand/collapse content. But these don't fully replace what one >>> can do with the FrameMaker structure view. >>> >>> I think you will find that oXygen provides more and different >>> features than Structured FrameMaker, many of which you will come to >>> appreciate. I suggest (as you are doing) learning how to be most >>> productive with the oXygen features and workflow. And be prepared to >>> miss the FrameMaker structure view. 🙁 >>> >>> -Alan >>> -- >>> Alan Houser >>> Group Wellesley, Inc. >>> Consultant and Trainer, Technical Publishing >>> arh on Twitter >>> 412-450-0532 >>> >>> >>> >>>> On Dec 8, 2022, at 10:37 AM, Frank Dissinger >>>> <frank.dissinger(a)cgs-oris.com> wrote: >>>> >>>> Thank you, >>>> >>>> Chris >>>> Radu >>>> Stefan >>>> Thomas >>>> Yves >>>> >>>> for your replies, this valuable information and for offering me >>>> your help. >>>> >>>> I have already made some initial progress. I have successfully >>>> created a custom framework with my own CSS file and are getting my >>>> topic editor window panel look more and more the way I like (using >>>> the 'print-ready' display style). >>>> >>>> I'll try to dig a bit deeper into this matter and will collect the >>>> questions and issues as I get on with this. I'll then come back to you. >>>> >>>> Best regards, >>>> >>>> Frank >>>> >>>> ------------------------------------------------------------------------ >>>> Am 06.12.2022 um 17:42 schrieb Frank Dissinger: >>>>> Hi all, >>>>> >>>>> Are there any passionate long-term structured FrameMaker users who >>>>> have changed to oXygen as a DITA editor? Has anybody tried to set >>>>> up the oXygen authoring environment as close as possible to >>>>> FrameMaker's WYSIWYG view? Or at least in a way that makes the >>>>> switch as painless as possible for a FrameMaker user? >>>>> >>>>> I've been using FrameMaker V11+DITA-FMx as a DITA editor for many >>>>> years -- until recently also as a PDF transformation engine, which >>>>> I have now replaced with MiramoPDF. I have used oXygen for a few >>>>> years only and mostly as a transformation engine. With FM I am >>>>> stuck with an old DITA implementation and the DITA-FMx plug-in is >>>>> not developed any further. This is why I would like to use oXygen >>>>> as a DITA editor instead. But I find it very hard to make the >>>>> switch: The way DITA maps, topics, tags, structures... are >>>>> presented is so different and I haven't the time to learn oXygen >>>>> properly and in full detail. It's such a powerful tool with tons >>>>> of features. So I thought there may be someone who can help me >>>>> getting started -- at least with setting up the user interface and >>>>> authoring environment. >>>>> >>>>> A few examples of things I am struggling with right away when I >>>>> look at how oXygen presents my DITA files: >>>>> >>>>> * It seems that a DITA map loads all the referenced submaps and >>>>> displays all of these maps in a single window panel (as if >>>>> this was a single file). In FM I see only the references and >>>>> open the submaps as separate files by double-clicking on them. >>>>> * I feel lost in these maps. There are lots of big fonts, >>>>> frames, colored backgrounds, icons... Can I customize the >>>>> appearance? For example, by defining CSS-like styles for the >>>>> DITA elements displayed on the screen? >>>>> * The Outline view is a bit similar to FM's Structure View. But >>>>> I am used to setting the cursor into the Structure View to >>>>> precisely define the point where to insert an element. This >>>>> does not work in oXygen. >>>>> * I'd like to see text and images without any tags in one window >>>>> panel and the DITA structure with elements and attributes in a >>>>> separate panel. I know I can switch off tags and use the >>>>> Outline view, but I am not sure if this really gives me full >>>>> control over everything... >>>>> * How does oXygen visualize conditionalized content >>>>> (included/excluded via a ditaval file)? >>>>> * Can I define a fixed page size in oXygen? I'd like to set a >>>>> page width (height is not important) to make sure that images >>>>> fit on the page and that table columns are not too narrow (in >>>>> PDF deliverables). Setting an image resolution is also important. >>>>> * ... >>>>> >>>>> Regards, >>>>> >>>>> Frank >>>> -- >>>> *Frank Dissinger* >>>> Documentation Manager >>>> .................................................................... >>>> *CGS Publishing Technologies International GmbH* >>>> *Email*frank.dissinger(a)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> >>> -- >>> >>> *Frank Dissinger* >>> >>> Documentation Manager >>> >>> .................................................................... >>> >>> *CGS Publishing Technologies International GmbH* >>> >>> *Email* frank.dissinger(a)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> > _._,_._,_ > ------------------------------------------------------------------------ > Groups.io Links: > > You receive all messages sent to this group. > > View/Reply Online (#47181) > <https://dita-users.groups.io/g/main/message/47181> | Reply To Group > <mailto:main@dita-users.groups.io?subject=Re:%20Re%3A%20%5Bdita-users%5D%20Going%20from%20FrameMaker%20to%20oXygen%20%2F%20FM%20Structure%20View%20vs.%20oXy%20Outline%20View%20%2F%20Feature%20request> > | Reply To Sender > <mailto:jang@jang.nl?subject=Private:%20Re:%20Re%3A%20%5Bdita-users%5D%20Going%20from%20FrameMaker%20to%20oXygen%20%2F%20FM%20Structure%20View%20vs.%20oXy%20Outline%20View%20%2F%20Feature%20request> > | Mute This Topic <https://groups.io/mt/96149052/2470666> | New Topic > <https://dita-users.groups.io/g/main/post> > Your Subscription > <https://dita-users.groups.io/g/main/editsub/2470666> | Contact Group > Owner <mailto:main+owner@dita-users.groups.io> | Unsubscribe > <https://dita-users.groups.io/g/main/leave/5778861/2470666/1973504771/xyzzy> > [frank.dissinger(a)cgs-oris.com] > > _._,_._,_ -- *Frank Dissinger* Documentation Manager .................................................................... *CGS Publishing Technologies International GmbH* *Email *frank.dissinger(a)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>

2 1

Going from FrameMaker to oXygen / FM Structure View vs. oXy Outline View / Feature request
by Frank Dissinger 09 Jan '23

09 Jan '23

Hi Alan, Thank you for your reply. I fully agree with what you wrote about FM's Structure View. An excellent tool. It would be great if oXygen could enhance its Outline View and make it work in a similar way. I am especially missing the following features: * Allow users to place the cursor between tags, or at the beginning/end of the element contents, and indicate the position * Display attributes: Toggle between all/all with a value/none (no need to waste room on the screen for a separate Attributes window) * Expand/collapse complete tree of elements or attributes in one go (Shift-click) * Element content should not be repeated for empty wrapping elements, this is confusing (show it only once) For exmaple, for <li>Text..., the "Text" is shown both for <li> and . It should only be shown for . Can I add this as feature request? I have now switched to the oXygen Users Mailing List and will post any further oXygen-related issues there. Regards, Frank ------------------------------------------------------------------------ Am 04.01.2023 um 22:05 schrieb Alan Houser: > Chiming in a bit late here. Longtime structured FrameMaker and oXygen > user... > > *Frank mentions the FrameMaker structure view. IMO, this is the best > and most distinctive part of the FrameMaker structured authoring > interface. Easy access to any part of the document. Expand/collapse at > any level of the document hierarchy; locally or globally (e.g. > expand/collapse "this" section; expand/collapse all sections). Full > navigation capabilities. Visual feedback (and shortcut control) over > cursor location -- beginning, middle, or end of an element. > Configurable and interactive attribute display.* > * > * > *While most XML editors provide some sort of outline view, I've never > seen one as full-featured and useful as the FrameMaker structure view.* > > I occasionally use the oXygen Outline View for quick navigation in > larger XML documents. And the "folding" feature in the edit window to > expand/collapse content. But these don't fully replace what one can do > with the FrameMaker structure view. > > I think you will find that oXygen provides more and different features > than Structured FrameMaker, many of which you will come to appreciate. > I suggest (as you are doing) learning how to be most productive with > the oXygen features and workflow. And be prepared to miss the > FrameMaker structure view. 🙁 > > -Alan > -- > Alan Houser > Group Wellesley, Inc. > Consultant and Trainer, Technical Publishing > arh on Twitter > 412-450-0532 > > > >> On Dec 8, 2022, at 10:37 AM, Frank Dissinger >> <frank.dissinger(a)cgs-oris.com> wrote: >> >> Thank you, >> >> Chris >> Radu >> Stefan >> Thomas >> Yves >> >> for your replies, this valuable information and for offering me your >> help. >> >> I have already made some initial progress. I have successfully >> created a custom framework with my own CSS file and are getting my >> topic editor window panel look more and more the way I like (using >> the 'print-ready' display style). >> >> I'll try to dig a bit deeper into this matter and will collect the >> questions and issues as I get on with this. I'll then come back to you. >> >> Best regards, >> >> Frank >> >> ------------------------------------------------------------------------ >> Am 06.12.2022 um 17:42 schrieb Frank Dissinger: >>> Hi all, >>> >>> Are there any passionate long-term structured FrameMaker users who >>> have changed to oXygen as a DITA editor? Has anybody tried to set up >>> the oXygen authoring environment as close as possible to >>> FrameMaker's WYSIWYG view? Or at least in a way that makes the >>> switch as painless as possible for a FrameMaker user? >>> >>> I've been using FrameMaker V11+DITA-FMx as a DITA editor for many >>> years -- until recently also as a PDF transformation engine, which I >>> have now replaced with MiramoPDF. I have used oXygen for a few years >>> only and mostly as a transformation engine. With FM I am stuck with >>> an old DITA implementation and the DITA-FMx plug-in is not developed >>> any further. This is why I would like to use oXygen as a DITA editor >>> instead. But I find it very hard to make the switch: The way DITA >>> maps, topics, tags, structures... are presented is so different and >>> I haven't the time to learn oXygen properly and in full detail. It's >>> such a powerful tool with tons of features. So I thought there may >>> be someone who can help me getting started -- at least with setting >>> up the user interface and authoring environment. >>> >>> A few examples of things I am struggling with right away when I look >>> at how oXygen presents my DITA files: >>> >>> * It seems that a DITA map loads all the referenced submaps and >>> displays all of these maps in a single window panel (as if this >>> was a single file). In FM I see only the references and open the >>> submaps as separate files by double-clicking on them. >>> * I feel lost in these maps. There are lots of big fonts, frames, >>> colored backgrounds, icons... Can I customize the appearance? >>> For example, by defining CSS-like styles for the DITA elements >>> displayed on the screen? >>> * The Outline view is a bit similar to FM's Structure View. But I >>> am used to setting the cursor into the Structure View to >>> precisely define the point where to insert an element. This does >>> not work in oXygen. >>> * I'd like to see text and images without any tags in one window >>> panel and the DITA structure with elements and attributes in a >>> separate panel. I know I can switch off tags and use the Outline >>> view, but I am not sure if this really gives me full control >>> over everything... >>> * How does oXygen visualize conditionalized content >>> (included/excluded via a ditaval file)? >>> * Can I define a fixed page size in oXygen? I'd like to set a page >>> width (height is not important) to make sure that images fit on >>> the page and that table columns are not too narrow (in PDF >>> deliverables). Setting an image resolution is also important. >>> * ... >>> >>> Regards, >>> >>> Frank >> -- >> *Frank Dissinger* >> Documentation Manager >> .................................................................... >> *CGS Publishing Technologies International GmbH* >> *Email*frank.dissinger(a)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> >> _._,_._,_ >> ------------------------------------------------------------------------ > > _._,_._,_ > ------------------------------------------------------------------------ > Groups.io Links: > > You receive all messages sent to this group. > > View/Reply Online (#47170) > <https://dita-users.groups.io/g/main/message/47170> | Reply To Group > <mailto:main@dita-users.groups.io?subject=Re:%20Re%3A%20%5Bdita-users%5D%20Going%20from%20FrameMaker%20to%20oXygen> > | Reply To Sender > <mailto:arh@groupwellesley.com?subject=Private:%20Re:%20Re%3A%20%5Bdita-users%5D%20Going%20from%20FrameMaker%20to%20oXygen> > | Mute This Topic <https://groups.io/mt/95496909/2470666> | New Topic > <https://dita-users.groups.io/g/main/post> > Your Subscription > <https://dita-users.groups.io/g/main/editsub/2470666> | Contact Group > Owner <mailto:main+owner@dita-users.groups.io> | Unsubscribe > <https://dita-users.groups.io/g/main/leave/5778861/2470666/1973504771/xyzzy> > [frank.dissinger(a)cgs-oris.com] > > _._,_._,_ -- *Frank Dissinger* Documentation Manager .................................................................... *CGS Publishing Technologies International GmbH* *Email *frank.dissinger(a)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>

2 1

[ANN] Webinar: Validating XML and JSON Documents Using Oxygen Scripting (January 11, 2023)
by Alin Belu 04 Jan '23

04 Jan '23

Hello, What better way to kick off the new year than with the Oxygen XML Editor series of live events? So, next Wednesday, on *the 11th of January*, we invite you to the *Validating XML and JSON Documents Using Oxygen Scripting webinar*! With the latest release of the Oxygen suite of products, additional support was added for validating XML and JSON files via Oxygen XML Scripting. In this webinar, Octavian Nadolu (project manager at Syncro Soft) will cover details about this newly implemented validation scripting support, as well as showing examples of how to use it efficiently. By the end of the webinar, you will know how to validate files or directories from a command line interface and check that your documents are valid from an integration server, as well as having the possibility to generate reports in several formats (text, XML, JSON, or an HTML visual format). We won’t be stopping there, as we will also be looking at how you can use transformation or comparison scripts. During this 1-hour live event, Octavian will focus on showing you how to: - Use the Validation command-line script - Validate against a specific schema file - Validate using the default Oxygen validation scenarios - Use the validation scenario from either a scenarios file or a project file - Generate the validation results in various formats (YAML, JSON, XML, HTML) - Run validation on a continuous integration (CI/CD) server - Make use of the Transformation command-line script - Utilize the Comparison/Merge command-line script This is a free event but registration is required. You can register at https://www.oxygenxml.com/evs2023-1.html To stay in touch with us and discover what other events we have planned for you, please make sure to check https://www.oxygenxml.com/events_programme.html Best regards, Alin -- Alin Belu Oxygen XML Editor

1 0

Re: [oXygen-user] Custom DTDs with default Oxygen OT
by Scott Prentice 21 Dec '22

21 Dec '22

Thanks, Stefan! Yeah .. I was hoping to avoid having the users install a plugin .. just install the framework. But I can see that's not going to fly. I'm thinking that the simplest (least effort for the users, and least opportunity for error), is to provide a pre-configured OT installation that they can point to from Preferences. It'll just be .. 1) Install framework, 2) Point to custom OT in Preferences That way if something goes sideways, they haven't messed with the detail Oxygen installation. Cheers, ...scott On 12/20/22 11:33 AM, Stefan Jung wrote: > Hey Scott, > > You should bundle the grammar files in a toolkit plugin. This is > correct. In your oxygen framework you need to configure the matching > rules to recognize your custom grammar files. You need to install your > plugin to the DITA-OT as well. You need to use > the dita.specialization.catalog.relative extension point in your > plugin.xml. > > BR > > > > Gesendet mit OX Mail > > Scott Prentice <sp14(a)leximation.com <http://sp14@leximation.com>> hat > am December 20, 2022 um 8:25 PM geschrieben: > > I think I know the answer to this question, but want to confirm > that I'm not missing something. > > I've got a set of custom DITA DTDs wrapped up in an OT plugin. If > I install this plugin in the OT, I'm able to successfully generate > output from content that uses the public IDs defined by those > DTDs. However, what I'd like is to include this plugin in an > Oxygen framework, and have the custom doctypes honored for OT > builds without "installing" the plugin. > > As it stands, users can install the framework and edit topics and > maps using the custom doctypes. It validates fine and all is well, > but when they go to do an OT build, it fails to recognize the > location for the custom DTDs. > > I thought there was an OT parameter that let you specify the > location of an alternate catalog file, but I'm not seeing that. > Was hoping that I could get this to work by just having the users > install the framework. > > It seems like my only options are (after installing the framework) .. > > - install and integrate the "doctypes" plugin into the default OT > in Oxygen > > - OR .. provide another OT that has the doctypes plugin installed > and have the users point to that as a custom DITA-OT in Oxygen > > Thoughts? > > Thanks! > ...scott >

2 3