Date   

Re: New installation of the DITA-OT #DITA-OT

Dan Vint
 

I think you need to quote the path because of the space in "Program Files". Quote the whole path and I think it will work.



Sent from my Verizon, Samsung Galaxy smartphone


-------- Original message --------
From: Nancy Roberts <nanr93@...>
Date: 2/27/21 7:11 PM (GMT-08:00)
To: main@dita-users.groups.io
Subject: Re: [dita-users] New installation of the DITA-OT #DITA-OT

Whoops, I pasted the wrong example. Like I said, I'm good with GUI-based tools. I've never done anything serious with the command line. This is sort of a trial by fire.

So now my problem is the input path. I've tried every combination of .\ and ..\ that I can think of. I can't find the right combination to run the sample map provided in the OT. The map's path is C:\Program Files\dita-ot-3.6\docsrc\samples\sequence.ditamp. I set the PATH environment variable to C:\Program Files\dita-ot-3.6\bin.

How do I run this command? Running the suggested syntax gets me nowhere:
--input=sequence.ditamap --format=html5
Error: Failed to run pipeline: [DOTA069F][FATAL] Input file 'file:/C:/Program%20Files/dita-ot-3.6/sequence.ditamap' cannot be located or read. Ensure that file was specified properly and that you have permission to access it.

Adding some combination of .\ and ..\ makes it worse.
Help...

Thanks!
Nancy


Re: New installation of the DITA-OT #DITA-OT

Nancy Roberts
 

Whoops, I pasted the wrong example. Like I said, I'm good with GUI-based tools. I've never done anything serious with the command line. This is sort of a trial by fire.

So now my problem is the input path. I've tried every combination of .\ and ..\ that I can think of. I can't find the right combination to run the sample map provided in the OT. The map's path is C:\Program Files\dita-ot-3.6\docsrc\samples\sequence.ditamp. I set the PATH environment variable to C:\Program Files\dita-ot-3.6\bin.

How do I run this command? Running the suggested syntax gets me nowhere:
--input=sequence.ditamap --format=html5
Error: Failed to run pipeline: [DOTA069F][FATAL] Input file 'file:/C:/Program%20Files/dita-ot-3.6/sequence.ditamap' cannot be located or read. Ensure that file was specified properly and that you have permission to access it.

Adding some combination of .\ and ..\ makes it worse.
Help...

Thanks!
Nancy


Re: New installation of the DITA-OT #DITA-OT

Alan Houser
 

Hi,

It looks like you're missing the double-dash before "format"? And I suspect you want "--format=html5" (or xhtml).

HTH!

-Alan

On 2/27/21 2:50 PM, Nancy Roberts wrote:
Hi all,

I'm an experienced DITA user, but I've only ever used Oxygen or the Ixiasoft CMS to produce documentation for the company I work for. Now I've got a private client interested in HTML output of some sort (we'll probably settle on HTML5). I'm trying to put together an inexpensive DITA solution (read: free). I found and installed Codex, which seems promising. Then I installed the Adopt OpenJDK and the DITA-OT, v3.6. I set the PATH variable, in accordance with the installation instructions. I am able to run a bunch of commands, but I can't generate any output using the sample map (sequence.ditamap) and preinstalled plugins that come with the OT.

Here's what I'm getting:

C:\Users\nanr9>dita --input=sequence.ditamap format=dita
Error: Transformation type not defined
 
