Date   

Re: Any Interest in a Hardware Domain for Non-computer Buttons/Controls? #DITAv2-0

Larry Kollar
 

Personally, the only hardware controls I have to document are reset and WPS buttons, so maybe I'm not the right person to answer this. I'll check with other teams, they might have needs I don't.

Keystrokes might be a good thing to have an a hardware domain. A long time ago, I built and used a focused XML grammar that included keystroke as an element. Another thing to ask the other teams: to see what they're using. I use userinput, and some others might use uicontrol or plain text. Without a specific element, it's easy to get inconsistent.

For things like Ctrl+P or Alt-Shift-3, there could be a wrapper element analogous to menucascade. Maybe call it keycombo, and use it like this:

<keycombo>
    <keystroke>Ctrl</keystroke><keystroke>Shift</keystroke><keystroke>8</keystroke>
</keycombo>

An alternate and more concise structure:

<keycombo modifiers="Ctrl Shift">8</keycombo>

People who want to get really fancy could use one of those typewriter key typefaces to render them.

Note that we haven't specialized anything here—like I said, we're probably using existing elements inconsistently.


Re: Ann: Webinar - Discover the new features in Oxygen XML Editor 22.0 #Oxygen

Chris Papademetrious
 

Thanks Radu! I shared this with my team.

 - Chris


Ann: Webinar - Discover the new features in Oxygen XML Editor 22.0 #Oxygen

Radu Coravu
 

Hello,

We are excited to announce the What's New in Oxygen 22.0 webinar on April 29, 2020.

During the webinar, Steven Higgs will explore some of the most requested and significant features that were added in Version 22.0 of the Oxygen XML suite of products. The subjects that will be discussed include:

·       New features and improvements for DITA authors.

·       New possibilities for DITA Publishing, particular for CSS-based PDF output.

·       The benefits of the newly added support for the DITA-OT Project configuration file.

·       The most significant improvements added in Web Author and Content Fusion.

·       A glimpse of various updates for JSON, HTML, and Markdown users.

You can register for free at https://www.oxygenxml.com/events/2020/webinar_what_is_new_in_Oxygen_22.html

This webinar will be recorded and made available on our website a few days following the event.

Please join us to discover some of the most exciting features and improvements in Oxygen 22.0!


Regards,
Radu

Radu Coravu
Oxygen XML Editor


Relationship tables in 3.4.1 #reltable #DITA-OT

Briggs, John
 

What is going on with reltable processing in 3.4.1? I am trying to migrate from version 2.3.3 and it seems that processing of the relationship tables have be removed. 

for the 3.4.1 user guide "Note that links generated from a <reltable> in a DITA map will have the role attribute set to "friend". " but when I look at the files in the temp folder, not a single topic has role="friend".

Also what is the difference in using args.rellinks="none" from args.rellinks="nofamily"? I cannot see any differences.

John


[ANN] Release of XMLmind XML Editor v9.3 #XMLmind

Hussein Shafie
 

Release of XMLmind XML Editor v9.3. Highlights:

- Any configuration (DITA, DocBook, XHTML, etc): the node path bar can now be configured to display the value of any attribute you want. XHTML example: "html > body > pre#example.fancy.line-numbers > code". Character "#" is used to prefix the value of attribute id. Character "." is used to prefix the tokens comprising the value of attribute class.

These settings are done using a dialog box displayed when selecting the "Customize" item of the contextual menu of the “file icon” found at the very beginning of the node path bar. This contextual menu may also contain a number of checkboxes letting the user quickly hide and show the attributes declared using the "Customize" dialog box.

- New add-on called "FlatLaf Look and Feel" containing a clean, simple and elegant “Look & Feel” for XMLmind XML Editor.

This add-on, which is not installed by default, is supported on all platforms. It is especially nice to have on Linux where the default “cross-platform”, Look & Feel (called "Metal") looks rather outdated. It may also interest Windows and Mac users who want a dark theme or simply prefer how FlatLaf looks compared to the default, “system”, Look & Feel.

- A number of other minor yet useful enhancements.

- Updated several software components, among them XMLmind Word To XML (Import DOCX) and XMLmind XSL-FO Converter (Convert Document to RTF, WML, DOCX, ODT).

