PDFs Not Launching Correctly from WebHelp
Posted: Thu Apr 25, 2013 3:05 am
Hi.
As I mentioned in previous threads, we recently upgraded from Oxygen Author 13.2 to 14.2, and have experienced some issues with the new WebHelp format that are affecting our users. The latest is related to opening PDFs from hyperlinks in WebHelp. They are not opening in a new tab, or they are not opening at all. Please see below for test cases.
Questions:
1) Is there a fix for this issue so that PDFs open in a new tab in WebHelp?
2) Is there a setting in Oxygen Author that would force PDFs to open in a new tab from WebHelp?
Test Case 1:
Demonstrate the current issue:
1) Open the latest version of our Documentation Library, created with Author 14.2 WebHelp.
2) In the topic AgilePoint Documentation Library, in the PDF column of the table, click v5.0 SP4 Release Notes.
Observed result A: In some browsers, the PDF opens in the content (right) pane.
Observed result B: In some browsers, the PDF does not open. Instead, the content (right) pane shows a blank white page.
Expected result: The PDF opens in a new tab.
DITA Markup for this link and all other PDF links on this page:
3) Click the Back button on the browser to return to the AgilePoint Documentation Library page.
4) In the PDF column of the table, click v5.0 SP3 Universal Edition Release Notes.
Observed result: The PDF does not open. Instead, the content (right) pane shows a blank white page.
Expected result: The PDF opens in a new tab.
Test Case 2:
Compare the results of Test Case 1 to an older version of our Documentation Library using WebHelp generated from Author 13.2:
1) Open an older version of our Documentation Library, created with Author 13.2 WebHelp.
2) In the topic AgilePoint Documentation Library, in the PDF column of the table, click v5.0 SP4 Release Notes.
Observed result: The PDF opens in a new tab.
3) Return to the tab with the AgilePoint Documentation Library page.
4) In the PDF column of the table, click v5.0 SP3 Universal Edition Release Notes.
Observed result: The PDF opens in a new tab.
Test Case 3:
Demonstrate this issue seems to only be occurring with links to PDFs, not external web pages:
1) Open this topic, created with Author 14.2 WebHelp.
2) In the topic Why Does an "Input String" Error Occur During Envision Installation?, in the More Information section, click the URL http://www.mydigitallife.info/how-to-di ... windows-7/.
Observed result: The external web page opens in a new tab.
DITA Markup for this link:
As I mentioned in previous threads, we recently upgraded from Oxygen Author 13.2 to 14.2, and have experienced some issues with the new WebHelp format that are affecting our users. The latest is related to opening PDFs from hyperlinks in WebHelp. They are not opening in a new tab, or they are not opening at all. Please see below for test cases.
Questions:
1) Is there a fix for this issue so that PDFs open in a new tab in WebHelp?
2) Is there a setting in Oxygen Author that would force PDFs to open in a new tab from WebHelp?
Test Case 1:
Demonstrate the current issue:
1) Open the latest version of our Documentation Library, created with Author 14.2 WebHelp.
2) In the topic AgilePoint Documentation Library, in the PDF column of the table, click v5.0 SP4 Release Notes.
Observed result A: In some browsers, the PDF opens in the content (right) pane.
Observed result B: In some browsers, the PDF does not open. Instead, the content (right) pane shows a blank white page.
Expected result: The PDF opens in a new tab.
DITA Markup for this link and all other PDF links on this page:
Code: Select all
<xref href="AgilePoint_ReleaseNotes_5_0_SP_4.pdf" scope="external" format="html">v5.0 SP4 Release Notes</xref>
4) In the PDF column of the table, click v5.0 SP3 Universal Edition Release Notes.
Observed result: The PDF does not open. Instead, the content (right) pane shows a blank white page.
Expected result: The PDF opens in a new tab.
Test Case 2:
Compare the results of Test Case 1 to an older version of our Documentation Library using WebHelp generated from Author 13.2:
1) Open an older version of our Documentation Library, created with Author 13.2 WebHelp.
2) In the topic AgilePoint Documentation Library, in the PDF column of the table, click v5.0 SP4 Release Notes.
Observed result: The PDF opens in a new tab.
3) Return to the tab with the AgilePoint Documentation Library page.
4) In the PDF column of the table, click v5.0 SP3 Universal Edition Release Notes.
Observed result: The PDF opens in a new tab.
Test Case 3:
Demonstrate this issue seems to only be occurring with links to PDFs, not external web pages:
1) Open this topic, created with Author 14.2 WebHelp.
2) In the topic Why Does an "Input String" Error Occur During Envision Installation?, in the More Information section, click the URL http://www.mydigitallife.info/how-to-di ... windows-7/.
Observed result: The external web page opens in a new tab.
DITA Markup for this link:
Code: Select all
<xref href="http://www.mydigitallife.info/how-to-disable-and-turn-off-uac-in-windows-7/" format="html" scope="external">http://www.mydigitallife.info/how-to-disable-and-turn-off-uac-in-windows-7/</xref>