Re: [oXygen-user] Struggling with conkeyref/conaction=pushafter

2023-03-27 Thread Oxygen XML Editor Support (Radu Coravu) 

Hi Frank,


Maybe this will help:

https://blog.oxygenxml.com/presentation-reuse/conref_push.html


One remark, Oxygen will not show the pushed content in place but 
publishing should work.



Regards,

Radu

Radu Coravu
Oxygen XML Editor

On 3/27/23 18:05, Frank Dissinger wrote:


Hi all,


I have tested the "DITA > Push Current element" feature, but cannot 
get it to work.



I want to inject a  element into a shared topic which is used 
in two projects. The element to be injected is stored in a warehouse 
topic for project 1. What I want is to inject this element only when 
project 1 is built. When project 2 is built, the key to the warehouse 
topic resolves to a different file which doese not include the 
element. So what I hope is that the element is only injected when I 
build project 1 and that it is left out when I build project 2 -- 
without any error or warning generated in the log file or in Oxygen's 
editor window.



However, the element does not appear in project 1 and in Oxygen it is 
shown as an empty  struture. In a previous attempt the element 
was shown in the editor window, but not in output either. I can't 
remember what I did differently...



I may not have undestood this feature correctly. Can someone enlighten 
me? Thank you.



Regards,

Frank


The dita code:

*
*

*file.dita*

    
  
  
    
  
    
    
  A term. The term in lib_ref.dita should be injected 
after that.

  
    Explanation
  
    


*lib_ref.dita
*

  
    
  The term to inject after the term in file.dita
  
    Explanation
  
    
  


*variables.ditamap*
    

Appearance in oXygen.
--

*Frank Dissinger*

Documentation Manager



*CGS Publishing Technologies International GmbH*

*Email *frank.dissin...@cgs-oris.com | *Web* www.cgs-oris.com 



*Address* Kettelerstr. 24 | D-63512 Hainburg | Germany

*Phone* +49 6182 9626-27 | *Fax* +49 6182 9626-99

*Commercial register* Offenbach, HRB no. 21495

*Managing directors* Bernd Rückert, Christoph Thommessen


https://www.cgs-oris.com/Signatur.png 

___
oXygen-user mailing list
oXygen-user@oxygenxml.com
https://www.oxygenxml.com/mailman/listinfo/oxygen-user
___
oXygen-user mailing list
oXygen-user@oxygenxml.com
https://www.oxygenxml.com/mailman/listinfo/oxygen-user

[oXygen-user] Struggling with conkeyref/conaction=pushafter

2023-03-27 Thread Frank Dissinger 

Hi all,


I have tested the "DITA > Push Current element" feature, but cannot get 
it to work.



I want to inject a  element into a shared topic which is used 
in two projects. The element to be injected is stored in a warehouse 
topic for project 1. What I want is to inject this element only when 
project 1 is built. When project 2 is built, the key to the warehouse 
topic resolves to a different file which doese not include the element. 
So what I hope is that the element is only injected when I build project 
1 and that it is left out when I build project 2 -- without any error or 
warning generated in the log file or in Oxygen's editor window.



However, the element does not appear in project 1 and in Oxygen it is 
shown as an empty  struture. In a previous attempt the element 
was shown in the editor window, but not in output either. I can't 
remember what I did differently...



I may not have undestood this feature correctly. Can someone enlighten 
me? Thank you.



Regards,

Frank


The dita code:

*
*

*file.dita*

    
  
  
    
  
    
    
  A term. The term in lib_ref.dita should be injected after 
that.

  
    Explanation
  
    


*lib_ref.dita
*

  
    
  The term to inject after the term in file.dita
  
    Explanation
  
    
  


*variables.ditamap*
    

Appearance in oXygen.
--

*Frank Dissinger*

Documentation Manager



*CGS Publishing Technologies International GmbH*

*Email *frank.dissin...@cgs-oris.com | *Web* www.cgs-oris.com 



*Address* Kettelerstr. 24 | D-63512 Hainburg | Germany

*Phone* +49 6182 9626-27 | *Fax* +49 6182 9626-99

*Commercial register* Offenbach, HRB no. 21495

*Managing directors* Bernd Rückert, Christoph Thommessen


https://www.cgs-oris.com/Signatur.png ___
oXygen-user mailing list
oXygen-user@oxygenxml.com
https://www.oxygenxml.com/mailman/listinfo/oxygen-user

