Date   

Re: Use CMIS protocol with dita-ot #DITA-OT #CCMS #Oxygen

Nicolas Delobel
 

Thanks Radu.


[ann][webinar] Working with DITA in Oxygen - Customizing the Editing Experience (April 14) #Oxygen

alin_belu@...
 

Hello,
 
Our weekly live event series continues next Wednesday (April 14) with the “Working with DITA in Oxygen - Customizing the Editing Experience” webinar! 
 
Under the guidance of Sorin Carbunaru (software developer at Syncro Soft), you will explore several ways of customizing the DITA editing experience according to your desires. This webinar will cover the customization of: 
* Author actions - edit existing actions, remove actions or add new ones. Add actions to the main toolbar, the contextual menu, or the content completion window. 
* The Author-mode rendering - tailor the visuals of the editing experience using CSS and add in-place actions directly in the Author page. 
* Document validation - create new validation rules and provide quick fixes using Schematron. 
* The content-completion assistant - automatically insert or reject elements, attributes, and values. 
* New document templates - add prefixes or suffixes to the names of your new documents, customize the template icons, mark templates as popular. 
 
This is a free event and you can register at http://www.oxygenxml.com/evs2021-6.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: Group reltable Links by Topic Type #reltable

Radu Pisoi
 

Hi,

We have a project on GitHub where we contribute publishing templates samples based on the user requests.
Some of them includes XSLT extension points and can be used as starting points:
* Generation Date & Time - template containing XSLT extensions that add the generation date & time to the WebHelp Responsive footer.
* Bookmap Copyright Info - template containing XSLT extensions that can transfer meta information specified in the DITA map to the WebHelp Responsive footer.
* Logo Before Search Template - this is a sample publishing template that displays the Logo component before the search input. It uses an XSLT Extension File to customize the structure of the search component.
* Change Viewport Meta - this is a sample publishing template that uses an XSLT Extension File to customize the value of the viewport <meta>.

Also, please see the Developer Reference section from the WebHelp Responsive user guide. This section is designed for developers to provide advanced information about the Oxygen XML WebHelp Responsive plugin. The information in this section will help you to extend or customize the output and provide an overview of the plugin architecture.

-- 
Regards,
Radu
--
Radu Pisoi
<oXygen/>  XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com

On 3/25/2021 10:42 AM, schmidt.eduard@... wrote:

Good morning Radu (and everyone else, of course),

after researching the topic all morning I still don’t have the first clue how to implement your suggestion. Would you mind giving me some hints or pointing me to a resource for dummies that explains how one would go about overriding templates using XSLT extension points?
Thank you kindly.

Regards,
Ed



  


Re: <term> element with @keyref attribute inserted within topic title, not visible in <toc> #XSLT

Michael H.
 

Try using <ph> or <keyword> instead of <term>.


<term> element with @keyref attribute inserted within topic title, not visible in <toc> #XSLT

Shaurabh
 

I have a requirement where I need to include few @keyrefs for terms within <toc> for which i have added <title class="- topic/title ">History and <term keyref="conclusion_1"/> of story</title> in topic title. This <term> element along with keyref is visible in output file in topic title. But same is not rendered in Table of Content section. Please see below example for reference. Please suggest any solution or workaround for this issue. I am using DITA-OT 3.5.4 version.
Thanks in advance.

Topic title in output file:(word in Italics is @keyref for term)
   
       1.1 History and conclusion of story

Table of Content in output file:(term with keyref is not visible in table of content)

Contents
1 About this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
1.1 History and of story. . . . . . . . . .  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2



Thanks,
Shaurabh


Adding a parameter to an extension in the DITA-OT preprocessing

Pierre Attar
 

Hi all,

I've created an extension to the DITA-OT topicpull process.

The extension is something like

 <feature extension="ant.import" file="lr-solve.xml"/>
<feature extension="depend.preprocess.topicpull.pre" value="lr-solve" />

