Date   

Using LaTeX equations with DITA

Radu Coravu
 

Hi all,

Based on some of our customers' requests I recently wrote an open source DITA Open Toolkit plugin which can be used to embed latex images in DITA content, if interested you can find a small blog post about the overall solution here:

http://blog.oxygenxml.com/2019/03/adding-support-for-embedding-latex.html

Regards,
Radu

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


DITA and Autodesk Vault

Yves Barbion
 

Hi group

Anyone using a DITA CCMS with a connector to Autodesk Vault?


Thanks

Yves


Re: translated keys

ekimber@contrext.com
 

When you say "multilingual content" do you mean that a single publication reflects multiple languages?

If so, then you either need language-specific names for the keys (DITA 1.2) or you need to have each language-specific part of the publication in its own key scope (DITA 1.3). This assumes that the languages are not mixed within the same part of the map--if they are then your only solution is to have language-specific keys and key references (which makes it possible to have the same key *references* for DITA 1.2 and 1.3 but use key scopes in DITA 1.3 to simplify the management of the key definitions themselves).

There are two ways to use key scopes in this case:

1. Have each branch of the map be in its own scope and include the translation maps within those scopes.
2. Put each translation map in its own scope and use scope-qualified key references reflecting the language of the content.

Option 1 works when each branch of the map is a separate language:

<chapter xml:lang="en-US" keyscope="en-US" ...>
<mapref href="translations/en-US/keydefs.ditamap"/>
...
</chapter>
<chapter xml:lang="ja-JP" keyscope="ja-JP" ...>
<mapref href="translations/ja-JP/keydefs.ditamap"/>
...
</chapter>

With this approach the key references used in each branch can be directly to the keys and they will resolve to the definitions included within the scope. This is because each branch (the <chapter> elements in this example) is it's own key scope.

Option 2 works (and is required) when the languages are mixed within branches (e.g., different languages within a single topic or different language-specific topics within a single branch):

<bookmap>
...
<frontmatter>
<mapref keyscope="en-US" href="translations/en-US/keydefs.ditamap"/>
<mapref keyscope="ja-JP" href="translations/ja-JP/keydefs.ditamap"/>
...
</frontmatter>
<chapter ...>
...
</chapter>
<chapter ...>
...
</chapter>
</bookmap>

With this approach, the key references need to be qualified with the locale-specific key scope:

For Japanese:

<p>Blah blah <keyword keyref="ja-JP.some-term"/> ....

For English:

<p>Blah blah <keyword keyref="en-US.some-term"/> ....

Which means you'll have to do some modification of the key references in each translation to set the scope prefix.

Cheers,

E.
--
Eliot Kimber
http://contrext.com


On 3/11/19, 5:33 AM, "4nxsknkaj7zji4zfh6snc6zk64ck3nhsqsvkwcsr@yahoo.com [dita-users]" <dita-users@yahoogroups.com> wrote:


Hi All,

We have a DITA map with multilingual content.
The map uses keys and the keys are translated. In the ditamap there are references to the translated keys.ditamap. There are multiple keys.ditamap.

We use DITA-OT2 to publish the map to PDF, but the keys are not translated in the output.
Only the first keys.ditamap is used, for all languages in the map.

We tested this also with DITA-OT3 and it is the same thing.

I am aware of the linguistic problems there can be with translation of variables (grammar and syntax), in our case the keys are used in a CE declaration of conformity to identify the kind of product.

Is this a bug? Or is it considered 'not done'?

Best regards,
Anneke Von den Hoff


Re: OT 3.3 PDF with FOP broken

Roger Sheen
 

On Friday, 2019-03-08, at 23:00 CET, Eliot Kimber ekimber@... [dita-users] wrote:

The latest OT versions manage the class path automatically and in a way that is different from how it used to be done.

To run the OT from Ant I use the exec command

For details, see the docs at https://www.dita-ot.org/dev/topics/migrating-ant-to-dita.html

