Search excludes file not being picked up by DITA-to-webhelp transform
Post here questions and problems related to editing and publishing DITA content.
-
- Posts: 2
- Joined: Fri Jul 22, 2016 12:04 am
Search excludes file not being picked up by DITA-to-webhelp transform
Versions: oXygen XML Editor 17.1 and 18.1
I've set up an excludes list and followed the steps listed in Bogdan's reply here: topic14623.html However, the resulting webhelp search continues to show results that are excluded in my list.
This is the content of my list, which is in the top level of my project:
deployment/common/architecture_ha.html
deployment/common/config_load_balancer.html
deployment/common/deploy_atscale_ha_cluster_gbq.html
deployment/common/deploy_atscale_ha_cluster.html
deployment/common/deploy_single_instance_gbq.html
deployment/common/deploy_single_instance.html
deployment/common/install_rpm_package_ha.html
deployment/common/install_tar_package_ha.html
deployment/common/requirements_clusters.html
Is there a bug in 17.1 and in 18.1 that prevents the exclude list from being used in the transform?
I've set up an excludes list and followed the steps listed in Bogdan's reply here: topic14623.html However, the resulting webhelp search continues to show results that are excluded in my list.
This is the content of my list, which is in the top level of my project:
deployment/common/architecture_ha.html
deployment/common/config_load_balancer.html
deployment/common/deploy_atscale_ha_cluster_gbq.html
deployment/common/deploy_atscale_ha_cluster.html
deployment/common/deploy_single_instance_gbq.html
deployment/common/deploy_single_instance.html
deployment/common/install_rpm_package_ha.html
deployment/common/install_tar_package_ha.html
deployment/common/requirements_clusters.html
Is there a bug in 17.1 and in 18.1 that prevents the exclude list from being used in the transform?
-
- Posts: 846
- Joined: Mon Dec 05, 2011 6:04 pm
Re: Search excludes file not being picked up by DITA-to-webhelp transform
Hi rheath,
Please note that the "webhelp.search.custom.excludes.file" parameter was made available for the oXygen WebHelp scenarios starting with version 18.1.
There was no such parameter in oXygen XML v17.1.
I've just tested in the latest maintenance build of oXygen XML Editor v18.1 (build 2017020917) the behavior of both DITA Map > WebHelp Classic and DITA Map > WebHelp Responsive transformation scenarios, when the "webhelp.search.custom.excludes.file" parameter is set and points to a .properties file containing the name patterns for the HTML files which should not be indexed.
For both scenarios, the files defined in the excludes.properties file I've created were ignored from the resulted WebHelp search.
From your .properties file contents, I noticed that all the HTML files you need to be omitted from indexing seem to be located inside the
"deployment/common/" folder.
Could you please make sure that all those htmls are directly in the "common" folder and not in other child folders of either the "deployment" or the "common" folders?
In case they are located inside another folder hierarchy, please make sure you use wildcards to define the path name patterns. You can find examples of using wildcards HERE.
If all HTML files from the list in your .properies file are located in the "/common" folder, another possible cause which could interfere with the exclusion parameter functionality would be if you are using a custom (external) DITA-OT in oXygen v18.1, not the default DITA-OT 2.x that comes bundled with oXygen, or if you upgraded from an older version but kept the DITA-OT from that older version.
In order to avoid this, you should download and install a fresh copy of oXygen XML Editor v18.1 from the software archive in a separate folder and retry the procedure steps.
Let me know if this helps or if you need additional assistance.
Regards,
Costin
Please note that the "webhelp.search.custom.excludes.file" parameter was made available for the oXygen WebHelp scenarios starting with version 18.1.
There was no such parameter in oXygen XML v17.1.
I've just tested in the latest maintenance build of oXygen XML Editor v18.1 (build 2017020917) the behavior of both DITA Map > WebHelp Classic and DITA Map > WebHelp Responsive transformation scenarios, when the "webhelp.search.custom.excludes.file" parameter is set and points to a .properties file containing the name patterns for the HTML files which should not be indexed.
For both scenarios, the files defined in the excludes.properties file I've created were ignored from the resulted WebHelp search.
From your .properties file contents, I noticed that all the HTML files you need to be omitted from indexing seem to be located inside the
"deployment/common/" folder.
Could you please make sure that all those htmls are directly in the "common" folder and not in other child folders of either the "deployment" or the "common" folders?
In case they are located inside another folder hierarchy, please make sure you use wildcards to define the path name patterns. You can find examples of using wildcards HERE.
If all HTML files from the list in your .properies file are located in the "/common" folder, another possible cause which could interfere with the exclusion parameter functionality would be if you are using a custom (external) DITA-OT in oXygen v18.1, not the default DITA-OT 2.x that comes bundled with oXygen, or if you upgraded from an older version but kept the DITA-OT from that older version.
In order to avoid this, you should download and install a fresh copy of oXygen XML Editor v18.1 from the software archive in a separate folder and retry the procedure steps.
Let me know if this helps or if you need additional assistance.
Regards,
Costin
Costin Sandoi
oXygen XML Editor and Author Support
oXygen XML Editor and Author Support
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)
- ↳ Artificial Intelligence (AI Positron Assistant add-on)
- ↳ 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