royale-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Alex Harui <aha...@adobe.com.INVALID>
Subject Re: Links to sites outside of help docs
Date Fri, 26 Jan 2018 20:28:27 GMT
On 1/26/18, 11:31 AM, "Andrew Wetmore" <cottage14@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 <aharui@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 <cottage14@gmail.com<mailto:cottage14@gmail.com>>
>> Reply-To: "dev@royale.apache.org<mailto:dev@royale.apache.org>" <
>> dev@royale.apache.org<mailto:dev@royale.apache.org>>
>> Date: Friday, January 26, 2018 at 4:43 AM
>> To: "dev@royale.apache.org<mailto:dev@royale.apache.org>" <
>> dev@royale.apache.org<mailto:dev@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

Mime
View raw message