You’ll find an example there on calling the dita command from an Ant build, which explains:

This approach allows you to use Ant builds to perform additional tasks at build time while allowing the `dita` command to set the classpath and ensure that all necessary JAR libraries are available.

Hope that helps,

Roger


--

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


translated keys

4nxsknkaj7zji4zfh6snc6zk64ck3nhsqsvkwcsr@...
 

Hi All,


We have a DITA map with multilingual content.

The map uses keys and the keys are translated. In the ditamap there are references to the translated keys.ditamap. There are multiple keys.ditamap.


We use DITA-OT2 to publish the map to PDF, but the keys are not translated in the output.

Only the first keys.ditamap is used, for all languages in the map.


We tested this also with DITA-OT3 and it is the same thing.


I am aware of the linguistic problems there can be with translation of variables (grammar and syntax), in our case the keys are used in a CE declaration of conformity to identify the kind of product.


Is this a bug? Or is it considered 'not done'?


Best regards,

Anneke Von den Hoff



Re: Online DITA SAAS tools

glennjmorris@...
 

easyDITA should meet and exceed your requirements.  I would be happy to arrange a Free Trial, demo, answer any questions, or supply a price estimate - with no obligation.  glenn.morris@...


Re: Online DITA SAAS tools

glennjmorris@...
 

easyDITA should absolutely meet and exceed your requirements, so happy to answer any questions, arrange a Free Trial or demo, and/or provide a cost estimate with no obligation. Let me know your preference.  glenn.morris@....


mif2mml - tool for converting FrameMaker equations to MathML

Chris Papademetrious
 

Hi all,

Michel Rodriguez has put a handy MIF-to-MathML equation conversion utility on Github:


He originally wrote this to convert IEEE equations from FrameMaker to MathML. In my own quest to migrate from structured FrameMaker to DITA, I needed this same conversion capability. Over the last few months, I worked with Michel to convert a few thousand equations from my own content. His updated utility works extremely well, so I asked if he could make the utility available to a wider audience.

In my case, I simply updated our FrameMaker XML write rules to write equations as MIF files:

element "eqn" {
   is fm equation element "Eqn";
   writer equation {
      export to file "$(docname).mif" as "MIF";
      specify size in in;
   }    
}

When I save a structured document as XML from FrameMaker, the tool writes the equation in MIF format:

<body>The maximum number is computed as follows:</body>
<equation>
<equation-art file="eqn/18_dftmax_using152.mif" position="below"
    align="acenter" cropped="1" float="0" width="1.524in"
    height="0.693in" angle="0.000" nsoffset="0.000in" dpi="300"/></equation>


In my FrameMaker-to-DITA conversion script, I use mif2mml to convert each referenced equation, then I inlined the resulting MathML into the DITA file:

    <p>The maximum number is computed as follows:</p>
    <fig>
      <mathml>
        <math displaystyle="true" mathbackground="transparent" xmlns="http://www.w3.org/1998/Math/MathML">
          <mrow>
...omitted...
          </mrow>
        </math>
      </mathml>
    </fig>


The resulting equations show up in Oxygen XML Author and are interactively editable using the MathFlow equation editor plugin for Oxygen.


Re: Generating a reference report

Nilesh Parmar
 

Oxygen has very good support for writing XPATH queries. I've been using this with a lot of success. 


On Mon, Mar 4, 2019 at 8:15 PM Yves Barbion yves.barbion@... [dita-users] <dita-users@...> wrote:
 

Hi group

I've got a ditamap with lots of inline xrefs and I would like to generate a report to see which topic refers to which, so we can see if we can replace some (or most) of these inline xrefs with relationship tables.

Any ideas how this can be done?

I'm using oXygen XML Editor v20 (and v21 soon).

Thanks

Yves


Re: OT 3.3 PDF with FOP broken

ekimber@contrext.com
 

The latest OT versions manage the class path automatically and in a way that is different from how it used to be done.