Re: [oXygen-user] IDs for new DITA topics

2023-03-27 Thread Oxygen XML Editor Support (Radu Coravu) 

Hello Frank,


Please see some answers below:


I understand that a topic ID must be unique within the scope of the 
root ditamap used for publishing the content. 
Your understanding is incorrect, the topic ID must be unique inside the 
same topic file. So for example if in the "topic.dita" you have two 
inner topics, all topics existing inside the "topic.dita" must not have 
duplicate IDs. But if you have "topic1.dita" and "topic2.dita", the 
 elements in both files can have the same ID, the DITA standard 
does not impose a uniqueness restriction for the topic IDs in the 
context of the entire project.



DITA 1.3 specs:

https://www.oxygenxml.com/dita/1.3/specs/archSpec/base/uri-based-addressing.html


This addressing model makes it possible to reliably address elements 
that have values for the |@id| attribute that are unique within a 
single DITA topic, but which might not be unique within a larger XML 
document that contains multiple DITA topics.


But it is true that Oxygen and other tools attempt to create by default 
unique IDs for a created topic file in the context of the entire 
project, some CMSs may need them, sometimes the publishing (for example 
Oxygen's DITA to WebHelp output) may use these unique IDs for certain 
features.



So there is an arbitrary combination of only 9 characters, mostly 
letters. But perhaps sufficient for ensuring uniqueness...
Indeed the ${id} ID value we generate has about 9-10 unique letter-digit 
combinations. We consider this to be enough. The number of unique 
combinations is about 36 (26 letters in the English alphabet + 10 
digits) to the power 9, it's 1 followed by about 14 digits. We consider 
this to be enough for a value which is not intended to be unique by the 
DITA specification anyway.


By the way we also have a longer "${uuid}" editor variable which can be 
used and expanded, a unique sequence of 32 hexadecimal digits if you 
want something even more unique.


https://www.oxygenxml.com/doc/versions/25.1/ug-editor/topics/editor-variables.html


However, when I use the "DITA > Insert > Insert New DITA Resource" 
command, oXygen does not honor the "ID Option" setting, but creates 
IDs which are identical to the file name. 
Usually an ID derived from the title or from the file name is more user 
friendly when for example inserting references to elements inside a topic.


We would do the same by default when using the "File->New" wizard dialog 
to create the topic but the topic is not yet saved on disk so we do not 
yet know its file name or its title so we use the random value instead.



In the Oxygen Preferences->"DITA / Topics" page there is an "Use the 
filename as the value.. of the root element id" which you can uncheck if 
you want.



Regards,

Radu

Radu Coravu
Oxygen XML Editor

On 3/27/23 11:43, Frank Dissinger wrote:


Hi all,


I understand that a topic ID must be unique within the scope of the 
root ditamap used for publishing the content.



FrameMaker, which I used previously, creates IDs of the type


id172OC0C03J7


So there is an arbitrary combination of 11 digits and letters.


In oXygen I have set the "DITA > ID Option" as follows:


${localName}_${id}


Which creates IDs of the following type:


task_rf2_vcg_ywb


So there is an arbitrary combination of only 9 characters, mostly 
letters. But perhaps sufficient for ensuring uniqueness...



However, when I use the "DITA > Insert > Insert New DITA Resource" 
command, oXygen does not honor the "ID Option" setting, but creates 
IDs which are identical to the file name.


This is not what I want and surely not suitable for ensuring uniqueness.


How can I get oXygen to honor the "ID Option" setting or make it 
otherwise generate IDs with arbitrary characters which are likely to 
be unique?



Regards,

Frank

--

*Frank Dissinger*

Documentation Manager



*CGS Publishing Technologies International GmbH*

*Email *frank.dissin...@cgs-oris.com | *Web* www.cgs-oris.com 



*Address* Kettelerstr. 24 | D-63512 Hainburg | Germany

*Phone* +49 6182 9626-27 | *Fax* +49 6182 9626-99

*Commercial register* Offenbach, HRB no. 21495

*Managing directors* Bernd Rückert, Christoph Thommessen


https://www.cgs-oris.com/Signatur.png 

___
oXygen-user mailing list
oXygen-user@oxygenxml.com
https://www.oxygenxml.com/mailman/listinfo/oxygen-user
___
oXygen-user mailing list
oXygen-user@oxygenxml.com
https://www.oxygenxml.com/mailman/listinfo/oxygen-user

[oXygen-user] IDs for new DITA topics

2023-03-27 Thread Frank Dissinger 
I would like to add that I have defined topic templates in my custom 
framework in which I have used the same setting which I used for "DITA > 
ID Option". For example:




"generalTask.dtd">



    xxxTITLExxx
    xxxSHORTDESCRIPTIONxxx
    
    
        
            xxxFIRST_STEPxxx
        
    
    




Am 27.03.2023 um 10:43 schrieb Frank Dissinger:


Hi all,


I understand that a topic ID must be unique within the scope of the 
root ditamap used for publishing the content.



FrameMaker, which I used previously, creates IDs of the type


id172OC0C03J7


So there is an arbitrary combination of 11 digits and letters.


In oXygen I have set the "DITA > ID Option" as follows:


${localName}_${id}


Which creates IDs of the following type:


task_rf2_vcg_ywb


So there is an arbitrary combination of only 9 characters, mostly 
letters. But perhaps sufficient for ensuring uniqueness...



However, when I use the "DITA > Insert > Insert New DITA Resource" 
command, oXygen does not honor the "ID Option" setting, but creates 
IDs which are identical to the file name.


This is not what I want and surely not suitable for ensuring uniqueness.


How can I get oXygen to honor the "ID Option" setting or make it 
otherwise generate IDs with arbitrary characters which are likely to 
be unique?



Regards,

Frank

--

*Frank Dissinger*

Documentation Manager



*CGS Publishing Technologies International GmbH*

*Email *frank.dissin...@cgs-oris.com | *Web* www.cgs-oris.com 



*Address* Kettelerstr. 24 | D-63512 Hainburg | Germany

*Phone* +49 6182 9626-27 | *Fax* +49 6182 9626-99

*Commercial register* Offenbach, HRB no. 21495

*Managing directors* Bernd Rückert, Christoph Thommessen


https://www.cgs-oris.com/Signatur.png 

--

*Frank Dissinger*

Documentation Manager



*CGS Publishing Technologies International GmbH*

*Email *frank.dissin...@cgs-oris.com | *Web* www.cgs-oris.com 



*Address* Kettelerstr. 24 | D-63512 Hainburg | Germany

*Phone* +49 6182 9626-27 | *Fax* +49 6182 9626-99

*Commercial register* Offenbach, HRB no. 21495

*Managing directors* Bernd Rückert, Christoph Thommessen


https://www.cgs-oris.com/Signatur.png ___
oXygen-user mailing list
oXygen-user@oxygenxml.com
https://www.oxygenxml.com/mailman/listinfo/oxygen-user

[oXygen-user] IDs for new DITA topics

2023-03-27 Thread Frank Dissinger 

Hi all,


I understand that a topic ID must be unique within the scope of the root 
ditamap used for publishing the content.



FrameMaker, which I used previously, creates IDs of the type


id172OC0C03J7


So there is an arbitrary combination of 11 digits and letters.


In oXygen I have set the "DITA > ID Option" as follows:


${localName}_${id}


Which creates IDs of the following type:


task_rf2_vcg_ywb


So there is an arbitrary combination of only 9 characters, mostly 
letters. But perhaps sufficient for ensuring uniqueness...



However, when I use the "DITA > Insert > Insert New DITA Resource" 
command, oXygen does not honor the "ID Option" setting, but creates IDs 
which are identical to the file name.


This is not what I want and surely not suitable for ensuring uniqueness.


How can I get oXygen to honor the "ID Option" setting or make it 
otherwise generate IDs with arbitrary characters which are likely to be 
unique?



Regards,

Frank

--

*Frank Dissinger*

Documentation Manager



*CGS Publishing Technologies International GmbH*

*Email *frank.dissin...@cgs-oris.com | *Web* www.cgs-oris.com 



*Address* Kettelerstr. 24 | D-63512 Hainburg | Germany

*Phone* +49 6182 9626-27 | *Fax* +49 6182 9626-99

*Commercial register* Offenbach, HRB no. 21495

*Managing directors* Bernd Rückert, Christoph Thommessen


https://www.cgs-oris.com/Signatur.png ___
oXygen-user mailing list
oXygen-user@oxygenxml.com
https://www.oxygenxml.com/mailman/listinfo/oxygen-user