- A few minor bug fixes too.

More information in https://www.xmlmind.com/xmleditor/changes.html

---------------------------------------------------------------
What is XMLmind XML Editor?

https://www.xmlmind.com/xmleditor/

Personal Edition is free to use by many persons and organizations

https://www.xmlmind.com/xmleditor/download.shtml


follow-up on SVG and MathML domains #MathML #SVG

nlpharrison
 

Hi,

I sent out mail a few months ago about the DITA TC considering moving the grammar files for MathML and SVG domains, either into the main area of the technicalContent profile, which will be separate from base DITA at 2.0, or into base DITA.  The responses indicated that there may be some confusion about these domains, especially about the SVG domain.

It is not necessary to use the SVG domain in order to simply use SVG graphics in a DITA document.   SVG images are rendered correctly by most online and print publishing engines.  The only time a DITA implementation would need to use the SVG domain - and this usage would be by an implementer, not by an author -  is if you need to manipulate those graphics in special ways.  One example would be to adjust the dimensions of an image across different outputs because of different sizes in output device - if one output is for display on a phone, and another on a tablet, or a full-size computer monitor.   In that case, I've had to use the SVG domain to access SVG elements and attributes within an SVG graphic to adjust the number of pixels in the output image. 

For this reason, it's likely that we will keep the SVG and MathML domains within the technicalContent profile, even it we do move the grammar files around a bit within that profile.   If, with full understanding of the usage of these domains, there is anyone who still thinks there are compelling reasons to move the SVG domain into base DITA, I'd be interested in hearing them. 

Regards,
Nancy Harrison
[secretary, DITA Technical Committee]


Re: How deal with complex conditions with combinations of AND, OR and NOT #conditional-processing

Wim Hooghwinkel
 

Hi Bella,

Since you’re using DITAToo CCMS, you might check out the configuration database add on. This has been designed for managing complex conditions in DITA content. Contact your DITAToo vendor to get more info.


Vriendelijke groet / Kind regards,
 
Wim Hooghwinkel



Phone +31652036811
Skype wimhooghwinkel
Twitter @idtp

Check my LinkedIn profile for latest updates

-




Re: How deal with complex conditions with combinations of AND, OR and NOT #conditional-processing

Zoë Lawson
 

I haven’t done it yet, but have you looked into groups?

http://docs.oasis-open.org/dita/dita/v1.3/errata02/os/complete/part3-all-inclusive/archSpec/base/usage-of-conditional-processing-attributes.html#usage-of-conditional-processing-attributes

Zoë

Zoë Lawson


From: main@dita-users.groups.io <main@dita-users.groups.io> on behalf of Reece Roggentien <Reece.Roggentien@...>
Sent: Friday, April 3, 2020 10:33:15 AM
To: main@dita-users.groups.io <main@dita-users.groups.io>
Subject: Re: [dita-users] How deal with complex conditions with combinations of AND, OR and NOT
 

We have some complex conditionalization, too, and these are some techniques I’ve used. For ditavals:

 

·       “Exclude” all profiling attributes by default: <prop action="exclude"/>

·       “Include” all @otherprops by default: <prop action="include" att="otherprops"/>

·       “Include” any other profiling attributes that shouldn’t get filtered

 

What this does:

 

·       It allows us to use @otherprops for selective exclusion (one-off filtering), like: <prop action="exclude" att="otherprops" val="everyone_but_customer_1"/>

·       It allows us to use @props and any specializations of @props for selective inclusion, like: <prop action="include" att="props" val="only_customer_1"/>

 

In the content itself, it’s sometimes impossible to accomplish the and/or/not behavior we want on a single element. In those cases we’ve repeated the element but applied different profiling attributes to each one to get the desired output. We could use also a single keyref or conkeyref with conditionalized keydefs instead.

 

-Reece

 

From: main@dita-users.groups.io [mailto:main@dita-users.groups.io] On Behalf Of Bella Zhao via groups.io
Sent: Friday, April 03, 2020 12:08 AM
To: dita-users@groups.io
Subject: [dita-users] How deal with complex conditions with combinations of AND, OR and NOT

 

Hi,

 

