Hi Imesh, Dakshika and Nisrin,

Thanks for all your feedback and help!

*@Dakshika* - I tried the script but it did not work, because when I used
it all the links were opening in the same page.

*@Imesh -* Thanks for the info!

*@Nisrin* - When a user is new to docs, they will tend to always click on a
link as opposed to right-clicking on a link. Furthermore, I was going on
the assumption that they will close a link after they are done with a
certain set of steps (but I guess it will not always be the case).

As a workaround, I added an "expand macro" and pulled the child content
into the expand macro using the "Include Page" macro, so that the user will
not have to see a ton of instructions all at once.


Regards,
Mariangela


*Mariangela Hills*
Senior Technical Writer - WSO2, Inc. http://wso2.com
Committer and PMC member - Apache Stratos
email:[email protected] | mobile: +94 773 500185

On Thu, Oct 22, 2015 at 8:14 AM, Nisrin Sheriff <[email protected]> wrote:

> Hi Mari,
>
> Wouldn't this result in too many tabs opening up as there will be a new
> tab opening whenever a users clicks on a link.
>
> With how it is now, if a user wants to view the linked section in a new
> tab, they can always right click and then click *Open Link in New Tab*/*Open
> Link in New Window* right.
>
> So do you think we really need this?
>
> Thank you.
>
> Best Regards,
> Nisrin
>
> Nisrin Sheriff
> Senior Technical Writer
>
> *WSO2, Inc.*lean.enterprise.middleware.
> mobile: +94 776 24 84 56
> http://wso2.com
>
> On Thu, Oct 22, 2015 at 7:42 AM, Dakshika Jayathilaka <[email protected]>
> wrote:
>
>> Hi Mari,
>>
>> I have notice that you are using target="_blank" for internal page links
>> as wel. remove that attribute from links to navigate within page.
>>
>> <a
>> href="#Mainpagewithinstructions-Step2-SetuptheWSO2ComplexEventProcessor(CEP)"
>> *target="_blank"*>Step 2 - Setup the WSO2 Complex Event Processor
>> (CEP)</a>
>>
>> *Dakshika Jayathilaka*
>> PMC Member & Committer of Apache Stratos
>> Senior Software Engineer
>> WSO2, Inc.
>> lean.enterprise.middleware
>> 0771100911
>>
>> On Thu, Oct 22, 2015 at 7:10 AM, Dakshika Jayathilaka <[email protected]>
>> wrote:
>>
>>> Hi All,
>>>
>>> IMO open a webpage in new tab or page is recommended depending on your
>>> use case. AFAIK giving a pop up link will block by browser due to security
>>> reason.
>>>
>>> So what you can do is, append simple class to "a"(anchor) to prevent all
>>> links opening in new page.
>>> Use below code snippet  for Pages that you want to open in new page or
>>> tab.
>>>
>>> for HTML link:
>>>
>>> <a href="external_link" class="new-page" > this is an external link </a>
>>>
>>> for other links
>>>
>>> <a href="normal-page">default </a>
>>>
>>> Script:
>>>
>>> <script>
>>> jQuery(document).ready(function() {
>>>     jQuery(".wiki-content a.new-page").attr("target", "_blank");
>>> });
>>> </script>
>>>
>>> Thank you,
>>>
>>> Regards,
>>> *Dakshika Jayathilaka*
>>> PMC Member & Committer of Apache Stratos
>>> Senior Software Engineer
>>> WSO2, Inc.
>>> lean.enterprise.middleware
>>> 0771100911
>>>
>>> On Thu, Oct 22, 2015 at 7:02 AM, Imesh Gunaratne <[email protected]> wrote:
>>>
>>>> Hi Mari,
>>>>
>>>> Opening a new tab or a new browser window is not recommended. Most of
>>>> the browsers block this by default due to security reasons. May be we need
>>>> to think of a different approach.
>>>>
>>>> Thanks
>>>>
>>>> On Thu, Oct 22, 2015 at 6:38 AM, Mariangela Hills <[email protected]>
>>>> wrote:
>>>>
>>>>> Hi,
>>>>>
>>>>> When working with the Wiki (Confluence) docs, there are times when we
>>>>> have to point off to sub-pages within a main set of instructions, so that
>>>>> the main page does not get too bulky. This means that when a user clicks
>>>>> these links, they will be redirected to those new pages within the same
>>>>> tab. Instead, it will be better if such links can be opened in a new
>>>>> tab/page, so that the user can always have the main set of instructions at
>>>>> hand.
>>>>>
>>>>> I found the following code block in [1], which needs to be added to a
>>>>> HTML macro, to open external links and internal links in a new page.
>>>>> However, the drawback when using this code block is that even the links in
>>>>> the table of contents open in a new window :(
>>>>>
>>>>> Will someone please be able to help by tweaking this code to stop
>>>>> links in the table of contents opening in a new page?
>>>>> Please note that I have created a set of sample pages in my wiki
>>>>> sandbox in [2], so that you can test the tweaked code if needed.
>>>>>
>>>>> <script>
>>>>> jQuery(document).ready(function() {
>>>>>     jQuery(".wiki-content a").attr("target", "_blank");
>>>>> });
>>>>> </script>
>>>>>
>>>>>
>>>>>
>>>>> [1]
>>>>> https://confluence.atlassian.com/display/CONFKB/How+to+force+links+to+open+in+a+new+window
>>>>> [2] https://docs.wso2.com/display/SM100/Main+page+with+instructions
>>>>>
>>>>>
>>>>> Regards,
>>>>> Mariangela
>>>>>
>>>>>
>>>>> *Mariangela Hills*
>>>>> Senior Technical Writer - WSO2, Inc. http://wso2.com
>>>>> Committer and PMC member - Apache Stratos
>>>>> email:[email protected] | mobile: +94 773 500185
>>>>>
>>>>
>>>>
>>>>
>>>> --
>>>> *Imesh Gunaratne*
>>>> Senior Technical Lead
>>>> WSO2 Inc: http://wso2.com
>>>> T: +94 11 214 5345 M: +94 77 374 2057
>>>> W: http://imesh.gunaratne.org
>>>> Lean . Enterprise . Middleware
>>>>
>>>>
>>>> _______________________________________________
>>>> Dev mailing list
>>>> [email protected]
>>>> http://wso2.org/cgi-bin/mailman/listinfo/dev
>>>>
>>>>
>>>
>>
>> _______________________________________________
>> Dev mailing list
>> [email protected]
>> http://wso2.org/cgi-bin/mailman/listinfo/dev
>>
>>
>
_______________________________________________
Dev mailing list
[email protected]
http://wso2.org/cgi-bin/mailman/listinfo/dev

Reply via email to