Date   

conref and filtering

Stuart Norton
 

Dear DITA folks,

 

Our team has run into a behavior that we found surprising and it looks like it is going to cause us big headaches. It seems that if you use a conref, and the conref includes filtered material (@props), the filters are ignored.  It looks like the ditaval filtering stage happens before conrefs are included, so any filters in the conrefs are ignored…?

 

Does anyone using conref and ditaval filtering have some suggestions about how we can more effectively use conrefs that contain filtered material?

 

I'm attaching a zip with some sample files that demonstrate the issue:

  • map.dita includes concept.dita and filter.ditaval
  • filter.ditaval hides all products other than product = "shown-product"
  • concept.dita conrefs a section in snippets.dita
  • both concept.dita and the conrefed section contain a paragraph with product = "hidden-product"
  • in concept.dita, the paragraph is hidden; in the conrefed section it is shown.

Our expectation was that both concept.dita and the conrefed section would have the same content shown and hidden.

 

Thanks in advance for your advice!

 

Stuart

 


Juniper Business Use Only


Re: DITA to Markdown

Radu Coravu
 

Hi Chris,

About (1), it's already registered as an issue, there is a parameter controlling this though:

https://github.com/jelovirt/org.lwdita/issues/65

About (2) have you tried to enable Oxygen's "fix.external.refs" parameter in the transformation scenario? It may help with such cases.

Regards,

Radu

Radu Coravu
Oxygen XML Editor
On 11.12.2020 17:34, despopoulos_chriss via groups.io wrote:

Hi all... 

I want to send some sets of DITA topics to a system that displays markdown.  So I would like to transform a book to Markdown.  Has anybody else done this?  I know it's kind of backward -- the usual flow is to incorporate MD in your DITA book so you can take collaborations from other departments/people.  But we are doing what we are doing...

Using oXygen, I can add a Markdown scenario and a GitBook scenario.  I presume these are ultimately coming from the DITA OT.  These seem to have two oddities.
  1. The resulting MD files have a .html extension
    This will get to be a pain as we scale up.  Anybody know of some way to change the file extension?
  2. The map MUST be above or with the topics in the file tree
    AFAIK, this is preferred, but not required in the spec.  Not a biggie, but it seems to fail pretty silently, with a soft warning about hierarchy, and then it just doesn't generate the topic files.  Took me a while to figure that one out...

Anyway, we'll see if we can make this workflow work out...  Thanks in advance for any ideas.

  


[ann][webinar] Custom Business Rules for DITA Projects (December 16) #Oxygen

alin_belu@...
 

Hello, 
 
On December 16, you are invited to a great learning experience with the “Custom Business Rules for DITA Projects” live webinar! 
 
Schematron and Schematron QuickFix (SQF) languages can be used to improve efficiency and quality when editing DITA documents. With their use, you can define actions that will add complex structures in your documents (missing table cells, list conversions, IDs, and more) and state integrity requirements to help you add content more easily and without making mistakes. 
 
This indispensable webinar presented by Octavian Nadolu, software architect at Syncro Soft, will be your step-by-step guide to getting started as soon as possible with Schematron and Schematron Quick Fixes. During this live event, you will go over topics, such as: 
* Creating business rules with Schematron to avoid the common issues when editing documents. 
* Defining SQF actions to correct the Schematron imposed rules. 
* Configuring and applying specific Schematron rules on DITA projects. 
 
This is a free event and you can register at http://www.oxygenxml.com/evs2020-16.html 
 
Also, make sure to check the full list of our upcoming events: https://www.oxygenxml.com/events_programme.html 
 
Best regards,
Alin
--
Alin Belu
Oxygen XML Editor


Re: DITA to Markdown

Lief Erickson
 

Hi Chris--

What OT transform are you using to produce your markdown? Is it one of them described in the OT docs?


-Lief

On Fri, Dec 11, 2020 at 9:34 AM despopoulos_chriss via groups.io <despopoulos_chriss=yahoo.com@groups.io> wrote:
Hi all... 

I want to send some sets of DITA topics to a system that displays markdown.  So I would like to transform a book to Markdown.  Has anybody else done this?  I know it's kind of backward -- the usual flow is to incorporate MD in your DITA book so you can take collaborations from other departments/people.  But we are doing what we are doing...

Using oXygen, I can add a Markdown scenario and a GitBook scenario.  I presume these are ultimately coming from the DITA OT.  These seem to have two oddities.
  1. The resulting MD files have a .html extension
    This will get to be a pain as we scale up.  Anybody know of some way to change the file extension?
  2. The map MUST be above or with the topics in the file tree
    AFAIK, this is preferred, but not required in the spec.  Not a biggie, but it seems to fail pretty silently, with a soft warning about hierarchy, and then it just doesn't generate the topic files.  Took me a while to figure that one out...