To run the OT from Ant I use the exec command (this is for macOS/linux/bash under Windows, for Windows you'd need a slightly different incantation to invoke the dita.bat script):

<exec dir="${dita-ot-dir}/bin" executable="/bin/bash">
<arg value="dita"/>
<arg value='"--install=${zip.file}"'/>
<arg value="--force"/>
</exec>

That way you get all of the dita command's class pathy goodness.

Cheers,

E.

--
Eliot Kimber
http://contrext.com


On 3/8/19, 2:59 PM, "lwwhite5@hotmail.com [dita-users]" <dita-users@yahoogroups.com> wrote:






















Okay, so I just tested using the dita command line and it works. So....? Is there an issue with ANT, then?


Re: OT 3.3 PDF with FOP broken

Leigh White
 

Okay, so I just tested using the dita command line and it works. So....? Is there an issue with ANT, then?


Re: OT 3.3 PDF with FOP broken

Leigh White
 

I'm just baffled. I redownloaded just in case the first one was somehow corrupted. Same result. I've tested the same content in various OT versions with these results:

2.5.4 - OK
3.0 - OK
3.1 - OK but generates a log file of 3042MB!
3.1.2 - Fails
3.3 - Fails

I run my build using an ANT build file and batch file to launch it:

<?xml version="1.0" encoding="UTF-8" ?>

<project name="sample_pdf" default="samples.pdf" basedir=".">
  
  <property name="dita.dir" location="C:\dita-ot-3.3"/>
  <property name="output.dir" location="W:\!Projects\test\_output"/>
  <property name="dita.temp.dir" location="W:\!Projects\test\_temp"/>
  
  <target name="samples.pdf" description="build the samples as PDF" depends="clean.samples.pdf">
    <ant antfile="${dita.dir}/build.xml">
      <property name="args.input" location="C:\dita-ot-3.3\docsrc\samples\taskbook_bigcorp.ditamap"/> 
      <property name="transtype" value="bigcorp"/>
  <property name="clean.temp" value="no"/>
  <property name="pdf.formatter" value="fop"/>
  <property name="axf.path" value="C:\Program Files\Antenna House\AHFormatterV64"/>
  <property name="axf.cmd" location="C:\Program Files\Antenna House\AHFormatterV64\AHFCmd.exe"/>   
  <property name="bigcorp.distribution" value="restricted"/>
    </ant>
<copy todir="${output.dir}">
        <fileset dir="${dita.temp.dir}" includes="topic.fo"/>
    </copy>

  </target>
  
  <target name="clean.samples.pdf" description="remove the sample PDF output">
      <delete dir="${output.dir}"/>
  </target>
  
</project>

Batch file:

set DITA_DIR=C:\dita-ot-3.1\
set JAVA_HOME=C:\Program Files\Java\jdk1.8.0_172\
set TEMP_DIR=W:\!Projects\test\_temp
if exist %TEMP_DIR%\nul rd /q /s %TEMP_DIR%
call %DITA_DIR%bin\ant -f BigCorp_XSLFO.ant -l BigCorp_XSLFO.log

I haven't tested with a command line but I've been running builds like this forever with no problems. It would be disheartening if suddenly it were no longer an option.


---In dita-users@..., <ekimber@...> wrote :

I was able to render the OT user guide using FOP on Windows:


set JAVA_OPTS=-Xmx1G
dita -f pdf2 -i docsrc\userguide.ditamap -o out\pdf -v
...
[fop] [INFO] NSimSun
[fop] C:\Users\ekimber\AppData\Local\Temp\temp20190308142509051\topic.fo -> C:\Users\ekimber\dita-ot\dita-ot-3.3\dita-ot-3.3\out\pdf\userguide.pdf

This is using a fresh 3.3 download.

Note that if you use Edge or Chrome to do the download it will like give a (false) virus warning and prevent the download (see https://github.com/dita-ot/dita-ot/issues/3171) .

Cheers,

E.
--
Eliot Kimber
http://contrext.com


On 3/8/19, 1:39 PM, "lwwhite5@... [dita-users]" <dita-users@...> wrote:





I doubt it, as 1) the same content renders fine with AH and XEP and 2) I'm using the sample content supplied in the DITA OT.

