You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@royale.apache.org by Andrew Wetmore <co...@gmail.com> on 2018/01/26 12:43:11 UTC
Links to sites outside of help docs
Hi:
Peeling this into its own thread.
I looked at index.md and the syntax for popping a new tab does not seem to
work. See attached image, where the "target" instructions appear in the
visible text.
This discussion [1] proffers several solutions, including using just plain
HTML. I have tried that on create-an-application/migrate-an-existing-app/
migrate-from-flex.md. I don't know where to look to verify that that works;
could you check it?
a
[1]
https://stackoverflow.com/questions/4425198/can-i-create-links-with-target-blank-in-markdown
--
Andrew Wetmore
http://cottage14.blogspot.com/
Re: Links to sites outside of help docs
Posted by Alex Harui <ah...@adobe.com.INVALID>.
On 1/26/18, 11:31 AM, "Andrew Wetmore" <co...@gmail.com> wrote:
>Where do you suggest I put screenshots I want to share?
Most folks post the screenshot externally and put a link to it in the
email. You can try posting the screenshot at paste.apache.org, pastebin,
dropbox, etc.
>What I was
>concerned with is that, in the .md view I see
>
>... If you are looking for the API Reference, click
>here{:target='_blank'}.
Ah, ok. I had not looked there. When I was searching for the answer, I
discovered that not all Markdown converters support the {:target='blank'}
option, but Jekyll does. I just tested on the master branch where GitHub
Pages runs and it works there too, but it looks like whatever convert
GitHub uses on their site doesn't support it.
>
>I was not expecting to see the target information and, at that point, had
>not seen how the docs compile into HTML.
>
>So it looks like EITHER the method you suggested or the HTML method should
>work for links that pop a new tab.
I don't care which method we use. Theoretically, we'll make fewer
mistakes with Markdown. If you want to require everyone to use the same
technique, just pick one. Note that the Markdown technique is actually
generalized in the Jekyll we and GitHub pages are using. That syntax
really means that you can set any attribute on the converted HTML tag. So
apparently, you could do "{:style='background-color:red'} or even
{:class='someclass'} and load some CSS that affects that tag. But yes, it
will look funny in the GH view. Not sure if GH knows about it and plans
to fix it.
Thanks,
-Alex
>
>On Fri, Jan 26, 2018 at 1:16 PM, Alex Harui <ah...@adobe.com.invalid>
>wrote:
>
>> Hi Andrew,
>>
>> Attachments often get stripped by Apache mailing lists. Try using
>> paste.apache.org or pastebin and post a link. I'm confused by your
>> email. Links in a .md file won't pop a new window, but the result in
>>the
>> .html file after Jekyll processes it should have the right target. I
>>just
>> tried it on the CI server and it worked in Safari and I don't see the
>>word
>> target in the text.
>>
>>
>>https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fapacheroy
>>aleci.westus2.cloudapp.azure.com%3A8080%2Fjob%2F&data=02%7C01%7Caharui%40
>>adobe.com%7C5ee9085a985b4298437708d564f370f0%7Cfa7b1b5a7b34438794aed2c178
>>decee1%7C0%7C0%7C636525919093228589&sdata=xeujIhWdWU3WArJY2Hjap6Y1B15rR2v
>>4EZl7t5KR5DY%3D&reserved=0
>> RoyaleDocs_Staging/lastSuccessfulBuild/artifact/_site/index.html
>>
>> Let me know if you are seeing something different.
>>
>> -Alex
>>
>> From: Andrew Wetmore <co...@gmail.com>>
>> Reply-To: "dev@royale.apache.org<ma...@royale.apache.org>" <
>> dev@royale.apache.org<ma...@royale.apache.org>>
>> Date: Friday, January 26, 2018 at 4:43 AM
>> To: "dev@royale.apache.org<ma...@royale.apache.org>" <
>> dev@royale.apache.org<ma...@royale.apache.org>>
>> Subject: Links to sites outside of help docs
>>
>> Hi:
>>
>> Peeling this into its own thread.
>>
>> I looked at
>>index.md<https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2
>>Fna01.safelinks.protection.outlook&data=02%7C01%7Caharui%40adobe.com%7C5e
>>e9085a985b4298437708d564f370f0%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0
>>%7C636525919093228589&sdata=p7Hfsb9opz6coJ27N8mikxfsja7Wffn7gE5k0tlGFZw%3
>>D&reserved=0.
>> com/?url=http%3A%2F%2Findex.md&data=02%7C01%7Caharui%40adobe.com%
>> 7Cfb5aa0f028424680cc3c08d564ba60a2%7Cfa7b1b5a7b34438794aed2c178de
>> cee1%7C0%7C0%7C636525674012827775&sdata=gY%2Ff4lQJBqOUHE9oDBjTI9Q%2B%
>> 2FHcsk5kKtEblwbpTWZ0%3D&reserved=0> and the syntax for popping a new tab
>> does not seem to work. See attached image, where the "target"
>>instructions
>> appear in the visible text.
>>
>> This discussion [1] proffers several solutions, including using just
>>plain
>> HTML. I have tried that on
>>create-an-application/migrate-an-existing-app/
>>
>>migrate-from-flex.md<https://na01.safelinks.protection.outlook.com/?url=h
>>ttps%3A%2F%2Fna01.safelinks.protection.outlook&data=02%7C01%7Caharui%40ad
>>obe.com%7C5ee9085a985b4298437708d564f370f0%7Cfa7b1b5a7b34438794aed2c178de
>>cee1%7C0%7C0%7C636525919093228589&sdata=p7Hfsb9opz6coJ27N8mikxfsja7Wffn7g
>>E5k0tlGFZw%3D&reserved=0.
>> com/?url=http%3A%2F%2Fmigrate-from-flex.md&data=02%7C01%
>> 7Caharui%40adobe.com%7Cfb5aa0f028424680cc3c08d564ba60a2%
>> 7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636525674012827775&sdata=
>> o7OO7P%2Fwv7y9Wq8ZbAs8Eb7B8xX1waKjJPgRV6%2BMdjI%3D&reserved=0>. I don't
>> know where to look to verify that that works; could you check it?
>>
>> a
>>
>> [1]
>>https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fstackove
>>rflow.com%2Fquestions%2F4425198%2Fcan-i-&data=02%7C01%7Caharui%40adobe.co
>>m%7C5ee9085a985b4298437708d564f370f0%7Cfa7b1b5a7b34438794aed2c178decee1%7
>>C0%7C0%7C636525919093228589&sdata=6PKVyGOIaD0%2BLwFgC%2F1puQtDc%2B%2Fllg8
>>%2BSthsyvdALKo%3D&reserved=0
>> create-links-with-target-blank-in-markdown<https://
>> na01.safelinks.protection.outlook.com/?url=https%3A%2F%
>> 2Fstackoverflow.com%2Fquestions%2F4425198%2Fcan-i-
>> create-links-with-target-blank-in-markdown&data=02%
>> 7C01%7Caharui%40adobe.com%7Cfb5aa0f028424680cc3c08d564ba60a2%
>> 7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636525674012827775&sdata=
>> mmZxwnyxhHJfytKQy%2BIrJ%2FSM%2B8%2BewTG%2FaGonKB9fIC4%3D&reserved=0>
>>
>> --
>> Andrew Wetmore
>>
>>
>>https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fcottage14
>>.blogspot.com%2F&data=02%7C01%7Caharui%40adobe.com%7C5ee9085a985b42984377
>>08d564f370f0%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636525919093228
>>589&sdata=T6KozJWOEFPjkSMFbpP%2BoUbj9kvrQsfhh%2FcbszAKN5Y%3D&reserved=0<h
>>ttps://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fna01.safe
>>links&data=02%7C01%7Caharui%40adobe.com%7C5ee9085a985b4298437708d564f370f
>>0%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636525919093228589&sdata=d
>>pv1l4RAa%2F1nKN3gqdpo5PY%2FvMuu%2BVde3PX2hIVeABI%3D&reserved=0.
>> protection.outlook.com/?url=http%3A%2F%2Fcottage14.
>> blogspot.com%2F&data=02%7C01%7Caharui%40adobe.com%
>> 7Cfb5aa0f028424680cc3c08d564ba60a2%7Cfa7b1b5a7b34438794aed2c178de
>> cee1%7C0%7C0%7C636525674012827775&sdata=hqTw9WWdtUpLzMTqGph83lb2nQyyxZ
>> 8d40Rx3b3qE64%3D&reserved=0>
>>
>>
>>
>>
>>
>
>
>--
>Andrew Wetmore
>
>https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fcottage14.
>blogspot.com%2F&data=02%7C01%7Caharui%40adobe.com%7C5ee9085a985b4298437708
>d564f370f0%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636525919093228589
>&sdata=T6KozJWOEFPjkSMFbpP%2BoUbj9kvrQsfhh%2FcbszAKN5Y%3D&reserved=0
Re: Links to sites outside of help docs
Posted by Andrew Wetmore <co...@gmail.com>.
Where do you suggest I put screenshots I want to share? What I was
concerned with is that, in the .md view I see
... If you are looking for the API Reference, click here
<http://apacheroyaleci.westus2.cloudapp.azure.com:8080/job/Royale_ASDoc_Example/lastSuccessfulBuild/artifact/examples/royale/ASDoc/bin/js-debug/index.html>
{:target='_blank'}.
I was not expecting to see the target information and, at that point, had
not seen how the docs compile into HTML.
So it looks like EITHER the method you suggested or the HTML method should
work for links that pop a new tab.
On Fri, Jan 26, 2018 at 1:16 PM, Alex Harui <ah...@adobe.com.invalid>
wrote:
> Hi Andrew,
>
> Attachments often get stripped by Apache mailing lists. Try using
> paste.apache.org or pastebin and post a link. I'm confused by your
> email. Links in a .md file won't pop a new window, but the result in the
> .html file after Jekyll processes it should have the right target. I just
> tried it on the CI server and it worked in Safari and I don't see the word
> target in the text.
>
> http://apacheroyaleci.westus2.cloudapp.azure.com:8080/job/
> RoyaleDocs_Staging/lastSuccessfulBuild/artifact/_site/index.html
>
> Let me know if you are seeing something different.
>
> -Alex
>
> From: Andrew Wetmore <co...@gmail.com>>
> Reply-To: "dev@royale.apache.org<ma...@royale.apache.org>" <
> dev@royale.apache.org<ma...@royale.apache.org>>
> Date: Friday, January 26, 2018 at 4:43 AM
> To: "dev@royale.apache.org<ma...@royale.apache.org>" <
> dev@royale.apache.org<ma...@royale.apache.org>>
> Subject: Links to sites outside of help docs
>
> Hi:
>
> Peeling this into its own thread.
>
> I looked at index.md<https://na01.safelinks.protection.outlook.
> com/?url=http%3A%2F%2Findex.md&data=02%7C01%7Caharui%40adobe.com%
> 7Cfb5aa0f028424680cc3c08d564ba60a2%7Cfa7b1b5a7b34438794aed2c178de
> cee1%7C0%7C0%7C636525674012827775&sdata=gY%2Ff4lQJBqOUHE9oDBjTI9Q%2B%
> 2FHcsk5kKtEblwbpTWZ0%3D&reserved=0> and the syntax for popping a new tab
> does not seem to work. See attached image, where the "target" instructions
> appear in the visible text.
>
> This discussion [1] proffers several solutions, including using just plain
> HTML. I have tried that on create-an-application/migrate-an-existing-app/
> migrate-from-flex.md<https://na01.safelinks.protection.outlook.
> com/?url=http%3A%2F%2Fmigrate-from-flex.md&data=02%7C01%
> 7Caharui%40adobe.com%7Cfb5aa0f028424680cc3c08d564ba60a2%
> 7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636525674012827775&sdata=
> o7OO7P%2Fwv7y9Wq8ZbAs8Eb7B8xX1waKjJPgRV6%2BMdjI%3D&reserved=0>. I don't
> know where to look to verify that that works; could you check it?
>
> a
>
> [1] https://stackoverflow.com/questions/4425198/can-i-
> create-links-with-target-blank-in-markdown<https://
> na01.safelinks.protection.outlook.com/?url=https%3A%2F%
> 2Fstackoverflow.com%2Fquestions%2F4425198%2Fcan-i-
> create-links-with-target-blank-in-markdown&data=02%
> 7C01%7Caharui%40adobe.com%7Cfb5aa0f028424680cc3c08d564ba60a2%
> 7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636525674012827775&sdata=
> mmZxwnyxhHJfytKQy%2BIrJ%2FSM%2B8%2BewTG%2FaGonKB9fIC4%3D&reserved=0>
>
> --
> Andrew Wetmore
>
> http://cottage14.blogspot.com/<https://na01.safelinks.
> protection.outlook.com/?url=http%3A%2F%2Fcottage14.
> blogspot.com%2F&data=02%7C01%7Caharui%40adobe.com%
> 7Cfb5aa0f028424680cc3c08d564ba60a2%7Cfa7b1b5a7b34438794aed2c178de
> cee1%7C0%7C0%7C636525674012827775&sdata=hqTw9WWdtUpLzMTqGph83lb2nQyyxZ
> 8d40Rx3b3qE64%3D&reserved=0>
>
>
>
>
>
--
Andrew Wetmore
http://cottage14.blogspot.com/
Re: Links to sites outside of help docs
Posted by Alex Harui <ah...@adobe.com.INVALID>.
Hi Andrew,
Attachments often get stripped by Apache mailing lists. Try using paste.apache.org or pastebin and post a link. I'm confused by your email. Links in a .md file won't pop a new window, but the result in the .html file after Jekyll processes it should have the right target. I just tried it on the CI server and it worked in Safari and I don't see the word target in the text.
http://apacheroyaleci.westus2.cloudapp.azure.com:8080/job/RoyaleDocs_Staging/lastSuccessfulBuild/artifact/_site/index.html
Let me know if you are seeing something different.
-Alex
From: Andrew Wetmore <co...@gmail.com>>
Reply-To: "dev@royale.apache.org<ma...@royale.apache.org>" <de...@royale.apache.org>>
Date: Friday, January 26, 2018 at 4:43 AM
To: "dev@royale.apache.org<ma...@royale.apache.org>" <de...@royale.apache.org>>
Subject: Links to sites outside of help docs
Hi:
Peeling this into its own thread.
I looked at index.md<https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Findex.md&data=02%7C01%7Caharui%40adobe.com%7Cfb5aa0f028424680cc3c08d564ba60a2%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636525674012827775&sdata=gY%2Ff4lQJBqOUHE9oDBjTI9Q%2B%2FHcsk5kKtEblwbpTWZ0%3D&reserved=0> and the syntax for popping a new tab does not seem to work. See attached image, where the "target" instructions appear in the visible text.
This discussion [1] proffers several solutions, including using just plain HTML. I have tried that on create-an-application/migrate-an-existing-app/migrate-from-flex.md<https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fmigrate-from-flex.md&data=02%7C01%7Caharui%40adobe.com%7Cfb5aa0f028424680cc3c08d564ba60a2%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636525674012827775&sdata=o7OO7P%2Fwv7y9Wq8ZbAs8Eb7B8xX1waKjJPgRV6%2BMdjI%3D&reserved=0>. I don't know where to look to verify that that works; could you check it?
a
[1] https://stackoverflow.com/questions/4425198/can-i-create-links-with-target-blank-in-markdown<https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fstackoverflow.com%2Fquestions%2F4425198%2Fcan-i-create-links-with-target-blank-in-markdown&data=02%7C01%7Caharui%40adobe.com%7Cfb5aa0f028424680cc3c08d564ba60a2%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636525674012827775&sdata=mmZxwnyxhHJfytKQy%2BIrJ%2FSM%2B8%2BewTG%2FaGonKB9fIC4%3D&reserved=0>
--
Andrew Wetmore
http://cottage14.blogspot.com/<https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fcottage14.blogspot.com%2F&data=02%7C01%7Caharui%40adobe.com%7Cfb5aa0f028424680cc3c08d564ba60a2%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636525674012827775&sdata=hqTw9WWdtUpLzMTqGph83lb2nQyyxZ8d40Rx3b3qE64%3D&reserved=0>