Anyway, we'll see if we can make this workflow work out...  Thanks in advance for any ideas.


DITA to Markdown

despopoulos_chriss
 

Hi all... 

I want to send some sets of DITA topics to a system that displays markdown.  So I would like to transform a book to Markdown.  Has anybody else done this?  I know it's kind of backward -- the usual flow is to incorporate MD in your DITA book so you can take collaborations from other departments/people.  But we are doing what we are doing...

Using oXygen, I can add a Markdown scenario and a GitBook scenario.  I presume these are ultimately coming from the DITA OT.  These seem to have two oddities.
  1. The resulting MD files have a .html extension
    This will get to be a pain as we scale up.  Anybody know of some way to change the file extension?
  2. The map MUST be above or with the topics in the file tree
    AFAIK, this is preferred, but not required in the spec.  Not a biggie, but it seems to fail pretty silently, with a soft warning about hierarchy, and then it just doesn't generate the topic files.  Took me a while to figure that one out...

Anyway, we'll see if we can make this workflow work out...  Thanks in advance for any ideas.


Re: PDF2 to HTML5: reference book

Jarno Elovirta
 

Hi,

DITA-OT’s HTML5 plug-in uses CSS for styling. In most cases that’s all you need, and for that the web and book shops are full of content. In order to add dynamic functionality for HTML5 output, you need JavaScript and the same as for CSS applies here too. So the reference content for CSS and JavaScript is pretty much out there for free, just DuckDuckGo it.

For example https://infotexture.net/2018/11/customizing-dita-output/ might be helpful to get you started.

Jarno

On 11. Dec 2020, at 11.44, pablo gg <pablo.gomez@...> wrote:

Hi all,
 
I have been working (and still am) working with DITA-OT for PDF using the PDF2 plugin. For mastering (?) the plugin structure and capabilities I have based a lot on the fantastic book Dita for Print by Leigh Davis. Beside of other resources, this has been crucial.
 
I am beginning now with a journey around HTML and I wondered whether there is any HTML-biased book that might be my side companion book.
 
Thanks for the help,
Pablo Gomez


PDF2 to HTML5: reference book

pablo gg
 

Hi all,

 

I have been working (and still am) working with DITA-OT for PDF using the PDF2 plugin. For mastering (?) the plugin structure and capabilities I have based a lot on the fantastic book Dita for Print by Leigh Davis. Beside of other resources, this has been crucial.

 

I am beginning now with a journey around HTML and I wondered whether there is any HTML-biased book that might be my side companion book.

 

Thanks for the help,

Pablo Gomez


[ann] Oxygen Batch Converter add-on version 2.1.0 has been released! #Oxygen

alin_belu@...
 

Hello, 
 
We are happy to announce that version 2.1.0 of our Oxygen Batch Converter add-on is now available in the Oxygen XML default add-on repository!  
 
The add-on is free and is compatible with any Oxygen XML Editor/Author/Developer version 20.0 and newer. 
 
Version 2.1.0 of the Oxygen Batch Converter add-on comes with these useful new improvements: 
* A new option was added for converting Markdown documents with multiple headings into DITA maps with referenced DITA topics (Markdown to DITA). 
* The addition of a new option for creating DITA short description elements in the Markdown to DITA conversion. 
* Improvement to the Markdown to DITA conversion to allow conversions of documents that start with a high heading level or increase the heading level with more than one unit. 
* A new option was added for converting HTML documents with multiple headings into DITA maps with referenced DITA topics (HTML to DITA). 
* Various small bugs were fixed in the HTML to DITA and Word to DITA conversions. 
 
To install the add-on, follow these instructions: 
* Go to Help->Install new add-ons to open an add-on selection dialog box. 
* Enter or paste https://raw.githubusercontent.com/oxygenxml/oxygen-resources-convertor/master/build/addon.xml in the Show add-ons from field. 
* Select the Batch Converter add-on and click Next. 
* Read the end-user license agreement. Then select the “I accept all terms of the end-user license agreement” option and click Finish. 
* Restart the application. 
 
For more information, see the details for the Oxygen Batch Converter add-on on GitHub: 
https://github.com/oxygenxml/oxygen-resources-converter 
 
We hope you will find this add-on useful and as always, any feedback is welcomed! 
 
Best regards, 
Alin 
--
Alin Belu
Oxygen XML Editor


Re: Skip preprocessing stage in DITA-OT #DITA-OT

Jarno Elovirta
 

If your topics don’t contain conrefs, you don’t need to disable conref processing. OT will not process conrefs if there are none.