This is literally a freshly-downloaded OT, no changes whatsoever. Using jdk1.8.0_172.

Thanks,
Leigh


Re: OT 3.3 PDF with FOP broken

ekimber@contrext.com
 

I was able to render the OT user guide using FOP on Windows:


set JAVA_OPTS=-Xmx1G
dita -f pdf2 -i docsrc&#92;userguide.ditamap -o out&#92;pdf -v
...
[fop] [INFO] NSimSun
[fop] C:&#92;Users&#92;ekimber&#92;AppData&#92;Local&#92;Temp&#92;temp20190308142509051&#92;topic.fo -> C:&#92;Users&#92;ekimber&#92;dita-ot&#92;dita-ot-3.3&#92;dita-ot-3.3&#92;out&#92;pdf&#92;userguide.pdf

This is using a fresh 3.3 download.

Note that if you use Edge or Chrome to do the download it will like give a (false) virus warning and prevent the download (see https://github.com/dita-ot/dita-ot/issues/3171) .

Cheers,

E.
--
Eliot Kimber
http://contrext.com


On 3/8/19, 1:39 PM, "lwwhite5@hotmail.com [dita-users]" <dita-users@yahoogroups.com> wrote:





I doubt it, as 1) the same content renders fine with AH and XEP and 2) I'm using the sample content supplied in the DITA OT.

This is literally a freshly-downloaded OT, no changes whatsoever. Using jdk1.8.0_172.

Thanks,
Leigh


Re: OT 3.3 PDF with FOP broken

Leigh White
 

I doubt it, as 1) the same content renders fine with AH and XEP and 2) I'm using the sample content supplied in the DITA OT.

This is literally a freshly-downloaded OT, no changes whatsoever. Using jdk1.8.0_172.

Thanks,
Leigh


boilerplate text in footer variable renders everywhere

Leigh White
 

DITA OT 3.3, PDF.


I'm suddenly seeing odd behavior with header and footer localization variables.


For example, this:

<variable id="Body odd footer"><param ref-name="distribution"/> <param ref-name="partnumber"/>, Rev. <param ref-name="revision"/> | </variable>


Renders as:


Restricted: Do not distribute , Rev. |

WP123-4567, Rev. 2.0 |


It's putting "Rev" and "|" after every parameter, not just before and after the "revision" parameter, as intended.


Here's the template:


<xsl:template name="insertBodyOddFooter">

<fo:static-content flow-name="odd-body-footer">

<fo:block xsl:use-attribute-sets="__body__odd__footer">

<xsl:call-template name="getVariable">

<xsl:with-param name="id" select="'Body odd footer'"/>

<xsl:with-param name="params">

<distribution>

<xsl:value-of select="$bc.distributionlevel"/>

</distribution>

</xsl:with-param>

</xsl:call-template>

</fo:block>

<fo:block xsl:use-attribute-sets="__body__odd__footer">

<xsl:call-template name="getVariable">

<xsl:with-param name="id" select="'Body odd footer'"/>

<xsl:with-param name="params">

<partnumber>

<xsl:value-of select="$bc.bookpartnumber"/>

</partnumber>

<revision>

<xsl:value-of select="$bc.bookrevision"/>

</revision>

</xsl:with-param>

</xsl:call-template>

</fo:block>

</fo:static-content>

</xsl:template>


Is this a bug or intended behavior? If it's intended, then it's going to cause some extra hoops with language-specific boilerplate text (like "Rev.") in headers and footers.


Thanks,

Leigh


Re: Online DITA SAAS tools

ekimber@contrext.com
 

The Orbis Technologies (nee Really Strategies) DocZone product is a pure SaaS DITA authoring and content management system: https://www.orbistechnologies.com/doczone

