You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@netbeans.apache.org by Laszlo Kishalmi <la...@gmail.com> on 2019/02/25 21:38:49 UTC
Prepare for Apache NetBeans 11.0 vc2
Dear all,
Please review and merge the mergeable, cherry-pick required, and
outstanding PR-s. I plan to do the cherry picks and create the vc2 for
testing.
Laszlo Kishalmi
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.incubator.apache.org
For additional commands, e-mail: dev-help@netbeans.incubator.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Netbeans documentation
Posted by Mr_Krava <mr...@yahoo.com.au.INVALID>.
Exactly what I was looking at Antonio. Inline styling causes issues.I will look at what currently exists (reviewed) and do a PR against them, then look at updating the Tutorial Contribution Guidelines to aid others going forward.
There is a few other things I've seen I would like to clean up as well.
The Trademarks for Windows and macOS doesn't need to be included all the time. It only needs to be implied once and thats it. But if its deemed to be required/desired, i will leave them as is. Would be nicer and cleaner to use the logos for each OS. Something to consider.
CheersBrianCUNKA
On Wednesday, 27 February 2019, 7:45:05 am AEDT, Antonio <an...@vieiro.net> wrote:
Yep.
Asciidoc should not set the width of the table, i.e. the following:
[grid="none",frame="none",width="75%",cols="1,4"]
|===
|*Windows*(TM)/*Linux* |`Alt-Shift-F`
|*macOS*(TM) |`Ctrl-Shift-F`
|===
Should be:
[cols="1,4"]
|===
|*Windows*(TM)/*Linux* |`Alt-Shift-F`
|*macOS*(TM) |`Ctrl-Shift-F`
|===
The "grid", "frame" and "width" are all view-specific details, that are
best handled centrally in the CSS styling, not in each asciidoc document.
Asciidoc should be just about content.
One of the objectives of having all stuff in asciidoc is that we can
render to both the HTML website _and_ to alternate formats. In the
future we may want to render to PDF or ePUB, for instance.
Who knows, maybe someone builds a plugin that renders asciidoc to JavaFX
[1], so we can replace JavaHelp with tutorials.
Please file a PR against that to solve it, or a JIRA instead if you prefer.
Thanks,
Antonio
[1]
https://asciidocfx.com/
El 26/02/2019 a las 10:05, Geertjan Wielenga escribió:
> Great, indeed, yes -- and that webpage indeed has the problem you describe,
> feel free to provide a pull request for that.
>
> Any help and assistance you can provide, indeed, the :experimental setting
> if it helps would be great.
>
> Gj
>
> On Tue, Feb 26, 2019 at 9:58 AM Mr_Krava <mr...@yahoo.com.au.invalid>
> wrote:
>
>> Greetings,
>> I'm answering Geertjan's call for documentation assistance.I've used
>> Asciidoctor quite a bit.
>>
>> Okay...firstly my apologies if this has been discussed and dismissed
>> already....
>> If you put the :experimental: setting in Asciidoc/Asciidoctor, you will be
>> able to use the menu and button commands to generate handy graphics. Style
>> sheet will need edits to accomplish this as well. I can help doing this.
>> https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#ui-macros
>> The webpage referenced here :
>> https://netbeans.apache.org/kb/docs/java/editor-codereference.html breaks
>> in terms of the CSS. There is large whitespace caused by the
>> Windows/Mac/Linux table been 75%. (Screen shot here)
>> https://i.postimg.cc/fWV9N6Gb/Untitled2.png
>> You can see the results here: (Checked in FireFox/Chrome)
>>
>> https://responsivedesignchecker.com/checker.php?url=https%3A%2F%2Fnetbeans.apache.org%2Fkb%2Fdocs%2Fjava%2Feditor-codereference.html&width=1800&height=700
>>
>>
>>
>> Cheers,Brian
>>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.incubator.apache.org
For additional commands, e-mail: dev-help@netbeans.incubator.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Netbeans documentation
Posted by Antonio <an...@vieiro.net>.
Yep.
Asciidoc should not set the width of the table, i.e. the following:
[grid="none",frame="none",width="75%",cols="1,4"]
|===
|*Windows*(TM)/*Linux* |`Alt-Shift-F`
|*macOS*(TM) |`Ctrl-Shift-F`
|===
Should be:
[cols="1,4"]
|===
|*Windows*(TM)/*Linux* |`Alt-Shift-F`
|*macOS*(TM) |`Ctrl-Shift-F`
|===
The "grid", "frame" and "width" are all view-specific details, that are
best handled centrally in the CSS styling, not in each asciidoc document.
Asciidoc should be just about content.
One of the objectives of having all stuff in asciidoc is that we can
render to both the HTML website _and_ to alternate formats. In the
future we may want to render to PDF or ePUB, for instance.
Who knows, maybe someone builds a plugin that renders asciidoc to JavaFX
[1], so we can replace JavaHelp with tutorials.
Please file a PR against that to solve it, or a JIRA instead if you prefer.
Thanks,
Antonio
[1]
https://asciidocfx.com/
El 26/02/2019 a las 10:05, Geertjan Wielenga escribió:
> Great, indeed, yes -- and that webpage indeed has the problem you describe,
> feel free to provide a pull request for that.
>
> Any help and assistance you can provide, indeed, the :experimental setting
> if it helps would be great.
>
> Gj
>
> On Tue, Feb 26, 2019 at 9:58 AM Mr_Krava <mr...@yahoo.com.au.invalid>
> wrote:
>
>> Greetings,
>> I'm answering Geertjan's call for documentation assistance.I've used
>> Asciidoctor quite a bit.
>>
>> Okay...firstly my apologies if this has been discussed and dismissed
>> already....
>> If you put the :experimental: setting in Asciidoc/Asciidoctor, you will be
>> able to use the menu and button commands to generate handy graphics. Style
>> sheet will need edits to accomplish this as well. I can help doing this.
>> https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#ui-macros
>> The webpage referenced here :
>> https://netbeans.apache.org/kb/docs/java/editor-codereference.html breaks
>> in terms of the CSS. There is large whitespace caused by the
>> Windows/Mac/Linux table been 75%. (Screen shot here)
>> https://i.postimg.cc/fWV9N6Gb/Untitled2.png
>> You can see the results here: (Checked in FireFox/Chrome)
>>
>> https://responsivedesignchecker.com/checker.php?url=https%3A%2F%2Fnetbeans.apache.org%2Fkb%2Fdocs%2Fjava%2Feditor-codereference.html&width=1800&height=700
>>
>>
>>
>> Cheers,Brian
>>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.incubator.apache.org
For additional commands, e-mail: dev-help@netbeans.incubator.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: Netbeans documentation
Posted by Geertjan Wielenga <ge...@googlemail.com.INVALID>.
Great, indeed, yes -- and that webpage indeed has the problem you describe,
feel free to provide a pull request for that.
Any help and assistance you can provide, indeed, the :experimental setting
if it helps would be great.
Gj
On Tue, Feb 26, 2019 at 9:58 AM Mr_Krava <mr...@yahoo.com.au.invalid>
wrote:
> Greetings,
> I'm answering Geertjan's call for documentation assistance.I've used
> Asciidoctor quite a bit.
>
> Okay...firstly my apologies if this has been discussed and dismissed
> already....
> If you put the :experimental: setting in Asciidoc/Asciidoctor, you will be
> able to use the menu and button commands to generate handy graphics. Style
> sheet will need edits to accomplish this as well. I can help doing this.
> https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#ui-macros
> The webpage referenced here :
> https://netbeans.apache.org/kb/docs/java/editor-codereference.html breaks
> in terms of the CSS. There is large whitespace caused by the
> Windows/Mac/Linux table been 75%. (Screen shot here)
> https://i.postimg.cc/fWV9N6Gb/Untitled2.png
> You can see the results here: (Checked in FireFox/Chrome)
>
> https://responsivedesignchecker.com/checker.php?url=https%3A%2F%2Fnetbeans.apache.org%2Fkb%2Fdocs%2Fjava%2Feditor-codereference.html&width=1800&height=700
>
>
>
> Cheers,Brian
>
Netbeans documentation
Posted by Mr_Krava <mr...@yahoo.com.au.INVALID>.
Greetings,
I'm answering Geertjan's call for documentation assistance.I've used Asciidoctor quite a bit.
Okay...firstly my apologies if this has been discussed and dismissed already....
If you put the :experimental: setting in Asciidoc/Asciidoctor, you will be able to use the menu and button commands to generate handy graphics. Style sheet will need edits to accomplish this as well. I can help doing this.
https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#ui-macros
The webpage referenced here : https://netbeans.apache.org/kb/docs/java/editor-codereference.html breaks in terms of the CSS. There is large whitespace caused by the Windows/Mac/Linux table been 75%. (Screen shot here)
https://i.postimg.cc/fWV9N6Gb/Untitled2.png
You can see the results here: (Checked in FireFox/Chrome)
https://responsivedesignchecker.com/checker.php?url=https%3A%2F%2Fnetbeans.apache.org%2Fkb%2Fdocs%2Fjava%2Feditor-codereference.html&width=1800&height=700
Cheers,Brian