Of course, lr-solve.xml is an ant file containing the needed target.

This works in 3.6 using the xhtml5 transtype.

Unfortunately it does not works withe pdf2 transtype because it uses the preprocess2 mechanism and I don't knows how to name the feature extension.

Nevertheless, tu this lr-solve process, I need to add a parameter for this transformation. Unfortunately, I only know how to add a parameter to a new or exiting transtype. I search in the DITA-OT documentation and did not found any documentation to add parameter to the preprocess.

So, my two questions :

- how to add a feature extension to the preprocess2 process ?

- how to add a parameter to an extension called both by the preprocess ans the preprocess2 processes ?

Thanks for sharing ideas, Pierre


Re: Override Topic title with @navtitle #XSLT

Shaurabh
 

Even though Toshihiko mentioned that it seems a known bug, i thought of giving them a try. I tried few other approaches as well using XSLT, but no success. As already mentioned by Ajay, we are using DITA-OT 3.5.4 version. Please let me know if there is any other work around to achieve above mentioned scenario.

Thanks


Re: Override Topic title with @navtitle #XSLT

ajay.soam@...
 

We are using DITA-OT 3.5.4 version. thx


Re: Override Topic title with @navtitle #XSLT

Kristen James Eberlein
 

So, embace the future; with DITA 2.0, @alt, @navtitle, and @locktitle are all removed. <grin/>

Shaurabh, what processor are you using? If you are using the DITA-OT, what version?

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
OASIS Distinguished Contributor
Principal consultant, Eberlein Consulting LLC
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)


On 3/31/2021 10:09 AM, Toshihiko Makita via groups.io wrote:
Shaurabh is using @navtitle rather than @alt.

Also there is DITA-OT bug I've experienced even if you use topicmeta/navititle instead of @navtitle:

topicmeta/navtitle is overridden by topic/title even if @locktitle="yes" #3708
https://github.com/dita-ot/dita-ot/issues/3708


Re: Override Topic title with @navtitle #XSLT

Toshihiko Makita
 

Shaurabh is using @navtitle rather than @alt.

Also there is DITA-OT bug I've experienced even if you use topicmeta/navititle instead of @navtitle:

topicmeta/navtitle is overridden by topic/title even if @locktitle="yes" #3708
https://github.com/dita-ot/dita-ot/issues/3708


Re: What DITA tools require XSDs? DITA TC wants to know

Kristen James Eberlein
 

Yes -- I'm not interested in this sort of stuff. (If you can write custom scripts in Ruby, then you also can figure out how to generate XSDs from the TC-provided DTD or RNG.)

I am interested in what commercial applications used in DITA implementations require.

For example, if my memory is correct, Xeditor requires XSDs, as did earlier versions of the SDL Web editor.

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
OASIS Distinguished Contributor
Principal consultant, Eberlein Consulting LLC
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)

On 3/31/2021 8:19 AM, Wayne Brissette via groups.io wrote:
Kris:

I wrote some custom scripts in Ruby with Nokogiri and the only way I could get them to validate against a DTD was to use the XSDs, but I wouldn't say this is even remotely something anybody else would do. I think NXP while using Ruby for some of their custom DITA scripts ditched Nokogiri and went with another XML library.

-Wayne

Kristen James Eberlein wrote on 2021-03-31 07:06:
The DITA TC will only distribute DTDs and RNG for DITA 2.0, no XSDs.

I'm interested in compiling a list of DITA application that require XSDs; please help me out!

Note: This will NOT affect the DITA TC decision to not distribute XSDs.





.


Re: What DITA tools require XSDs? DITA TC wants to know

Wayne Brissette
 

Kris:

I wrote some custom scripts in Ruby with Nokogiri and the only way I could get them to validate against a DTD was to use the XSDs, but I wouldn't say this is even remotely something anybody else would do. I think NXP while using Ruby for some of their custom DITA scripts ditched Nokogiri and went with another XML library.