The conditional attributes are very complex for our documentation because our product is highly customer configurable.

 

Our conditions have complex combinations of AND, OR, and NOT, for example, (A || B) && C && !D. In real cases there can be much more layers. While I think DITAVAL can only deal with OR and NOT, such as (A || B) and !A?

 

Is there any way to deal with such complex conditions in DITA? Do we need some special programming?

 

Thanks,

Bella

 

 


Re: How deal with complex conditions with combinations of AND, OR and NOT #conditional-processing

Reece Roggentien
 

We have some complex conditionalization, too, and these are some techniques I’ve used. For ditavals:

 

·       “Exclude” all profiling attributes by default: <prop action="exclude"/>

·       “Include” all @otherprops by default: <prop action="include" att="otherprops"/>

·       “Include” any other profiling attributes that shouldn’t get filtered

 

What this does:

 

·       It allows us to use @otherprops for selective exclusion (one-off filtering), like: <prop action="exclude" att="otherprops" val="everyone_but_customer_1"/>

·       It allows us to use @props and any specializations of @props for selective inclusion, like: <prop action="include" att="props" val="only_customer_1"/>

 

In the content itself, it’s sometimes impossible to accomplish the and/or/not behavior we want on a single element. In those cases we’ve repeated the element but applied different profiling attributes to each one to get the desired output. We could use also a single keyref or conkeyref with conditionalized keydefs instead.

 

-Reece

 

From: main@dita-users.groups.io [mailto:main@dita-users.groups.io] On Behalf Of Bella Zhao via groups.io
Sent: Friday, April 03, 2020 12:08 AM
To: dita-users@groups.io
Subject: [dita-users] How deal with complex conditions with combinations of AND, OR and NOT

 

Hi,

 

The conditional attributes are very complex for our documentation because our product is highly customer configurable.

 

Our conditions have complex combinations of AND, OR, and NOT, for example, (A || B) && C && !D. In real cases there can be much more layers. While I think DITAVAL can only deal with OR and NOT, such as (A || B) and !A?

 

Is there any way to deal with such complex conditions in DITA? Do we need some special programming?

 

Thanks,

Bella

 

 


How deal with complex conditions with combinations of AND, OR and NOT #conditional-processing

Bella Zhao
 

Hi,

 

The conditional attributes are very complex for our documentation because our product is highly customer configurable.

 

Our conditions have complex combinations of AND, OR, and NOT, for example, (A || B) && C && !D. In real cases there can be much more layers. While I think DITAVAL can only deal with OR and NOT, such as (A || B) and !A?

 

Is there any way to deal with such complex conditions in DITA? Do we need some special programming?

 

Thanks,

Bella

 

 


Re: managing <related-links> #reltable

Yves Barbion
 

Hi Niels

You can use the @linking attribute on the topicrefs in the relatable for one-way xrefs:


Cheers

Yves

 


On Thu, 2 Apr 2020 at 14:22, Niels Grundtvig Nielsen <niels.grundtvignielsen@...> wrote:
When I was first getting to grips with DITA, it took me a long time to work out that reltables didn't have to be in three columns and used to manage links across three types of topic … but the penny dropped, and I started using two-column reltables for bidirectional links. Really handy, of course, to be able to see an overview in one place. As far as I've managed to work out, though, a one-way cross-ref needs to use a <related links> inside the starting topic.
Enlightenment, hints and tips welcome!


managing <related-links> #reltable

Niels Grundtvig Nielsen
 

When I was first getting to grips with DITA, it took me a long time to work out that reltables didn't have to be in three columns and used to manage links across three types of topic … but the penny dropped, and I started using two-column reltables for bidirectional links. Really handy, of course, to be able to see an overview in one place. As far as I've managed to work out, though, a one-way cross-ref needs to use a <related links> inside the starting topic.
Enlightenment, hints and tips welcome!


Re: Class error compiling index for javahelp in DITA-OT 3.4 #DITA-OT #JavaHelp

Jeff Hooker
 

I did indeed miss the fact that you'd attached the necessary files, my apologies. Could have saved myself a lot of time by reading more carefully


On Tue, Mar 17, 2020 at 10:57 PM Radu Coravu <radu_coravu@...> wrote:
Hi Jeff,