But you can use those *.skip properties to disable some preprocessing steps if you’re not sure about your content. 

Jarno

--
Sent from a mobile device.

On 1. Dec 2020, at 16.03, Nicolas Delobel <nicolas.delobel@...> wrote:

So, after some research I found a solution using Oxygen.

I create a custom build file in DITA-OT folder:
<project basedir="." default="dist">
  <!--The DITA-OT default build file-->
  <import file="build.xml"/>
  <target name="dist">
    <property name="preprocess.conref.skip" value="true"/>
    <property name="preprocess.keyref.skip" value="true"/>
    <!--Call the DITA-OT default target-->
    <antcall target="init"/>
  </target>
</project>
where I add some properties to skip conref and keyref preprocess steps for example.

When it's done, I use this new alternate build file in Oxygen transformation scenario (see https://www.oxygenxml.com/doc/versions/22.1/ug-editor/topics/dita-map-use-your-own-build-file.html).


[ann][webinar] What’s New in Oxygen 23.0 - Overview and Panel Discussion #Oxygen

alin_belu@...
 

Hello, 
 
To celebrate the release of version 23.0 of the Oxygen XML suite of products, on Wednesday (December 9), we invite you to a special live webinar - “What’s New in Oxygen 23.0 - Overview and Panel Discussion”. 
 
Join us for this 2-hour live event that will allow you to engage with the amazing people who envisioned and developed our latest release. Find out first-hand how you can benefit from the newly implemented and game-changing features of Oxygen 23, such as: 
* Concurrent editing in Web Author for unrestricted collaboration. 
* Opening DITA maps in the Author visual editing mode with the content from all referenced topics expanded and editable. 
* The possibility to define or customize how Oxygen supports an XML language using a framework script. 
* Updates to JSON schema support and editing JSON documents visually in Author mode. 
* Integrating the Oxygen WebHelp with the Oxygen Feedback platform. 
* And so much more. 
 
The panel will bring together George Bina, Radu Coravu, Octavian Nadolu, Cristi Talau, and Radu Pisoi. 
 
This is a free event and you can register at http://www.oxygenxml.com/evs2020-18.html  
 
Make sure to check the full list of our upcoming Events: https://www.oxygenxml.com/events_programme.html 
 
Best regards,
Alin
--
Alin Belu
Oxygen XML Editor


Re: #DITA-OT Saxon PE #DITA-OT

msbalaji@...
 

Hi Toshihiko Makita,

Yes,

#1. I updated classpath in dita.bat. Not success, not able to find/load the license file.
#2. I'm able to succeed when I add <factory> method in <xslt> and remove <pipeline> (DITA-OT custom task <factory> is not allowed).

Are you able to succeed? without removing <pipeline> for existing plugin?

Thanks,
Balaji. M


Re: #DITA-OT Saxon PE #DITA-OT

Toshihiko Makita
 

Hi Balaji,

One of our client is currently using Saxon-PE 9-9-1-7J with DITA-OT 3.4.1 on their publishing server without no problem.

Do you have any problem using Saxon-PE on your environment?

Regards,

-- 
/*----------------------------------------------------------------------
 Toshihiko Makita
 Development Group. Antenna House, Inc. Ina Branch
 Web site:
 http://www.antenna.co.jp/
 http://www.antennahouse.com/
 -----------------------------------------------------------------------*/ 


[ann][webinar] Exploring the intersections of UX and Technical Communication with Emma Rose, University of Washington #Room42 Dec 9th @ 16:30 UTC #room42

Liz Fraley
 

Title: Exploring the intersections of UX and Technical Communication

When: Wednesday, Dec 9th @ 16:30 UTC (8:30 LAX | 11:30 NYC | 16:30 LON | 22:00 BLR)

Register: https://bit.ly/room42-rose

Description:

Emma Rose, University of Washington will be In The Room!

What is the relationship between User Experience and Technical Communication? Are they the same field, do they overlap, or are they distinct? How should we be preparing the next generation of technical communicators to work at the intersection between UX and TC? What skills do professionals need to be successful?

In this Room 42, join Dr. Emma Rose in a discussion on the evolving state of UX and Technical Communication. She’ll share some of her recent research results that examine at how the UX industry is changing. She’ll also discuss the specific skills and dispositions early career professionals need to succeed in UX and how that is informing teaching and practice.


Emma Rose has spent her career crossing the academic and industry divide. She is currently an Associate Professor at the University of Washington Tacoma and an Adjunct Associate Professor in Human Centered Design & Engineering at University of Washington Seattle. Her research interests include participatory and human-centered design and developing methods to engage communities and marginalized populations in the design process. She is also the Past Chair of ACM SIGDOC, a professional organization dedicated to the design of communication. Prior to her academic career, she spent over a decade working at a User Experience consultancy helping organizations bring design thinking into their practices and product development.