-Wayne

Kristen James Eberlein wrote on 2021-03-31 07:06:

The DITA TC will only distribute DTDs and RNG for DITA 2.0, no XSDs.

I'm interested in compiling a list of DITA application that require XSDs; please help me out!

Note: This will NOT affect the DITA TC decision to not distribute XSDs.


What DITA tools require XSDs? DITA TC wants to know

Kristen James Eberlein
 

The DITA TC will only distribute DTDs and RNG for DITA 2.0, no XSDs.

I'm interested in compiling a list of DITA application that require XSDs; please help me out!

Note: This will NOT affect the DITA TC decision to not distribute XSDs.

--
Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
OASIS Distinguished Contributor
Principal consultant, Eberlein Consulting LLC
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)


Re: Override Topic title with @navtitle #XSLT

Kristen James Eberlein
 

Add lock title=“yes” to the <topicref> element. Be aware that the @alt attribute has been deprecated since 2010; you should be using <alt>.

Kris


On Mar 31, 2021, at 7:34 AM, Shaurabh via groups.io <shaurabh.prakash-ext@...> wrote:

I have a scenario where i need to override Topic title with navtitle value in frontmatter using xslt. Being new to DITA, i am unaware of any approach to achieve it. Below is the sample given.
Title in the output file should be "Story Book"(given in navtitle) instead of title(Poem) given in dita file. Please help.

#Main.ditamap

<bookmap rev="3" dms_docid="xyz123" id="xyz123" doc_type="Story book">
    <booktitle>
        <mainbooktitle>Stories</mainbooktitle>
    </booktitle>
    <frontmatter class="- map/topicref bookmap/frontmatter ">
        <topicref navtitle="Story Book" format="dita" href="ab12_Story.dita" type="concept"
            class="- map/topicref "/>
    </frontmatter>
    <chapter navtitle="Detailed Story" locktitle="yes">
        <topicref href="UserStory1.dita"/>
    </chapter>
    <backmatter class="- map/topicref bookmap/backmatter ">
        <amendments format="dita" href="xyz123_history.dita" type="concept"
            class="- map/topicref bookmap/amendments "/>
    </backmatter>
</bookmap>


#UserStory1.dita
 
<concept id="concept_123">
    <title>Poem</title>
    <conbody>
        <section id="section_567">
            <p>This Book contains children stories aged between 5 - 8 years.</p>
        </section>
    </conbody>
</concept>


Override Topic title with @navtitle #XSLT

Shaurabh
 

I have a scenario where i need to override Topic title with navtitle value in frontmatter using xslt. Being new to DITA, i am unaware of any approach to achieve it. Below is the sample given.
Title in the output file should be "Story Book"(given in navtitle) instead of title(Poem) given in dita file. Please help.

#Main.ditamap

<bookmap rev="3" dms_docid="xyz123" id="xyz123" doc_type="Story book">
    <booktitle>
        <mainbooktitle>Stories</mainbooktitle>
    </booktitle>
    <frontmatter class="- map/topicref bookmap/frontmatter ">
        <topicref navtitle="Story Book" format="dita" href="ab12_Story.dita" type="concept"
            class="- map/topicref "/>
    </frontmatter>
    <chapter navtitle="Detailed Story" locktitle="yes">
        <topicref href="UserStory1.dita"/>
    </chapter>
    <backmatter class="- map/topicref bookmap/backmatter ">
        <amendments format="dita" href="xyz123_history.dita" type="concept"
            class="- map/topicref bookmap/amendments "/>
    </backmatter>
</bookmap>


#UserStory1.dita
 
<concept id="concept_123">
    <title>Poem</title>
    <conbody>
        <section id="section_567">
            <p>This Book contains children stories aged between 5 - 8 years.</p>
        </section>
    </conbody>
</concept>


Re: A solution to reuse content between two maps and keep the folder structure? Maybe profiling? #reuse