Did you read my previous email?
It had attached a zip with the plugin (extra library included):
https://dita-users.groups.io/g/main/message/45323

Regards,
Radu

Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

On 3/17/2020 11:56 PM, Jeff Hooker wrote:
> Ok, I have downloaded, unpacked, and inspected every single release of
> the OT. At version 3.0, the same version where the .jar file becomes a
> necessity, it also fails to be present and is absent going forward.
> Therefore, it appears that there hasn't been a version of the OT since
> 3.0 which can actually create javahelp. I have yet to find a repository
> of any sort for the missing jar file or any evidence of one existing.
>
> So, short question; is anyone generating Javahelp with a 3.0+ version of
> the OT, and if so can you share details about how?
>
> Cheers,
> Jeff.
>





Re: I configure PDF plugin to set display properties #PDF #DITA-OT

Kristen James Eberlein
 

Not that I am aware of.

Kris


On Mar 31, 2020, at 5:05 PM, Zoë Lawson <zoelawson17@...> wrote:


Is there a way to configure the PDF plugin to set PDF display properties, such as the zoom level?

Zoë Lawson


Using chunk attribute, to-content to forceable create a topic from a <topichead> #chunk

 

 

For organizational purposes, a topichead with navigation text in a release document for "New Features" or "Updates" helps structure content, and doesn't really require a an actual topic.

But, for HTML output, topichead creates toc link but has no actual html topic associated.  This creates an issue if you want to select the <topichead> title and all it's child topics because the topichead topic doesn't really exist as a containing topic.

Question, while it's possible to apply the the topichead chunk="to-content" and the copy-to="some_meaningful_topic_name.xml", the result creates one new topic with all child topics merged as one. 

Is there a way to generate an actual topic from the topichead at processing, so it appears in the toc as an actual html file that contains its children topics also as HTML?

Should I just get over the fact that I have to create title only topics in place of <topichead>?

Advice appreciated.


Re: [Ann] - Webinar: "Using DITA for Small Technical Documentation Teams" #webinar

Chris Papademetrious
 

Agreed, this sounds great! We're also migrating to Git and Oxygen/DITA, and this is very timely.

 - Chris


Re: I configure PDF plugin to set display properties #PDF #DITA-OT

Roger Sheen
 

On Monday, 2020-03-30, at 14:58 CEST, Zoë Lawson wrote:

Is there a way to configure the PDF plugin to set PDF display properties,
such as the zoom level?

Hi Zoë,

This depends on the rendering engine you use to transform the XSL-FO file to PDF.

Like Radu, I’m not aware of any way to do this with Apache FOP.

Here are the corresponding options for RenderX XEP (which include initial zoom value):
http://www.renderx.com/reference.html#PDF_Files

To set document information, see:
http://www.renderx.com/reference.html#Extensions

Hope that helps,

Roger


--

https://www.dita-ot.org/dev/ · DITA Open Toolkit Documentation


Re: [Ann] - Webinar: "Using DITA for Small Technical Documentation Teams" #webinar

despopoulos_chriss
 

Looking forward to it Radu...  We are indeed a small team using GIT and oXygen.  The combination works very well, and even as a small team we get a fantastic ROI on our process.  That said, I'm sue there is plenty to learn!

Thanks!          cud


Re: I configure PDF plugin to set display properties #PDF #DITA-OT

Radu Coravu
 

Hi Zoë,

I do not know any setting in Apache Fop to control the initial zoom level, Antenna House seems to have such an extension:

https://www.data2type.de/xml-xslt-xslfo/xsl-fo/xslfo-referenz/antenna-house/elements/document-info/

<axf:document-info name="openaction" value="#zoom=200"/>

Regards,
Radu
Radu Coravu
Oxygen XML Editor
On 3/30/20 3:58 PM, Zoë Lawson wrote:
Is there a way to configure the PDF plugin to set PDF display properties, such as the zoom level?

Zoë Lawson


  


I configure PDF plugin to set display properties #PDF #DITA-OT

Zoë Lawson
 

Is there a way to configure the PDF plugin to set PDF display properties, such as the zoom level?

Zoë Lawson