-:-

The Room 42 is brought to you by Single-Sourcing Solutions. Learn more: http://room42.single-sourcing.com


Register: https://bit.ly/room42-rose


#DITA-OT#conref ID getting replaced in merge and generate broken link

msbalaji@...
 

Hi All,
I noticed, ID replacement not sync with idref for nested concept case and oid also missing for <table>, its generating broken link in PDF/HTML.(concept.dita)
When I comment the nested-concept section in conref.dita, ID/idref replacement is proper.(concept.dita)
Is it bug or Am I missing something?
Thanks,
Balaji. M


#DITA-OT Saxon PE #DITA-OT

msbalaji@...
 

Hi All,
We are using DITA-OT 3.5.4. We have multiple plugins extended from pdf and xhtml plugins.

We want to use Saxon PE instead of Saxon HE. Has anyone tried this? Please share the steps to achieve this.

Thanks,
Balaji. M


[ANN] Release of XMLmind Word To XML v1.8.3

Hussein Shafie
 

Release of XMLmind Word To XML v1.8.3.

- Minor enhancements and bug fixes.

- XMLmind Word To XML is now officially supported on Java™ 15 platforms and on macOS Big Sur (version 11.0).

More information in http://www.xmlmind.com/w2x/changes.html

--------------------------------------
What is XMLmind Word To XML?
--------------------------------------

XMLmind Word To XML can automatically convert DOCX files to:

- Clean, styled, valid HTML (single page or multi-page HTML, Web Help, EPUB) looking very much like the source DOCX file.

- Unstyled, but structured and valid, DITA bookmap, map, topic, DocBook (including V5.1 assembly), XHTML (single page or multi-page HTML, Web Help, EPUB) or XML conforming to your custom schema.

Home Page: http://www.xmlmind.com/w2x/

Download: http://www.xmlmind.com/w2x/download.shtml

Free online DOCX conversion services: http://www.xmlmind.com/w2x/online_w2x.html


Re: Skip preprocessing stage in DITA-OT #DITA-OT

Nicolas Delobel
 

So, after some research I found a solution using Oxygen.

I create a custom build file in DITA-OT folder:
<project basedir="." default="dist">
  <!--The DITA-OT default build file-->
  <import file="build.xml"/>
  <target name="dist">
    <property name="preprocess.conref.skip" value="true"/>
    <property name="preprocess.keyref.skip" value="true"/>
    <!--Call the DITA-OT default target-->
    <antcall target="init"/>
  </target>
</project>
where I add some properties to skip conref and keyref preprocess steps for example.

When it's done, I use this new alternate build file in Oxygen transformation scenario (see https://www.oxygenxml.com/doc/versions/22.1/ug-editor/topics/dita-map-use-your-own-build-file.html).


Skip preprocessing stage in DITA-OT #DITA-OT

Nicolas Delobel
 

Hi,

I have to publish huge map and I would like to skip some preprocessing stages (not used) to save processing time.
For example I would like to skip "Resolve content references (conref)" stage.

Do you know how I can do that ?

Thanks a lot.


[ann][webinar] Automate XML processing with Oxygen XML Scripting #Oxygen

alin_belu@...
 

Hello,

Next Wednesday, on December 2, our weekly live event series returns in full force with the “Automate XML processing with Oxygen XML Scripting” webinar!

As you might know, continuous integration (CI) can be efficiently used to run automated scripts to validate changes as soon as they are saved to a remote repository.

To make things easier for you, Alex Jitianu, DITA evangelist and development lead at Syncro Soft, will introduce you to Oxygen XML Scripting, a bundle of command line tools that can be executed inside these continuous integration and deployment pipelines. This way, you can make sure that your project is valid and ready to be deployed at any time!

During this event, we will go over topics, such as:
* DITA validation and checking for completeness - a tool that checks DITA maps and topics to see if they are valid and if all of the relationships between them are working.
* Translation Package Builder - a tool for detecting changes, sending them to translation, and applying the translated files.
* Examples on how to integrate these command line tools into integration servers, like Github Actions or Netlify.

This is a free event and you can register at http://www.oxygenxml.com/evs2020-17.html

Make sure to check the full list of our upcoming events: https://www.oxygenxml.com/events_programme.html

Best regards,
Alin
--
Alin Belu
Oxygen XML Editor


Re: Cross-reference to another topic

Rodolfo M. Raya
 

Hi

This happened to me when the referenced topic was not included in the map. 

Regards,
Rodolfo
--

341 - 360 of 46224