Vladimir Markiev
 

I’m not sure about it but in Oxygen there is a concept called “root map” 
I see. You mean resolving the keys against the root map which will always be my parent map. This may actually be helpful for reuse. Thanks for the good tip.

With some effort, I was able to set up profiling for the maps. I will try to use the root map for resolving references.


Re: A solution to reuse content between two maps and keep the folder structure? Maybe profiling? #reuse

Vladimir Markiev
 

Thank you for the advice. Unfortunately, our version of Oxygen is 22.1 and it doesn't have that function.


Re: A solution to reuse content between two maps and keep the folder structure? Maybe profiling? #reuse

Arthur PROVENIER
 

Hi,

 

I’m not sure about it but in Oxygen there is a concept called “root map” : https://www.oxygenxml.com/doc/versions/23.1/ug-author/topics/root-map.html?hl=root%2Cmap

Specifying the correct root map helps to prevent validation problems when you work with keyrefs and also acts as the foundation for content completion.

 

Arthur

 


Re: A solution to reuse content between two maps and keep the folder structure? Maybe profiling? #reuse

Radu Coravu
 

Hi,

Only about this particular comment that you had:

Is there a way to put a new parent map to disk root and include my other two maps in it? Right now if I try, the maps are included, but only as non-editable references so I can't setup any reuse and can't set profiling attributes.
I assume you are editing the top level DITA Map in the Oxygen DITA Maps Manager view. By default the DITA Maps Manager allows editing only the content of the current opened DITA Map, if you want to edit submaps (for example set profiling attributes on their topicrefs) you need to open the separately in the DITA Maps Manager view. In Oxygen 23.0 we added in the Oxygen Preferences->"DITA / Maps" page a checkbox named "Allow referenced submaps to be edited". When checked it should allow you to make changes to submaps directly when the top level DITA Map is opened in the "DITA Maps Manager view".

Regards,

Radu

Radu Coravu
Oxygen XML Editor
On 3/29/21 12:01, grolribasi@... wrote:
Hello everyone! I am using Oxygen XML Author and I have two maps that have a lot of similar content. Right now, the content is not reused, but it would be great to make it reusable. The maps are called InstallGuide and AdminGuide they are stored on the disk with the following hierarchy:

disk root
..common
....InstallGuide.ditamap
..Product
....ProductFeatures
......MainProduct
........AdminGuide.ditamap

Is there a way to put a new parent map to disk root and include my other two maps in it? Right now if I try, the maps are included, but only as non-editable references so I can't setup any reuse and can't set profiling attributes.

Why do I need profiling?
Since the maps are two different documents I want to be able to profile them from the parent map. But I want to also be able to reuse content from one map to another. Moreover, I would want to keep the folder structure unchanged. Is that possible?

I can't get my head around the solution for my "wants". Maybe someone can propose a better way to achieve the goal, I would appreciate that. 


A solution to reuse content between two maps and keep the folder structure? Maybe profiling? #reuse

Vladimir Markiev
 

Hello everyone! I am using Oxygen XML Author and I have two maps that have a lot of similar content. Right now, the content is not reused, but it would be great to make it reusable. The maps are called InstallGuide and AdminGuide they are stored on the disk with the following hierarchy:

disk root
..common
....InstallGuide.ditamap
..Product
....ProductFeatures
......MainProduct
........AdminGuide.ditamap

Is there a way to put a new parent map to disk root and include my other two maps in it? Right now if I try, the maps are included, but only as non-editable references so I can't setup any reuse and can't set profiling attributes.

Why do I need profiling?
Since the maps are two different documents I want to be able to profile them from the parent map. But I want to also be able to reuse content from one map to another. Moreover, I would want to keep the folder structure unchanged. Is that possible?

I can't get my head around the solution for my "wants". Maybe someone can propose a better way to achieve the goal, I would appreciate that. 

101 - 120 of 46224