Hi all,
I've converted the trails and added some basic syntax highlighting.
Trails have been transformed from original tables to a set of links.
Examples:
CND Trail
https://github.com/vieiro/incubator-netbeans-website/blob/feature/third-donation-tutorials/netbeans.apache.org/src/content/kb/docs/cnd.asciidoc
Java SE Trail
https://github.com/vieiro/incubator-netbeans-website/blob/feature/third-donation-tutorials/netbeans.apache.org/src/content/kb/docs/java-se.asciidoc
(etc.)
Note that links refer to the final ".html" files (once rendered), so if
a link fails you want to try to replace the extension ".html" with
".asciidoc".
During the process I noticed some missing images (these appear as
"image::..." in AsciiDoc) and also links to platform.netbeans.org (we're
missing these).
I can push this against incubator-netbeans-website, and then start with
some series of manual pruning and polishing. What say?
Cheers,
Antonio
El 04/12/2018 a las 10:34, Geertjan Wielenga escribió:
Excellent.
Gj
On Mon, Dec 3, 2018 at 2:15 PM Antonio <anto...@vieiro.net> wrote:
I think we can have a pull request ready by this week, with
automatically generated stuff.
Then we need to fine-tune content, review obsolete stuff, add samples, etc.
Cheers,
Antonio
El 03/12/2018 a las 15:08, Geertjan Wielenga escribió:
How close are we/what needs to be done for everything to be made
available
here (even if not in perfect format yet):
http://netbeans.apache.org/help/index.html
Gj
On Mon, Dec 3, 2018 at 1:56 PM Antonio <anto...@vieiro.net> wrote:
Proposed next steps:
- Take a closer look at syntax highlighting. We may want to detect
"shell" and "C/C++".
- Trails.
- Publish to website.
- Xmas.
- Beers.
- Ask people to improve tutorials.
- New Year.
What say?
Cheers,
Antonio
El 03/12/2018 a las 14:42, Geertjan Wielenga escribió:
Great, excellent, what's the next steps?
Gj
On Mon, Dec 3, 2018 at 1:38 PM Antonio <anto...@vieiro.net> wrote:
Hi all,
I've updated the list of external links used in the tutorials.
Links are now grouped by domain (bits.netbeans.org, oracle.com, etc.)
and for each domain each link explains which tutorials are using it.
The list is at
https://gist.github.com/vieiro/f8c0c499efba3762eb823f9333d97a4d
Cheers,
Antonio
El 02/12/2018 a las 11:56, Antonio escribió:
Good idea.
I was thinking I could improve the tool to do a reverse index, so we
know which tutorials are referring to which samples.
Cheers,
Antonio
El 2/12/18 a las 11:40, Geertjan Wielenga escribió:
Great progress!
I recommend forgetting about those ZIP files. They’re old, we should
simply
recreate them from scratch where relevant.
Gj
On Sunday, December 2, 2018, Antonio <anto...@vieiro.net> wrote:
Hi,
There're many missing samples (mainly zip files). These start with
the
prefix:
https://netbeans.org/projects/samples/downloads/download/
It would be great if we could retrieve those zip files (with a
proper
license) and add them to a git repo, right?
Cheers,
Antonio
El 2/12/18 a las 11:16, Antonio escribió:
Hi all,
I've uploaded the file at
https://gist.github.com/vieiro/365fa1a407b4975bf029e687c40da271
Cheers,
Antonio
El 2/12/18 a las 11:12, Emilian Bold escribió:
vieiro.net works for me. There's an LetsEncrypt certificate from
October 31, 2018 (which expires January 29, 2019).
--emi
http://coolbeans.xyz/ - CoolBeans: An IDE for Java, JavaEE, PHP
and
more!
On Sun, Dec 2, 2018 at 12:07 PM Dmitry Avtonomov
<dmitriy.avtono...@gmail.com> wrote:
It's ERR_SSL_PROTOCOL_ERROR , just says "This site can’t
provide a
secure
connection" (all 3 major browsers). It looks to be something
with
https://vieiro.net/ in general, not only this specific file.
Has
youe
cert
expired?
On Sun, Dec 2, 2018 at 2:02 AM Antonio <anto...@vieiro.net>
wrote:
Mmm... it's working on my laptop! :-D
Now, seriously, what's the error message you're getting?
Thanks,
Antonio
El 2/12/18 a las 10:53, Dmitry Avtonomov escribió:
That is so good to hear! Tutorials are such an important part.
The link [ https://vieiro.net/netbeans/external-links.txt ]
doesn't
seem to
be working.
On Sun, Dec 2, 2018 at 1:43 AM Antonio <anto...@vieiro.net>
wrote:
Hi all,
As you know the tutorials are a part of the third donation
from
Oracle.
I've been doing some exercises on these (just the tutorials,
not the
trails):
== New html-convert tool
I've created PR#8 against incubator-netbeans-tools [1]. This
contains a
new tool: "html-convert", that processes the third-donation
zip
file
(once extracted) and:
- Transforms tutorial HTML files to the AsciiDoc format.
- Maintains the same folder structure as in the original
donation
(cnd,
ide, java, javaee, javame, php, web, webclient, websvc).
- Copies images from the third-donation images directory to a
"images"
folder near the tutorials (so it's easier to know which
tutorial has
which images). Also warns about missing images.
- Since the directories have no index files in the donation,
the tool
creates an index.asciidoc, index_zh_CN.asciidoc,
index_ja.asciidoc,
index_pt_BR.asciidoc, index_ca.asciidoc for different
languages, and
lists the tutorials on each language, alphabetically sorted).
- Tries to remove the "Contents" section that was manually
included
in
many tutorials, the proposal is to replace these with an
automatically
generated "toc" (Table Of Contents) section (as other parts
of
the
website have in place).
- Tries to guess appropriate syntax coloring for each
source-code
excerpt.
- Generates a "external-links.txt" file (72Kb or so) with a
list
of
external links the tutorials are using. A quick scan of the
file
shows
we're pointing to many mp4 files in bits.netbeans.org/media
(these
have
not been donated, AFAIK). The list of external links from the
tutorials
is available at:
https://vieiro.net/netbeans/external-links.txt
== The website
Once the tool is run one can add the ~3000 generated AsciiDoc
and
image
files to the NetBeans website. I've created a
feature/third-donation-tutorials branch in my website clone
at
[2],
but
have not made it a PR as of yet. You can clone this branch
yourself
and
run "gradlew buildSite run" to generate the website yourself
in
your
box.
== Proposed plan
I'd appreciate you taking a look at the automatically
generated
tutorials at [3] (feature/third-donation-tutorials branch and
the
kb/docs subdirectories, see for instance [4]) and validating
these.
The proposed plan is to
1.- fine-tune the "html-convert" tool and try to think of
missing
features or improvements. Code quality is not critical as...
2.- ... the tool will be run _once_ to generate the final
asciidoc
material. The tool won't be run again.
3.- include the asciidoc material in the website.
4.- start a plan to manually review the tutorials, seeing
what's
missing
(videos, etc.) or obsolete, and what needs updating or
translating.
With
the help of the Community. This can be performed with PRs
against the
website or by directly editing the asciidoc in github.
As usual reviews, enhancements and improvements are most
welcome.
Kind regards,
Antonio
[1]
https://github.com/apache/incubator-netbeans-tools/pull/8
[2]
https://github.com/vieiro/incubator-netbeans-website/tree/
feature/third-donation-tutorials
[3]
https://github.com/vieiro/incubator-netbeans-website/tree/
feature/third-donation-tutorials/netbeans.apache.org/src/
content/kb/docs
[4]
Example with images:
https://github.com/vieiro/incubator-netbeans-website/blob/
feature/third-donation-tutorials/netbeans.apache.org/src/
content/kb/docs/java/debug-visual.asciidoc
Example with images & source code (Java syntax highlighting)
https://github.com/vieiro/incubator-netbeans-website/blob/
feature/third-donation-tutorials/netbeans.apache.org/src/
content/kb/docs/java/groovy-quickstart.asciidoc
Idem in the japanesse version:
https://github.com/vieiro/incubator-netbeans-website/blob/
feature/third-donation-tutorials/netbeans.apache.org/src/
content/kb/docs/java/groovy-quickstart_ja.asciidoc
------------------------------------------------------------
---------
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
---------------------------------------------------------------------
To unsubscribe, e-mail:
dev-unsubscr...@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
---------------------------------------------------------------------
To unsubscribe, e-mail:
dev-unsubscr...@netbeans.incubator.apache.org
For additional commands, e-mail:
dev-h...@netbeans.incubator.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
---------------------------------------------------------------------
To unsubscribe, e-mail:
dev-unsubscr...@netbeans.incubator.apache.org
For additional commands, e-mail:
dev-h...@netbeans.incubator.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@netbeans.incubator.apache.org
For additional commands, e-mail:
dev-h...@netbeans.incubator.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@netbeans.incubator.apache.org
For additional commands, e-mail: dev-h...@netbeans.incubator.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@netbeans.incubator.apache.org
For additional commands, e-mail: dev-h...@netbeans.incubator.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@netbeans.incubator.apache.org
For additional commands, e-mail: dev-h...@netbeans.incubator.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
