Assign Numeric ID for Help Topics in OxygenXML
Post here questions and problems related to editing and publishing DITA content.
Assign Numeric ID for Help Topics in OxygenXML
Trying to create CHM file using DITA file. Now I need to assign/map a numeric ID like 12345 to a DITA file. So that I can use that ID to display that specific topic.
it will be Helpfull if I get some clues
it will be Helpfull if I get some clues
Re: Assign Numeric ID for Help Topics in OxygenXML
Hi,
I will describe how we do this for the Oxygen User's Guide.
So in the Oxygen XML Editor installation folder we have a "help.exe" and a "help.chm" containing the entire Oxygen user's manual in CHM format.
When somebody presses F1 in the application we run a command line like this:
That "9999" needs to be some unique identifier specific to your application which will remain constant.
And the "topics\lock-handler-factory.html" is a reference to the HTML file inside the CHM file.
Regards,
Radu
I will describe how we do this for the Oxygen User's Guide.
So in the Oxygen XML Editor installation folder we have a "help.exe" and a "help.chm" containing the entire Oxygen user's manual in CHM format.
When somebody presses F1 in the application we run a command line like this:
Code: Select all
help.exe 9999 D:\path\to\OXYGEN_INSTALL_DIR\help.chm topics\lock-handler-factory.html
And the "topics\lock-handler-factory.html" is a reference to the HTML file inside the CHM file.
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
Re: Assign Numeric ID for Help Topics in OxygenXML
Hi,
DITA topics allow the use of a <resourceid> element, something like this:
Regards,
Radu
DITA topics allow the use of a <resourceid> element, something like this:
Code: Select all
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic id="introduction">
<title>...</title>
<prolog>
<resourceid appid="1000"/>
</prolog>
<body>
<p>....</p>
</body>
</topic>
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
Re: Assign Numeric ID for Help Topics in OxygenXML
Thank you for your prompt reply Radu.
as per my understanding , 9999 is the application ID which will remain constant for all the topics
help.exe 9999 D:\path\to\OXYGEN_INSTALL_DIR\help.chm topics\lock-handler-factory.html
Now my requirement is I need to pass number instead of topic itself "topics\lock-handler-factory.html". Is there any way to do that?
as per my understanding , 9999 is the application ID which will remain constant for all the topics
help.exe 9999 D:\path\to\OXYGEN_INSTALL_DIR\help.chm topics\lock-handler-factory.html
Now my requirement is I need to pass number instead of topic itself "topics\lock-handler-factory.html". Is there any way to do that?
Re: Assign Numeric ID for Help Topics in OxygenXML
Hi,
Regards,
Radu
Yes, from what I remember in order to keep the same help dialog window opened when you invoke the help.exe multiple times you need to pass the same application ID to it.as per my understanding , 9999 is the application ID which will remain constant for all the topics
help.exe 9999 D:\path\to\OXYGEN_INSTALL_DIR\help.chm topics\lock-handler-factory.html
You probably need to create your own script in whatever programming language you are comfortable with which goes through all the DITA topics in the project and creates for example a ".properties" file mapping resource IDs to HTML topic paths. Then when you need to display a particular resource ID, you first go through the ".properties" file to find out the HTML location of the topic inside the CHM and then invoke help.exe with the HTML file location.Now my requirement is I need to pass number instead of topic itself "topics\lock-handler-factory.html". Is there any way to do that?
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
Re: Assign Numeric ID for Help Topics in OxygenXML
Will the alias.h and context.h help to achieve the following requirement
I need to assign map id to a topic . say 66571
After I generated CHM file (say toc.chm) I will VC++ api to call CHM file and pass the ID 66571, then it should directly open that page.
if so where I should keep these files. because when I generate CHM file oxygenxml is creating .hhp , .hhc and .hhk files
what should be the format of the files to map ID to a topic
I need to assign map id to a topic . say 66571
After I generated CHM file (say toc.chm) I will VC++ api to call CHM file and pass the ID 66571, then it should directly open that page.
if so where I should keep these files. because when I generate CHM file oxygenxml is creating .hhp , .hhc and .hhk files
what should be the format of the files to map ID to a topic
Re: Assign Numeric ID for Help Topics in OxygenXML
Hi,
About the custom file mapping IDs to HTML file paths, you can define your own format, for example you can try to write it using the ".properties" file format:
https://en.wikipedia.org/wiki/.properties
and place the properties file next to the CHM.
Then you can try to load it in the C code to obtain the mappings, then use the mappings to start the help process.
Regards,
Radu
About the custom file mapping IDs to HTML file paths, you can define your own format, for example you can try to write it using the ".properties" file format:
https://en.wikipedia.org/wiki/.properties
and place the properties file next to the CHM.
Then you can try to load it in the C code to obtain the mappings, then use the mappings to start the help process.
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
Re: Assign Numeric ID for Help Topics in OxygenXML
Hi,
You probably need to write some custom code to parse the DITA topics and produce the ".properties" file, we do not have code to provide you with.
Regards,
Radu
You probably need to write some custom code to parse the DITA topics and produce the ".properties" file, we do not have code to provide you with.
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
Re: Assign Numeric ID for Help Topics in OxygenXML
HI Radu
Thank you for your prompt reply
One General question , is that really possible to embed the ID to a Help Topic as we do in RoboHelp.
After generating CHM it is not possible to assign as per my understanding. Moreover parsing the CHM to generate mapping file using C code is literally involves more steps.
As per all our conversation usign OxygenXML we will be not able to assign numeric IDs.
Thank you for your prompt reply
One General question , is that really possible to embed the ID to a Help Topic as we do in RoboHelp.
After generating CHM it is not possible to assign as per my understanding. Moreover parsing the CHM to generate mapping file using C code is literally involves more steps.
As per all our conversation usign OxygenXML we will be not able to assign numeric IDs.
Re: Assign Numeric ID for Help Topics in OxygenXML
Hi,
We do not have out of the box support for what you want, a customization could me custom made (for example by a third party or a consultant) to achieve your objectives.
Regards,
Radu
We do not have out of the box support for what you want, a customization could me custom made (for example by a third party or a consultant) to achieve your objectives.
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
Re: Assign Numeric ID for Help Topics in OxygenXML
Hi,
If you are willing to hire a third party consultant to create such a customization, you can either drop us an email (support@oxygenxml.com) and we can try to propose to you some consultants or you could register on the DITA Users List and ask there is there are others who have created such customizations and are willing to help with this: https://dita-users.groups.io/g/main
Regards,
Radu
If you are willing to hire a third party consultant to create such a customization, you can either drop us an email (support@oxygenxml.com) and we can try to propose to you some consultants or you could register on the DITA Users List and ask there is there are others who have created such customizations and are willing to help with this: https://dita-users.groups.io/g/main
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
Re: Assign Numeric ID for Help Topics in OxygenXML
Thank you for all your support.
As of now unable to find any group who has done this before. Kindly requesting your help to find the group
Also support@oxygenxml provided two consultants. acolad and mekon. Taking help from them is chargeable ?
If they have done this work before then , that feature or enhancement is not merged or incorporated in oxygenXml ?
As of now unable to find any group who has done this before. Kindly requesting your help to find the group
Also support@oxygenxml provided two consultants. acolad and mekon. Taking help from them is chargeable ?
If they have done this work before then , that feature or enhancement is not merged or incorporated in oxygenXml ?
Re: Assign Numeric ID for Help Topics in OxygenXML
Hi,
Regards,
Radu
Yes, custom work is negotiated and charged separately.Also support@oxygenxml provided two consultants. acolad and mekon. Taking help from them is chargeable ?
I do not understand the question, these companies perform customizations specific for certain companies, these customizations are installed and used by you, they do not become part of Oxygen's default publishing process bundled with an Oxygen installation kit.If they have done this work before then , that feature or enhancement is not merged or incorporated in oxygenXml ?
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
Return to “DITA (Editing and Publishing DITA Content)”
Jump to
- Oxygen XML Editor/Author/Developer
- ↳ Feature Request
- ↳ Common Problems
- ↳ DITA (Editing and Publishing DITA Content)
- ↳ SDK-API, Frameworks - Document Types
- ↳ DocBook
- ↳ TEI
- ↳ XHTML
- ↳ Other Issues
- Oxygen XML Web Author
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Content Fusion
- ↳ Feature Request
- ↳ Common Problems
- Oxygen JSON Editor
- ↳ Feature Request
- ↳ Common Problems
- Oxygen PDF Chemistry
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Feedback
- ↳ Feature Request
- ↳ Common Problems
- Oxygen XML WebHelp
- ↳ Feature Request
- ↳ Common Problems
- XML
- ↳ General XML Questions
- ↳ XSLT and FOP
- ↳ XML Schemas
- ↳ XQuery
- NVDL
- ↳ General NVDL Issues
- ↳ oNVDL Related Issues
- XML Services Market
- ↳ Offer a Service