You can also get a lot of mileage from using normal Git (or similar) content management systems coupled with a tool like Oxygen Web Editor (which has out-of-the-box support for editing from git repositories such as GitHub, BitBucket, and GitLab.

For one of my clients I've set up Azure Pipelines to do automatic OT building and they use either desktop Oxygen or Oxygen Web Author to work on the DITA source. Since they are an Azure shop it was dead simple to set up and the only cost is the Oxygen licensing and the setup of Web Author.

Cheers,

E.

--
Eliot Kimber
http://contrext.com


On 3/8/19, 11:23 AM, "David Hollis david@tdandc.co.uk [dita-users]" <dita-users@yahoogroups.com> wrote:

Hi,

<caveat>

I need to ask this question as I have only ever used a desktop tool to edit DITA content. In other words, this is a genuine question, and I hope folk don't see this as a marketing opportunity.

</caveat>

I'm currently talking to a company about doing some work for them, and I have explained what DITA is. I have explained that I have my own desktop licence, and that they would need to purchase a DITA tool. Their preference would seem to be for an online SAAS tool.

Can folks please provide me with a list of the online DITA SAAS tools, in other words 'cloud based'. I think it will also help if they have subscription pricing.

It will help me if the SAAS tool can integrate with a popular desktop tool:

1. I can work in the desktop DITA tool, and upload content to the SAAS tool.

2. I can develop a DITA Toolkit plugin locally, and upload that to the SAAS tool.

Is this asking too much?!

Could anyone who has used a DITA SAAS tool please provide a short recommendation, or any cautionary tale about them.

Maybe someone has written a blog post about their experiences?

Many thanks,
David


Re: Online DITA SAAS tools

Wayne Brissette
 

Hi David:

I know EasyDITA has this model. And there are others that would allow this… I have no idea of pricing, but I know they lurk here so I’m sure they will help you.

-Wayne


Online DITA SAAS tools

David Hollis <david@...>
 

Hi,

<caveat>

I need to ask this question as I have only ever used a desktop tool to edit DITA content. In other words, this is a genuine question, and I hope folk don't see this as a marketing opportunity.

</caveat>

I'm currently talking to a company about doing some work for them, and I have explained what DITA is. I have explained that I have my own desktop licence, and that they would need to purchase a DITA tool. Their preference would seem to be for an online SAAS tool.

Can folks please provide me with a list of the online DITA SAAS tools, in other words 'cloud based'. I think it will also help if they have subscription pricing.

It will help me if the SAAS tool can integrate with a popular desktop tool:

1. I can work in the desktop DITA tool, and upload content to the SAAS tool.

2. I can develop a DITA Toolkit plugin locally, and upload that to the SAAS tool.

Is this asking too much?!

Could anyone who has used a DITA SAAS tool please provide a short recommendation, or any cautionary tale about them.

Maybe someone has written a blog post about their experiences?

Many thanks,
David


Re: OT 3.3 PDF with FOP broken

quickvanrijt
 

@Leigh
I do not encounter any weird FOP things with out-of-the-box dita-ot-3.3 when rendering my testsuite of simple DITA files.
Used execution calling dita.bat.

Any dirty source topics then?
Quick



OT 3.3 PDF with FOP broken

Leigh White
 

Testing OT 3.3. Generic PDF output (org.dita.pdf2) with FOP. Build fails. Following errors:


C:\dita-ot-3.3\plugins\org.dita.pdf2.fop\build_fop.xml:144: taskdef class org.apache.fop.tools.anttasks.C:\dita-ot-3.3\plugins\org.dita.pdf2.fop\build_fop.xml:144: taskdef class org.apache.fop.tools.anttasks.Fop cannot be found

 using the classloader AntClassLoader[]


Maybe a reintroduction of this bug?: https://github.com/dita-ot/dita-ot/issues/1952


AH and XEP are fine.


Thanks,

Leigh

2481 - 2500 of 46642