←[1mUsage←[0m:
  dita -i <file> -f <name> [options]
  dita --project=<file> [options]
 
←[1mSubcommands←[0m:
  deliverables                  Print list of deliverables in project file
  install                       Install or reload plug-ins
  plugins                       Print list of installed plug-ins
  transtypes                    Print list of installed transformation types (output formats)
  uninstall                     Remove and delete plug-in
  version                       Print version information and exit
 
  See 'dita <subcommand> --help' for details about a specific subcommand.
 
←[1mArguments←[0m:
  -i <file>, --input=<file>     Input file
  -f <name>, --format=<name>    Output format (transformation type)
  -p <file>, --project=<file>   Publish a project file with multiple deliverables
 
←[1mOptions←[0m:
  --filter=<files>              Filter and flagging files. This option can be passed multiple times.
  -h, --help                    Print help information
  -o <dir>, --output=<dir>      Output directory
  -r <file>, --resource=<file>  Additional input resources. This option can be passed multiple times.
 
See 'dita --help' for full list of options.

When I run transtypes, I can see both HTML5 and XHTML are installed:

C:\Users\nanr9>dita --transtypes
xhtml
eclipsehelp
html5
htmlhelp
dita
pdf
pdf2
markdown
markdown_github
       markdown_gitbook


What am I doing wrong?

Thanks!
Nancy
-- 
Alan Houser
Group Wellesley, Inc.
Consultant and Trainer, Technical Publishing
arh on Twitter
412-450-0532


Re: hide and seek

selvats@...
 

Please use the toc=no attribute on the topicref for the topic to hide it from the TOC.


New installation of the DITA-OT #DITA-OT

Nancy Roberts
 

Hi all,

I'm an experienced DITA user, but I've only ever used Oxygen or the Ixiasoft CMS to produce documentation for the company I work for. Now I've got a private client interested in HTML output of some sort (we'll probably settle on HTML5). I'm trying to put together an inexpensive DITA solution (read: free). I found and installed Codex, which seems promising. Then I installed the Adopt OpenJDK and the DITA-OT, v3.6. I set the PATH variable, in accordance with the installation instructions. I am able to run a bunch of commands, but I can't generate any output using the sample map (sequence.ditamap) and preinstalled plugins that come with the OT.

Here's what I'm getting:

C:\Users\nanr9>dita --input=sequence.ditamap format=dita
Error: Transformation type not defined
 
←[1mUsage←[0m:
  dita -i <file> -f <name> [options]
  dita --project=<file> [options]
 
←[1mSubcommands←[0m:
  deliverables                  Print list of deliverables in project file
  install                       Install or reload plug-ins
  plugins                       Print list of installed plug-ins
  transtypes                    Print list of installed transformation types (output formats)
  uninstall                     Remove and delete plug-in
  version                       Print version information and exit
 
  See 'dita <subcommand> --help' for details about a specific subcommand.
 
←[1mArguments←[0m:
  -i <file>, --input=<file>     Input file
  -f <name>, --format=<name>    Output format (transformation type)
  -p <file>, --project=<file>   Publish a project file with multiple deliverables
 
←[1mOptions←[0m:
  --filter=<files>              Filter and flagging files. This option can be passed multiple times.
  -h, --help                    Print help information
  -o <dir>, --output=<dir>      Output directory
  -r <file>, --resource=<file>  Additional input resources. This option can be passed multiple times.
 
See 'dita --help' for full list of options.

When I run transtypes, I can see both HTML5 and XHTML are installed:

C:\Users\nanr9>dita --transtypes
xhtml
eclipsehelp
html5
htmlhelp
dita
pdf
pdf2
markdown
markdown_github
       markdown_gitbook


What am I doing wrong?

Thanks!
Nancy


Re: Using conkeyref-push to replace one topic with another at the map level

Chris Papademetrious
 

Hi Julio, Radu,

Thanks for giving this some thought. This produced a different error:

[conref-push] [DOTJ043W][WARN] The conref push function is trying to replace an element that does not exist (element "#id3" in file "/tmp/temp20210226091132575/topic_3.dita").

so I filed a DITA-OT issue to reconcile the functionality against the spec:

Map-level conkeyref-push of a topic does not work #3711

Testcase provided with the issue, if you'd like to poke at it!

 - Chris


Re: Using conkeyref-push to replace one topic with another at the map level

Julio J Vazquez
 

I think Radu's syntax is the most correct, but more correct would be to use and use key#topicid.

Julio J. Vazquez


Re: Using conkeyref-push to replace one topic with another at the map level

Radu Coravu
 

Hi Chris,

This looks like a bug to me.

How about if you explicitly specify the topic ID when definining the "topic_2" key?

<topicref href="topic_2.dita#topicID" keys="topic_2"/>

Regards,

Radu

Radu Coravu
Oxygen XML Editor
On 2/25/21 19:16, Chris Papademetrious wrote:

Hi folks!

According to the DITA spec at

https://docs.oasis-open.org/dita/dita/v1.3/os/part2-tech-content/archSpec/base/conref-overview.html

a conref/conkeyref can target:

  • A referenced element within a DITA map
  • A referenced element within a DITA topic
  • An entire DITA map
  • An entire DITA topic

We have a need to replace a boilerplate topic in a reused map with a product-specific topic. I created the following test map (topics 1-3 would actually be in the reused map):

<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="urn:oasis:names:tc:dita:rng:map.rng" schematypens="http://relaxng.org/ns/structure/1.0"?>
<map>
    <title>Map</title>
    <topicref href="topic_2_replacement.dita" processing-role="resource-only"
        conkeyref="topic_2" conaction="pushreplace" />
    <topicref href="topic_1.dita" keys="topic_1"/>
    <topicref href="topic_2.dita" keys="topic_2"/>
    <topicref href="topic_3.dita" keys="topic_3"/>
</map>

but the DITA-OT issues the following error:

[conref-push] [DOTJ041E][ERROR] The attribute conref="topic_2.dita" uses invalid syntax. The value should contain '#' followed by a topic or map ID, optionally followed by '/elemID' for a sub-topic element.

It doesn't seem to want to operate on an entire topic. I was able to approximate the behavior by moving the pushes into the replacement topic <title> and <body> elements, but this is fragile and awkward.

Are entire-topic (and entire-map) operations not supported after all? Thanks in advance for any help!

 - Chris

  


Using conkeyref-push to replace one topic with another at the map level

Chris Papademetrious
 

Hi folks!

According to the DITA spec at

https://docs.oasis-open.org/dita/dita/v1.3/os/part2-tech-content/archSpec/base/conref-overview.html

a conref/conkeyref can target:

  • A referenced element within a DITA map
  • A referenced element within a DITA topic
  • An entire DITA map
  • An entire DITA topic

We have a need to replace a boilerplate topic in a reused map with a product-specific topic. I created the following test map (topics 1-3 would actually be in the reused map):

<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="urn:oasis:names:tc:dita:rng:map.rng" schematypens="http://relaxng.org/ns/structure/1.0"?>
<map>
    <title>Map</title>
    <topicref href="topic_2_replacement.dita" processing-role="resource-only"
        conkeyref="topic_2" conaction="pushreplace" />
    <topicref href="topic_1.dita" keys="topic_1"/>
    <topicref href="topic_2.dita" keys="topic_2"/>
    <topicref href="topic_3.dita" keys="topic_3"/>
</map>

but the DITA-OT issues the following error:

[conref-push] [DOTJ041E][ERROR] The attribute conref="topic_2.dita" uses invalid syntax. The value should contain '#' followed by a topic or map ID, optionally followed by '/elemID' for a sub-topic element.

It doesn't seem to want to operate on an entire topic. I was able to approximate the behavior by moving the pushes into the replacement topic <title> and <body> elements, but this is fragile and awkward.

Are entire-topic (and entire-map) operations not supported after all? Thanks in advance for any help!

 - Chris


Re: Multiple links to same topic #linking #PDF

mganir@...
 

Thanks Radu!


Re: hide and seek

Aaron Mehl
 

Thanks for all the suggestions, I haven't used index terms yet, I will look into it, and I am implementing the other ideas.
Aaron

On Wednesday, February 24, 2021, 09:21:37 AM EST, Dave C <dac.dave@...> wrote:


If you add an xref to the topic (like in a tip or something) but don't include the topic in the map the topic will be included in the webhelp output and the link will work, but it will not show up in navigation. The downside is that it will break the breaks-crumb navigation and the miniTOC. 

Dave C.


Re: hide and seek

Dave C
 

If you add an xref to the topic (like in a tip or something) but don't include the topic in the map the topic will be included in the webhelp output and the link will work, but it will not show up in navigation. The downside is that it will break the breaks-crumb navigation and the miniTOC. 

Dave C.


Re: hide and seek

nkerzreho
 

Hi there

I would do as suggested above.
Add the topic to the structure with attribute @toc=no
Add the topic in a relationship table to link into to another meaningful/logical topic.

I also index the content (indexterm/keywords), if that fits your outputs.

Good luck,
Nolwenn


Re: Multiple links to same topic #linking #PDF

Radu Coravu
 

Hi Marisa,

I'm attaching the PDF I obtain by using DITA OT 3.6. The link text seems to be computed fine in both links. So maybe you should consider upgrading your publishing engine.

Regards,

Radu

Radu Coravu
Oxygen XML Editor
On 2/24/21 06:40, mganir via groups.io wrote:

Hi Radu, 

I'm using DITA OT 2.4, and I do have extra PDF customizations, but when I test with the base PDF2 transform, I have the same issue. In the output of the attached files, the duplicate links to "Test concept" are shown on page 3. 

Thanks for taking a look!

-Marisa

  


Re: Multiple links to same topic #linking #PDF

mganir@...
 

Hi Radu, 

I'm using DITA OT 2.4, and I do have extra PDF customizations, but when I test with the base PDF2 transform, I have the same issue. In the output of the attached files, the duplicate links to "Test concept" are shown on page 3. 

Thanks for taking a look!

-Marisa


Re: hide and seek

Aaron Mehl
 

Thanks, I like both ideas, maybe an appendix... 
Thanks,
Aaron

On Tuesday, February 23, 2021, 03:28:24 PM EST, Chris Brand via groups.io <chrizzbee74@...> wrote:


Hi

Hm, I would keep it as part of the document structure and don't try to hide it. Maybe move it to a troubleshooting section after the main chapters? You said "...if they made a mistake". That screams for troubleshooting. So, if something goes wrong, you could direct the readers to this dedicated chapter.

Hope it helps.

Chris

Am 23.02.21 um 20:59 schrieb Aaron Mehl via groups.io:
Hi all,
I have a document with a topic that I don't want displayed, but at the same time I want it available to users if need be. 
This might be with a link or maybe outside the flow of the entire document.
But since it isn't an essential part of the document, I don't want it included in the web output.

I have for example a topic which contains subtopics called editing Accounts. My document is about creating accounts but if they made a mistake they need to find editing accounts. 

Now for my question: 
How do I hide editing accounts in my Dita map? Now it is included in my map as a subtopic to creating accounts, and disturbing the flow of the document.
Where should I put it in my dita map, if at all?
Is there a way to leave it in-place, and somehow just hide it?

Thanks,
Aaron 


Re: hide and seek

Chris Brand
 

Hi

Hm, I would keep it as part of the document structure and don't try to hide it. Maybe move it to a troubleshooting section after the main chapters? You said "...if they made a mistake". That screams for troubleshooting. So, if something goes wrong, you could direct the readers to this dedicated chapter.

Hope it helps.

Chris

Am 23.02.21 um 20:59 schrieb Aaron Mehl via groups.io:

Hi all,
I have a document with a topic that I don't want displayed, but at the same time I want it available to users if need be. 
This might be with a link or maybe outside the flow of the entire document.
But since it isn't an essential part of the document, I don't want it included in the web output.

I have for example a topic which contains subtopics called editing Accounts. My document is about creating accounts but if they made a mistake they need to find editing accounts. 

Now for my question: 
How do I hide editing accounts in my Dita map? Now it is included in my map as a subtopic to creating accounts, and disturbing the flow of the document.
Where should I put it in my dita map, if at all?
Is there a way to leave it in-place, and somehow just hide it?

Thanks,
Aaron 


Re: hide and seek

Jeff Hooker
 

I believe that if you create relationship table for the topic, it will end up in the "related links" section of a topic and will therefore be packaged with your help system, but won't appear in the TOC


On Tue, Feb 23, 2021 at 11:59 AM Aaron Mehl via groups.io <mehlzaidy770=yahoo.com@groups.io> wrote:
Hi all,
I have a document with a topic that I don't want displayed, but at the same time I want it available to users if need be. 
This might be with a link or maybe outside the flow of the entire document.
But since it isn't an essential part of the document, I don't want it included in the web output.

I have for example a topic which contains subtopics called editing Accounts. My document is about creating accounts but if they made a mistake they need to find editing accounts. 

Now for my question: 
How do I hide editing accounts in my Dita map? Now it is included in my map as a subtopic to creating accounts, and disturbing the flow of the document.
Where should I put it in my dita map, if at all?
Is there a way to leave it in-place, and somehow just hide it?

Thanks,
Aaron 


hide and seek

Aaron Mehl
 

Hi all,
I have a document with a topic that I don't want displayed, but at the same time I want it available to users if need be. 
This might be with a link or maybe outside the flow of the entire document.
But since it isn't an essential part of the document, I don't want it included in the web output.

I have for example a topic which contains subtopics called editing Accounts. My document is about creating accounts but if they made a mistake they need to find editing accounts. 

Now for my question: 
How do I hide editing accounts in my Dita map? Now it is included in my map as a subtopic to creating accounts, and disturbing the flow of the document.
Where should I put it in my dita map, if at all?
Is there a way to leave it in-place, and somehow just hide it?

Thanks,
Aaron 


[ANN] Release of XMLmind XSL-FO Converter v6.3.1

Hussein Shafie
 

Release of XMLmind XSL-FO Converter v6.3.1. Highlights:

- Updated many software components in XMLmind XSL Utility and XMLmind XSL Server (ditac, Saxon, Batik, FOP, etc).

- A couple of bug fixes, including a fix for an intriguing bug related to space between text lines triggered by MS-Word 2019+.

More information: http://www.xmlmind.com/foconverter/changes.html

---------------------------------
What is XMLmind XSL-FO Converter?
---------------------------------

XMLmind XSL-FO Converter is an XSL-FO processor similar to Apache FOP, RenderX XEP or Antenna House XSL Formatter, except that it generates RTF, WML, ODT and DOCX file formats rather than PDF.

More importantly, this commercial product comes with a handy desktop application called "XMLmind XSL Utility" (http://www.xmlmind.com/foconverter/xsl_utility.html) which makes it easy converting DITA, DocBook, XHTML and XSL-FO documents to a variety of formats (PDF, RTF, WML, ODT, DOCX, HTML, EPUB, Web Help, etc).

XMLmind XSL Utility also makes it easy customizing the deliverables it generates (PDF, DOCX, EPUB, Web Help, etc) and this, without modifying configuration files by hand and without prior knowledge of XSLT. See http://www.xmlmind.com/foconverter/_distrib/xslutil/doc/help/com.xmlmind.xslutil.ConversionEditor.html#customizing_xslt

Home page: http://www.xmlmind.com/foconverter/

261 - 280 of 46295