You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@netbeans.apache.org by Peter Blemel <pb...@hotmail.com> on 2022/01/24 02:18:09 UTC
"Original" NB tutorials?
Hi,
After looking through the tutorials, the thing that jumps out at me the most is that many of them have incorrect illustrations. I used many of these tutorials "back in the day", and recall that the illustrations were not such a jumble. If someone can point me to the original directories from before they were moved, I will try to get the right images back into their respective tutorials in the GitHub repo before moving on to updating individual tutorials.
Thanks,
Peter
Re: "Original" NB tutorials?
Posted by antonio <an...@vieiro.net>.
Hi all,
So we no have a PR with the proper images [1], I think. I'd appreciate
some pairs of less tired eyes taking another look before merging.
Thanks,
Antonio
[1]
https://github.com/apache/netbeans-website/pull/581
El 24/1/22 a las 15:50, Peter Blemel escribió:
> Antonio,
>
> I haven't been through all of the tutorials, but many of the ones that I've been looking at have problems. For example,
> https://netbeans.apache.org/tutorials/nbm-javacc-lexer.html has "stock trader" graphics.
> https://netbeans.apache.org/tutorials/nbm-copyfqn.html has "POV Ray" graphics
> https://netbeans.apache.org/tutorials/nbm-code-completion.html Stock trader
> https://netbeans.apache.org/tutorials/nbm-java-hint.html Stock trader
> and so on.
>
> It looks like the tutorials each used to live in its own directory, many using the same file name for their individual graphics - which was fine because the directory structure at the time kept the file names from colliding with each other. When they were subsequently all put into one folder, files with the same name became a problem. Each tutorial copied into the directory overwrote files already there. Now they all link to the same graphic because the individual graphics were not renamed.
>
> Brad suggested re-creating the images to bring them up-to-date. That will take some time. Giving all of the old files unique file names and fixing each HTML file is also a lot of work. Another, easier solution is to rebuild the tutorials folder using the original directory structure. That will not bring the graphics up to date, but will solve the problem in an expedient way.
>
> Best,
> Peter
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by Peter Blemel <pb...@hotmail.com>.
By the way, this tarball only has the new images. My onedrive is low on space, so I left out all of the existing image folders. Consequently, any new tutorial or any tutorial with a changed image probably is broken. I'll need to sort that out.
Peter
________________________________
From: Peter Blemel <pb...@hotmail.com>
Sent: Tuesday, January 25, 2022 7:58 PM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>
Subject: Re: "Original" NB tutorials?
Here's where I'm at so far. It's not perfect. In fact, looking at it, I was focused on img src HTML statements and completely overlooked links in body text (eg. "You can download an example file here ..." ). So, I'll need to patch that up.
I'm out of time for tonight. I have some other things to do, but will get back to this soon.
This version<https://1drv.ms/u/s!ArASQL2pSWgomUx_1ksXsCcFOETh?e=p3dthW> has every image in one monolithic folder, which avoids cross-directory links. I'm still thinking about how to split images into version folders in an automated way.... It also has broken links in comments. Have a look if you have time.
[https://outlook-1.cdn.office.net/assets/mail/file-icon/png/generic_16x16.png]asciidoc-tutorials.tgz<https://1drv.ms/u/s!ArASQL2pSWgomUx_1ksXsCcFOETh?e=p3dthW>
Peter
________________________________
From: Peter Blemel <pb...@hotmail.com>
Sent: Tuesday, January 25, 2022 7:19 PM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>
Subject: Re: "Original" NB tutorials?
A good example of a tutorial that cross-linked images was version 8.0's IDE tutorial, which used 7.2's images by path.
The result can be seen in your current tutorial here:
https://github.com/vieiro/netbeans-website/blob/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials/80/nbm-ide.asciidoc
This tutorial has broken links because it points to
https://github.com/vieiro/netbeans-website/blob/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials/80/images/ide_72_new-project-1.png
There is no file by this name in the 80/images folder, or even in the 72/images folder. Something has erroneously inserted the ide_72_ path. Even making the path 72/images/new-project-1.png might or might not be correct. That depends on how many other '72' tutorials also used the name new-project-1.png and which one you kept.
So, the problem is coming up with a general-purpose solution that maintains the directory structure. My current "best effort" puts all images into a single folder. It was my first attempt at being sure that every single image anywhere in the tutorial hierarchy points to the correct image, because putting things into subfolders like 72/images means I have to patch up any tutorial that cross-linked a prior version.
Messy. And, so far I can't say if I got them all - but the solution seems to generalize well.
Peter
________________________________
From: Peter Blemel <pb...@hotmail.com>
Sent: Tuesday, January 25, 2022 6:32 PM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>
Subject: Re: "Original" NB tutorials?
Antonio,
I'm looking at what you've done in the context of what I've learned 🙂. I've spent some time on this this afternoon. Here's what I understand now:
1. The old tutorials images used a hierarchical structure that matched the tutorials. They were organized by tutorial name and then version. Each folder had both images and sub-folders for each release containing images. To illustrate the problem, let's pick result-1 and result-2 to illustrate what's happening. There are many "result-1.png"s in lots of 72 subdirectories. This was okay because they were all unique under their path.
-rw-r----- 1 peter peter 12K Dec 12 2019 ./cc/72/result-1.png
-rw-r----- 1 peter peter 65K Dec 12 2019 ./crud/72/result-1.png
-rw-r----- 1 peter peter 7.1K Dec 12 2019 ./hint/72/result-1.png
-rw-r----- 1 peter peter 126K Dec 12 2019 ./htmleditor/72/result-1.png
-rw-r----- 1 peter peter 17K Dec 12 2019 ./javacc/72/result-1.png
-rw-r----- 1 peter peter 68K Dec 12 2019 ./javafx/72/result-1.png
-rw-r----- 1 peter peter 5.4K Dec 12 2019 ./mark-occs/72/result-1.png
-rw-r----- 1 peter peter 32K Dec 12 2019 ./maven-crud/72/result-1.png
-rw-r----- 1 peter peter 37K Dec 12 2019 ./maven-quickstart/72/result-1.png
-rw-r----- 1 peter peter 7.4K Dec 12 2019 ./projecttypes/72pics/result-1.png
-rw-r----- 1 peter peter 14K Dec 12 2019 ./qsearch/72/result-1.png
o The new site reverses this, decomposing by version first and then the tutorials. Now, instead of '{tutorial}/72/result-1.png', you have '72/images/result-1.png'. Exactly one. Which one of these is in that folder?
-rw-r----- 1 peter peter 68K Jan 25 18:17 result-1.png
Judging by the size, I'd say you kept the one from "javafx". Every other tutorial now gets "javafx"'s result-1.png because they are all in the '72' folder and all use the same "graphics" folder. The same thing happens for every other release number.
2 Not all tutorials used only illustrations from their own directories. In some cases, they re-used graphics from a previous version, so there was some cross-linking between folders.
I have taken two approaches:
1. The first simply re-used last night's work, mapping every path/to/image.png onto a corresponding path-to-image.png in a single directory. Using this approach, we get :
-rw-r----- 1 peter peter 12152 Dec 12 2019 ./cc-72-result-1.png
-rw-r----- 1 peter peter 65580 Dec 12 2019 ./crud-72-result-1.png
-rw-r----- 1 peter peter 7238 Dec 12 2019 ./hint-72-result-1.png
-rw-r----- 1 peter peter 128879 Dec 12 2019 ./htmleditor-72-result-1.png
-rw-r----- 1 peter peter 16721 Dec 12 2019 ./javacc-72-result-1.png
-rw-r----- 1 peter peter 68977 Dec 12 2019 ./javafx-72-result-1.png
-rw-r----- 1 peter peter 5444 Dec 12 2019 ./mark-occs-72-result-1.png
-rw-r----- 1 peter peter 32202 Dec 12 2019 ./maven-crud-72-result-1.png
-rw-r----- 1 peter peter 37059 Dec 12 2019 ./maven-quickstart-72-result-1.png
-rw-r----- 1 peter peter 14205 Dec 12 2019 ./qsearch-72-result-1.png
I'm not sure if I pasted all of them, but you get the point.
I then wrote a script that fixes every .asciidoc version of the tutorial in-place to match this new naming scheme.
2. The problem with #1 was that my script put everything into one monolithic "legacy" folder. So, right now I am putting the finishing touches on putting all of the '72' images into the 72/graphics folder and massaging the .asciidoc files to make that. This will be close to what you have now.
As near as I can tell, your changes do not address the problem above. Let me know if I misunderstand.
Respectfully,
Peter
________________________________
From: antonio <an...@vieiro.net>
Sent: Tuesday, January 25, 2022 4:12 PM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>
Subject: Re: "Original" NB tutorials?
Hi Peter,
I think we have it! What about the tutorials at
https://github.com/vieiro/netbeans-website/tree/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials
For instance
https://github.com/vieiro/netbeans-website/blob/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials/nbm-javacc-lexer.asciidoc
https://github.com/vieiro/netbeans-website/blob/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials/nbm-code-completion.asciidoc
Do these look better now?
Thanks,
Antonio
El 24/1/22 a las 15:50, Peter Blemel escribió:
> Antonio,
>
> I haven't been through all of the tutorials, but many of the ones that I've been looking at have problems. For example,
> https://netbeans.apache.org/tutorials/nbm-javacc-lexer.html has "stock trader" graphics.
> https://netbeans.apache.org/tutorials/nbm-copyfqn.html has "POV Ray" graphics
> https://netbeans.apache.org/tutorials/nbm-code-completion.html Stock trader
> https://netbeans.apache.org/tutorials/nbm-java-hint.html Stock trader
> and so on.
>
> It looks like the tutorials each used to live in its own directory, many using the same file name for their individual graphics - which was fine because the directory structure at the time kept the file names from colliding with each other. When they were subsequently all put into one folder, files with the same name became a problem. Each tutorial copied into the directory overwrote files already there. Now they all link to the same graphic because the individual graphics were not renamed.
>
> Brad suggested re-creating the images to bring them up-to-date. That will take some time. Giving all of the old files unique file names and fixing each HTML file is also a lot of work. Another, easier solution is to rebuild the tutorials folder using the original directory structure. That will not bring the graphics up to date, but will solve the problem in an expedient way.
>
> Best,
> Peter
>
> ________________________________
> From: antonio <an...@vieiro.net>
> Sent: Monday, January 24, 2022 12:01 AM
> To: dev@netbeans.apache.org <de...@netbeans.apache.org>
> Subject: Re: "Original" NB tutorials?
>
> Hi Peter,
>
> Originals are kept here for reference
>
> https://github.com/wadechandler/netbeans-static-site (src/content)
>
> Cheers,
> Antonio
>
> P.S.: I'm curious, which illustrations are incorrect?
>
>
> El 24/1/22 a las 3:18, Peter Blemel escribió:
>> Hi,
>>
>> After looking through the tutorials, the thing that jumps out at me the most is that many of them have incorrect illustrations. I used many of these tutorials "back in the day", and recall that the illustrations were not such a jumble. If someone can point me to the original directories from before they were moved, I will try to get the right images back into their respective tutorials in the GitHub repo before moving on to updating individual tutorials.
>>
>> Thanks,
>> Peter
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.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-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by Arafat BOUCHAFRA <ar...@gmail.com>.
Hi Peter,
Me too, I have asked Geertjan about re-starting the NetBeans
certifications, but saw that it needs a well engaged team, to write
tutorials, code examples, and then the test exams.
So, if you're interested, I'll be so pretty happy to get involved in a such
project.
King regards
Le dim. 30 janv. 2022 à 12:03, Peter Blemel <pb...@hotmail.com> a écrit :
> I have just spent the better part of a couple of weeks "porting" two
> Platform applications to 12.6 from the dark ages. There was a lot of stuff
> that I didn't remember "why did I do that?", and going back to the
> tutorials helped.
>
> On the whole, I am impressed by how easy the "port" was. My layers broke,
> but I always hated layer files anyway. I never really understood what I was
> doing, so a lot of it was copy pasta. 12.6 did strange things with them (my
> File menu was gone, other menus were moved around). Rebuilding my actions
> was pretty easy once I saw how the IDE built a new action with annotations.
> There are some cases where I would still prefer my text to be in a Bundle
> because a couple of different action/menus/buttons share the same text - so
> having multiple copies of the annotations means having fix typos in
> multiple places. There's probably an easier way to do it, I just don't know
> what it is yet.
>
> I had a DataLoader that was really unnecessary, but it took me a while to
> figure that out and just get rid of it. There's probably some power there,
> but I wasn't using it. The StackOverflow article I found that looked
> pretty recent said to add it to a layer, so that was what tipped me to
> getting rid of it.
>
> I particularly liked being able to manipulate the layers in the IDE once
> the annotations were in place. I couldn't do that with my old layer files.
>
> MultiView windows are what is giving me the most grief, but I'm slowly
> working past it. My old code's OpenSupport gathered up all of the
> MultiViewDescriptors and called
> MultiViewFactory.createCloneableMultiView(). Each of my views was derived
> from TopComponent, which gave me access to the lookup (etc) - but the new
> scheme doesn't like views that subclass from TCs, so that's been some work.
> In particular, I can't figure out how to connect my views to the TC
> containing them. I probably need to go revisit the lookup tutorial.
>
> Other than that, I'm happy with the IDE (except for its problems with my
> older freestyle and absolute layouts) and the compatibility of everything.
> My goal was to replace layer files with annotations, so from that
> perspective the lion's share of the older tutorials aren't particularly
> useful - but, they're still a good resource.
>
> I am very pleased with how easy it is to create a platform application,
> even though the winds of change seem to be shifting away from desktop
> applications for one of my two apps.
>
> Peter
>
> ________________________________
> From: Christian Lenz <ch...@gmx.net>
> Sent: Saturday, January 29, 2022 9:29 AM
> To: dev@netbeans.apache.org <de...@netbeans.apache.org>
> Subject: AW: "Original" NB tutorials?
>
> Not really outdated. With luck all the stuff is still working, also for
> the other NetBeans tutorial where it says „required NB6“. Sure a lot of
> Things changed but the tutorials helped a lot.
>
> I had luck to find the stuff on the wayback machine. So if you still have
> an Oracle link which is not working anymore, just check the Archive. No
> Images, but the text is still there 😊.
>
>
> Cheers
>
> Chris
>
> Von: Geertjan Wielenga
> Gesendet: Samstag, 29. Januar 2022 17:12
> An: dev
> Betreff: Re: "Original" NB tutorials?
>
> They're all by me personally and don't think they're anywhere anymore and
> certainly outdated.
>
> Gj
>
> On Sat, Jan 29, 2022 at 5:08 PM Eric Bresie <eb...@gmail.com> wrote:
>
> > Assume many are no longer available (i.e. videos by folks no longer with
> > Oracle or just moved away) but are any of the videos referenced here
> still
> > available, relevant, or superseded someplace?
> >
> > https://netbeans.apache.org/tutorials/nbm-10-top-apis.html
> >
> > Eric Bresie
> > ebresie@gmail.com
> >
> >
> > On Wed, Jan 26, 2022 at 1:44 AM antonio <an...@vieiro.net> wrote:
> >
> > > Hi again, Peter,
> > >
> > > Yeah, time is the main problem with open source :-).
> > >
> > > Thanks for pointing this out! Based on your comments I created this new
> > > branch
> > >
> > >
> > >
> >
> https://github.com/vieiro/netbeans-website/tree/hotfix/images-for-tutorials-2/netbeans.apache.org/src/content/tutorials
> > >
> > > That I think solves the issue. It's not ready for PR (we may want to do
> > > some 'git rm' to remove dangling images first).
> > >
> > > What we want is to have each tutorial folder to have the images under
> > > the immediate 'images' subfolder. This is, '70/*.asciidoc' images
> should
> > > be kept under '70/images' subfolder, for instance. Without any
> > > cross-linking between directories.
> > >
> > > This will make some images being duplicated, but will also make it
> > > easier for us to remove those '60/*', '61/*' ... '80/*' subdirectories
> > > that we have been carrying along for ages since the migration, and that
> > > are not relevant anymore for Apache NetBeans.
> > >
> > > Thanks and kind regards,
> > > Antonio
> > >
> > > El 26/1/22 a las 3:58, Peter Blemel escribió:
> > > > I'm out of time for tonight. I have some other things to do, but
> will
> > > get back to this soon.
> > > >
> > > > This version<
> https://1drv.ms/u/s!ArASQL2pSWgomUx_1ksXsCcFOETh?e=p3dthW
> > >
> > > has every image in one monolithic folder, which avoids cross-directory
> > > links. I'm still thinking about how to split images into version
> folders
> > > in an automated way.... It also has broken links in comments. Have a
> > look
> > > if you have time.
> > >
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> > > For additional commands, e-mail: dev-help@netbeans.apache.org
> > >
> > > For further information about the NetBeans mailing lists, visit:
> > > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
> > >
> > >
> > >
> > >
> >
>
>
Re: "Original" NB tutorials?
Posted by Peter Blemel <pb...@hotmail.com>.
I have just spent the better part of a couple of weeks "porting" two Platform applications to 12.6 from the dark ages. There was a lot of stuff that I didn't remember "why did I do that?", and going back to the tutorials helped.
On the whole, I am impressed by how easy the "port" was. My layers broke, but I always hated layer files anyway. I never really understood what I was doing, so a lot of it was copy pasta. 12.6 did strange things with them (my File menu was gone, other menus were moved around). Rebuilding my actions was pretty easy once I saw how the IDE built a new action with annotations. There are some cases where I would still prefer my text to be in a Bundle because a couple of different action/menus/buttons share the same text - so having multiple copies of the annotations means having fix typos in multiple places. There's probably an easier way to do it, I just don't know what it is yet.
I had a DataLoader that was really unnecessary, but it took me a while to figure that out and just get rid of it. There's probably some power there, but I wasn't using it. The StackOverflow article I found that looked pretty recent said to add it to a layer, so that was what tipped me to getting rid of it.
I particularly liked being able to manipulate the layers in the IDE once the annotations were in place. I couldn't do that with my old layer files.
MultiView windows are what is giving me the most grief, but I'm slowly working past it. My old code's OpenSupport gathered up all of the MultiViewDescriptors and called MultiViewFactory.createCloneableMultiView(). Each of my views was derived from TopComponent, which gave me access to the lookup (etc) - but the new scheme doesn't like views that subclass from TCs, so that's been some work. In particular, I can't figure out how to connect my views to the TC containing them. I probably need to go revisit the lookup tutorial.
Other than that, I'm happy with the IDE (except for its problems with my older freestyle and absolute layouts) and the compatibility of everything. My goal was to replace layer files with annotations, so from that perspective the lion's share of the older tutorials aren't particularly useful - but, they're still a good resource.
I am very pleased with how easy it is to create a platform application, even though the winds of change seem to be shifting away from desktop applications for one of my two apps.
Peter
________________________________
From: Christian Lenz <ch...@gmx.net>
Sent: Saturday, January 29, 2022 9:29 AM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>
Subject: AW: "Original" NB tutorials?
Not really outdated. With luck all the stuff is still working, also for the other NetBeans tutorial where it says „required NB6“. Sure a lot of Things changed but the tutorials helped a lot.
I had luck to find the stuff on the wayback machine. So if you still have an Oracle link which is not working anymore, just check the Archive. No Images, but the text is still there 😊.
Cheers
Chris
Von: Geertjan Wielenga
Gesendet: Samstag, 29. Januar 2022 17:12
An: dev
Betreff: Re: "Original" NB tutorials?
They're all by me personally and don't think they're anywhere anymore and
certainly outdated.
Gj
On Sat, Jan 29, 2022 at 5:08 PM Eric Bresie <eb...@gmail.com> wrote:
> Assume many are no longer available (i.e. videos by folks no longer with
> Oracle or just moved away) but are any of the videos referenced here still
> available, relevant, or superseded someplace?
>
> https://netbeans.apache.org/tutorials/nbm-10-top-apis.html
>
> Eric Bresie
> ebresie@gmail.com
>
>
> On Wed, Jan 26, 2022 at 1:44 AM antonio <an...@vieiro.net> wrote:
>
> > Hi again, Peter,
> >
> > Yeah, time is the main problem with open source :-).
> >
> > Thanks for pointing this out! Based on your comments I created this new
> > branch
> >
> >
> >
> https://github.com/vieiro/netbeans-website/tree/hotfix/images-for-tutorials-2/netbeans.apache.org/src/content/tutorials
> >
> > That I think solves the issue. It's not ready for PR (we may want to do
> > some 'git rm' to remove dangling images first).
> >
> > What we want is to have each tutorial folder to have the images under
> > the immediate 'images' subfolder. This is, '70/*.asciidoc' images should
> > be kept under '70/images' subfolder, for instance. Without any
> > cross-linking between directories.
> >
> > This will make some images being duplicated, but will also make it
> > easier for us to remove those '60/*', '61/*' ... '80/*' subdirectories
> > that we have been carrying along for ages since the migration, and that
> > are not relevant anymore for Apache NetBeans.
> >
> > Thanks and kind regards,
> > Antonio
> >
> > El 26/1/22 a las 3:58, Peter Blemel escribió:
> > > I'm out of time for tonight. I have some other things to do, but will
> > get back to this soon.
> > >
> > > This version<https://1drv.ms/u/s!ArASQL2pSWgomUx_1ksXsCcFOETh?e=p3dthW
> >
> > has every image in one monolithic folder, which avoids cross-directory
> > links. I'm still thinking about how to split images into version folders
> > in an automated way.... It also has broken links in comments. Have a
> look
> > if you have time.
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> > For additional commands, e-mail: dev-help@netbeans.apache.org
> >
> > For further information about the NetBeans mailing lists, visit:
> > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
> >
> >
> >
> >
>
AW: "Original" NB tutorials?
Posted by Christian Lenz <ch...@gmx.net>.
Not really outdated. With luck all the stuff is still working, also for the other NetBeans tutorial where it says „required NB6“. Sure a lot of Things changed but the tutorials helped a lot.
I had luck to find the stuff on the wayback machine. So if you still have an Oracle link which is not working anymore, just check the Archive. No Images, but the text is still there 😊.
Cheers
Chris
Von: Geertjan Wielenga
Gesendet: Samstag, 29. Januar 2022 17:12
An: dev
Betreff: Re: "Original" NB tutorials?
They're all by me personally and don't think they're anywhere anymore and
certainly outdated.
Gj
On Sat, Jan 29, 2022 at 5:08 PM Eric Bresie <eb...@gmail.com> wrote:
> Assume many are no longer available (i.e. videos by folks no longer with
> Oracle or just moved away) but are any of the videos referenced here still
> available, relevant, or superseded someplace?
>
> https://netbeans.apache.org/tutorials/nbm-10-top-apis.html
>
> Eric Bresie
> ebresie@gmail.com
>
>
> On Wed, Jan 26, 2022 at 1:44 AM antonio <an...@vieiro.net> wrote:
>
> > Hi again, Peter,
> >
> > Yeah, time is the main problem with open source :-).
> >
> > Thanks for pointing this out! Based on your comments I created this new
> > branch
> >
> >
> >
> https://github.com/vieiro/netbeans-website/tree/hotfix/images-for-tutorials-2/netbeans.apache.org/src/content/tutorials
> >
> > That I think solves the issue. It's not ready for PR (we may want to do
> > some 'git rm' to remove dangling images first).
> >
> > What we want is to have each tutorial folder to have the images under
> > the immediate 'images' subfolder. This is, '70/*.asciidoc' images should
> > be kept under '70/images' subfolder, for instance. Without any
> > cross-linking between directories.
> >
> > This will make some images being duplicated, but will also make it
> > easier for us to remove those '60/*', '61/*' ... '80/*' subdirectories
> > that we have been carrying along for ages since the migration, and that
> > are not relevant anymore for Apache NetBeans.
> >
> > Thanks and kind regards,
> > Antonio
> >
> > El 26/1/22 a las 3:58, Peter Blemel escribió:
> > > I'm out of time for tonight. I have some other things to do, but will
> > get back to this soon.
> > >
> > > This version<https://1drv.ms/u/s!ArASQL2pSWgomUx_1ksXsCcFOETh?e=p3dthW
> >
> > has every image in one monolithic folder, which avoids cross-directory
> > links. I'm still thinking about how to split images into version folders
> > in an automated way.... It also has broken links in comments. Have a
> look
> > if you have time.
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> > For additional commands, e-mail: dev-help@netbeans.apache.org
> >
> > For further information about the NetBeans mailing lists, visit:
> > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
> >
> >
> >
> >
>
Re: "Original" NB tutorials?
Posted by Geertjan Wielenga <ge...@googlemail.com.INVALID>.
They're all by me personally and don't think they're anywhere anymore and
certainly outdated.
Gj
On Sat, Jan 29, 2022 at 5:08 PM Eric Bresie <eb...@gmail.com> wrote:
> Assume many are no longer available (i.e. videos by folks no longer with
> Oracle or just moved away) but are any of the videos referenced here still
> available, relevant, or superseded someplace?
>
> https://netbeans.apache.org/tutorials/nbm-10-top-apis.html
>
> Eric Bresie
> ebresie@gmail.com
>
>
> On Wed, Jan 26, 2022 at 1:44 AM antonio <an...@vieiro.net> wrote:
>
> > Hi again, Peter,
> >
> > Yeah, time is the main problem with open source :-).
> >
> > Thanks for pointing this out! Based on your comments I created this new
> > branch
> >
> >
> >
> https://github.com/vieiro/netbeans-website/tree/hotfix/images-for-tutorials-2/netbeans.apache.org/src/content/tutorials
> >
> > That I think solves the issue. It's not ready for PR (we may want to do
> > some 'git rm' to remove dangling images first).
> >
> > What we want is to have each tutorial folder to have the images under
> > the immediate 'images' subfolder. This is, '70/*.asciidoc' images should
> > be kept under '70/images' subfolder, for instance. Without any
> > cross-linking between directories.
> >
> > This will make some images being duplicated, but will also make it
> > easier for us to remove those '60/*', '61/*' ... '80/*' subdirectories
> > that we have been carrying along for ages since the migration, and that
> > are not relevant anymore for Apache NetBeans.
> >
> > Thanks and kind regards,
> > Antonio
> >
> > El 26/1/22 a las 3:58, Peter Blemel escribió:
> > > I'm out of time for tonight. I have some other things to do, but will
> > get back to this soon.
> > >
> > > This version<https://1drv.ms/u/s!ArASQL2pSWgomUx_1ksXsCcFOETh?e=p3dthW
> >
> > has every image in one monolithic folder, which avoids cross-directory
> > links. I'm still thinking about how to split images into version folders
> > in an automated way.... It also has broken links in comments. Have a
> look
> > if you have time.
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> > For additional commands, e-mail: dev-help@netbeans.apache.org
> >
> > For further information about the NetBeans mailing lists, visit:
> > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
> >
> >
> >
> >
>
Re: "Original" NB tutorials?
Posted by Eric Bresie <eb...@gmail.com>.
Assume many are no longer available (i.e. videos by folks no longer with
Oracle or just moved away) but are any of the videos referenced here still
available, relevant, or superseded someplace?
https://netbeans.apache.org/tutorials/nbm-10-top-apis.html
Eric Bresie
ebresie@gmail.com
On Wed, Jan 26, 2022 at 1:44 AM antonio <an...@vieiro.net> wrote:
> Hi again, Peter,
>
> Yeah, time is the main problem with open source :-).
>
> Thanks for pointing this out! Based on your comments I created this new
> branch
>
>
> https://github.com/vieiro/netbeans-website/tree/hotfix/images-for-tutorials-2/netbeans.apache.org/src/content/tutorials
>
> That I think solves the issue. It's not ready for PR (we may want to do
> some 'git rm' to remove dangling images first).
>
> What we want is to have each tutorial folder to have the images under
> the immediate 'images' subfolder. This is, '70/*.asciidoc' images should
> be kept under '70/images' subfolder, for instance. Without any
> cross-linking between directories.
>
> This will make some images being duplicated, but will also make it
> easier for us to remove those '60/*', '61/*' ... '80/*' subdirectories
> that we have been carrying along for ages since the migration, and that
> are not relevant anymore for Apache NetBeans.
>
> Thanks and kind regards,
> Antonio
>
> El 26/1/22 a las 3:58, Peter Blemel escribió:
> > I'm out of time for tonight. I have some other things to do, but will
> get back to this soon.
> >
> > This version<https://1drv.ms/u/s!ArASQL2pSWgomUx_1ksXsCcFOETh?e=p3dthW>
> has every image in one monolithic folder, which avoids cross-directory
> links. I'm still thinking about how to split images into version folders
> in an automated way.... It also has broken links in comments. Have a look
> if you have time.
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.apache.org
>
> For further information about the NetBeans mailing lists, visit:
> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
>
>
>
>
Re: "Original" NB tutorials?
Posted by antonio <an...@vieiro.net>.
Hi again, Peter,
Yeah, time is the main problem with open source :-).
Thanks for pointing this out! Based on your comments I created this new
branch
https://github.com/vieiro/netbeans-website/tree/hotfix/images-for-tutorials-2/netbeans.apache.org/src/content/tutorials
That I think solves the issue. It's not ready for PR (we may want to do
some 'git rm' to remove dangling images first).
What we want is to have each tutorial folder to have the images under
the immediate 'images' subfolder. This is, '70/*.asciidoc' images should
be kept under '70/images' subfolder, for instance. Without any
cross-linking between directories.
This will make some images being duplicated, but will also make it
easier for us to remove those '60/*', '61/*' ... '80/*' subdirectories
that we have been carrying along for ages since the migration, and that
are not relevant anymore for Apache NetBeans.
Thanks and kind regards,
Antonio
El 26/1/22 a las 3:58, Peter Blemel escribió:
> I'm out of time for tonight. I have some other things to do, but will get back to this soon.
>
> This version<https://1drv.ms/u/s!ArASQL2pSWgomUx_1ksXsCcFOETh?e=p3dthW> has every image in one monolithic folder, which avoids cross-directory links. I'm still thinking about how to split images into version folders in an automated way.... It also has broken links in comments. Have a look if you have time.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by Peter Blemel <pb...@hotmail.com>.
Here's where I'm at so far. It's not perfect. In fact, looking at it, I was focused on img src HTML statements and completely overlooked links in body text (eg. "You can download an example file here ..." ). So, I'll need to patch that up.
I'm out of time for tonight. I have some other things to do, but will get back to this soon.
This version<https://1drv.ms/u/s!ArASQL2pSWgomUx_1ksXsCcFOETh?e=p3dthW> has every image in one monolithic folder, which avoids cross-directory links. I'm still thinking about how to split images into version folders in an automated way.... It also has broken links in comments. Have a look if you have time.
[https://outlook-1.cdn.office.net/assets/mail/file-icon/png/generic_16x16.png]asciidoc-tutorials.tgz<https://1drv.ms/u/s!ArASQL2pSWgomUx_1ksXsCcFOETh?e=p3dthW>
Peter
________________________________
From: Peter Blemel <pb...@hotmail.com>
Sent: Tuesday, January 25, 2022 7:19 PM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>
Subject: Re: "Original" NB tutorials?
A good example of a tutorial that cross-linked images was version 8.0's IDE tutorial, which used 7.2's images by path.
The result can be seen in your current tutorial here:
https://github.com/vieiro/netbeans-website/blob/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials/80/nbm-ide.asciidoc
This tutorial has broken links because it points to
https://github.com/vieiro/netbeans-website/blob/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials/80/images/ide_72_new-project-1.png
There is no file by this name in the 80/images folder, or even in the 72/images folder. Something has erroneously inserted the ide_72_ path. Even making the path 72/images/new-project-1.png might or might not be correct. That depends on how many other '72' tutorials also used the name new-project-1.png and which one you kept.
So, the problem is coming up with a general-purpose solution that maintains the directory structure. My current "best effort" puts all images into a single folder. It was my first attempt at being sure that every single image anywhere in the tutorial hierarchy points to the correct image, because putting things into subfolders like 72/images means I have to patch up any tutorial that cross-linked a prior version.
Messy. And, so far I can't say if I got them all - but the solution seems to generalize well.
Peter
________________________________
From: Peter Blemel <pb...@hotmail.com>
Sent: Tuesday, January 25, 2022 6:32 PM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>
Subject: Re: "Original" NB tutorials?
Antonio,
I'm looking at what you've done in the context of what I've learned 🙂. I've spent some time on this this afternoon. Here's what I understand now:
1. The old tutorials images used a hierarchical structure that matched the tutorials. They were organized by tutorial name and then version. Each folder had both images and sub-folders for each release containing images. To illustrate the problem, let's pick result-1 and result-2 to illustrate what's happening. There are many "result-1.png"s in lots of 72 subdirectories. This was okay because they were all unique under their path.
-rw-r----- 1 peter peter 12K Dec 12 2019 ./cc/72/result-1.png
-rw-r----- 1 peter peter 65K Dec 12 2019 ./crud/72/result-1.png
-rw-r----- 1 peter peter 7.1K Dec 12 2019 ./hint/72/result-1.png
-rw-r----- 1 peter peter 126K Dec 12 2019 ./htmleditor/72/result-1.png
-rw-r----- 1 peter peter 17K Dec 12 2019 ./javacc/72/result-1.png
-rw-r----- 1 peter peter 68K Dec 12 2019 ./javafx/72/result-1.png
-rw-r----- 1 peter peter 5.4K Dec 12 2019 ./mark-occs/72/result-1.png
-rw-r----- 1 peter peter 32K Dec 12 2019 ./maven-crud/72/result-1.png
-rw-r----- 1 peter peter 37K Dec 12 2019 ./maven-quickstart/72/result-1.png
-rw-r----- 1 peter peter 7.4K Dec 12 2019 ./projecttypes/72pics/result-1.png
-rw-r----- 1 peter peter 14K Dec 12 2019 ./qsearch/72/result-1.png
o The new site reverses this, decomposing by version first and then the tutorials. Now, instead of '{tutorial}/72/result-1.png', you have '72/images/result-1.png'. Exactly one. Which one of these is in that folder?
-rw-r----- 1 peter peter 68K Jan 25 18:17 result-1.png
Judging by the size, I'd say you kept the one from "javafx". Every other tutorial now gets "javafx"'s result-1.png because they are all in the '72' folder and all use the same "graphics" folder. The same thing happens for every other release number.
2 Not all tutorials used only illustrations from their own directories. In some cases, they re-used graphics from a previous version, so there was some cross-linking between folders.
I have taken two approaches:
1. The first simply re-used last night's work, mapping every path/to/image.png onto a corresponding path-to-image.png in a single directory. Using this approach, we get :
-rw-r----- 1 peter peter 12152 Dec 12 2019 ./cc-72-result-1.png
-rw-r----- 1 peter peter 65580 Dec 12 2019 ./crud-72-result-1.png
-rw-r----- 1 peter peter 7238 Dec 12 2019 ./hint-72-result-1.png
-rw-r----- 1 peter peter 128879 Dec 12 2019 ./htmleditor-72-result-1.png
-rw-r----- 1 peter peter 16721 Dec 12 2019 ./javacc-72-result-1.png
-rw-r----- 1 peter peter 68977 Dec 12 2019 ./javafx-72-result-1.png
-rw-r----- 1 peter peter 5444 Dec 12 2019 ./mark-occs-72-result-1.png
-rw-r----- 1 peter peter 32202 Dec 12 2019 ./maven-crud-72-result-1.png
-rw-r----- 1 peter peter 37059 Dec 12 2019 ./maven-quickstart-72-result-1.png
-rw-r----- 1 peter peter 14205 Dec 12 2019 ./qsearch-72-result-1.png
I'm not sure if I pasted all of them, but you get the point.
I then wrote a script that fixes every .asciidoc version of the tutorial in-place to match this new naming scheme.
2. The problem with #1 was that my script put everything into one monolithic "legacy" folder. So, right now I am putting the finishing touches on putting all of the '72' images into the 72/graphics folder and massaging the .asciidoc files to make that. This will be close to what you have now.
As near as I can tell, your changes do not address the problem above. Let me know if I misunderstand.
Respectfully,
Peter
________________________________
From: antonio <an...@vieiro.net>
Sent: Tuesday, January 25, 2022 4:12 PM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>
Subject: Re: "Original" NB tutorials?
Hi Peter,
I think we have it! What about the tutorials at
https://github.com/vieiro/netbeans-website/tree/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials
For instance
https://github.com/vieiro/netbeans-website/blob/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials/nbm-javacc-lexer.asciidoc
https://github.com/vieiro/netbeans-website/blob/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials/nbm-code-completion.asciidoc
Do these look better now?
Thanks,
Antonio
El 24/1/22 a las 15:50, Peter Blemel escribió:
> Antonio,
>
> I haven't been through all of the tutorials, but many of the ones that I've been looking at have problems. For example,
> https://netbeans.apache.org/tutorials/nbm-javacc-lexer.html has "stock trader" graphics.
> https://netbeans.apache.org/tutorials/nbm-copyfqn.html has "POV Ray" graphics
> https://netbeans.apache.org/tutorials/nbm-code-completion.html Stock trader
> https://netbeans.apache.org/tutorials/nbm-java-hint.html Stock trader
> and so on.
>
> It looks like the tutorials each used to live in its own directory, many using the same file name for their individual graphics - which was fine because the directory structure at the time kept the file names from colliding with each other. When they were subsequently all put into one folder, files with the same name became a problem. Each tutorial copied into the directory overwrote files already there. Now they all link to the same graphic because the individual graphics were not renamed.
>
> Brad suggested re-creating the images to bring them up-to-date. That will take some time. Giving all of the old files unique file names and fixing each HTML file is also a lot of work. Another, easier solution is to rebuild the tutorials folder using the original directory structure. That will not bring the graphics up to date, but will solve the problem in an expedient way.
>
> Best,
> Peter
>
> ________________________________
> From: antonio <an...@vieiro.net>
> Sent: Monday, January 24, 2022 12:01 AM
> To: dev@netbeans.apache.org <de...@netbeans.apache.org>
> Subject: Re: "Original" NB tutorials?
>
> Hi Peter,
>
> Originals are kept here for reference
>
> https://github.com/wadechandler/netbeans-static-site (src/content)
>
> Cheers,
> Antonio
>
> P.S.: I'm curious, which illustrations are incorrect?
>
>
> El 24/1/22 a las 3:18, Peter Blemel escribió:
>> Hi,
>>
>> After looking through the tutorials, the thing that jumps out at me the most is that many of them have incorrect illustrations. I used many of these tutorials "back in the day", and recall that the illustrations were not such a jumble. If someone can point me to the original directories from before they were moved, I will try to get the right images back into their respective tutorials in the GitHub repo before moving on to updating individual tutorials.
>>
>> Thanks,
>> Peter
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.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-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by Peter Blemel <pb...@hotmail.com>.
A good example of a tutorial that cross-linked images was version 8.0's IDE tutorial, which used 7.2's images by path.
The result can be seen in your current tutorial here:
https://github.com/vieiro/netbeans-website/blob/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials/80/nbm-ide.asciidoc
This tutorial has broken links because it points to
https://github.com/vieiro/netbeans-website/blob/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials/80/images/ide_72_new-project-1.png
There is no file by this name in the 80/images folder, or even in the 72/images folder. Something has erroneously inserted the ide_72_ path. Even making the path 72/images/new-project-1.png might or might not be correct. That depends on how many other '72' tutorials also used the name new-project-1.png and which one you kept.
So, the problem is coming up with a general-purpose solution that maintains the directory structure. My current "best effort" puts all images into a single folder. It was my first attempt at being sure that every single image anywhere in the tutorial hierarchy points to the correct image, because putting things into subfolders like 72/images means I have to patch up any tutorial that cross-linked a prior version.
Messy. And, so far I can't say if I got them all - but the solution seems to generalize well.
Peter
________________________________
From: Peter Blemel <pb...@hotmail.com>
Sent: Tuesday, January 25, 2022 6:32 PM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>
Subject: Re: "Original" NB tutorials?
Antonio,
I'm looking at what you've done in the context of what I've learned 🙂. I've spent some time on this this afternoon. Here's what I understand now:
1. The old tutorials images used a hierarchical structure that matched the tutorials. They were organized by tutorial name and then version. Each folder had both images and sub-folders for each release containing images. To illustrate the problem, let's pick result-1 and result-2 to illustrate what's happening. There are many "result-1.png"s in lots of 72 subdirectories. This was okay because they were all unique under their path.
-rw-r----- 1 peter peter 12K Dec 12 2019 ./cc/72/result-1.png
-rw-r----- 1 peter peter 65K Dec 12 2019 ./crud/72/result-1.png
-rw-r----- 1 peter peter 7.1K Dec 12 2019 ./hint/72/result-1.png
-rw-r----- 1 peter peter 126K Dec 12 2019 ./htmleditor/72/result-1.png
-rw-r----- 1 peter peter 17K Dec 12 2019 ./javacc/72/result-1.png
-rw-r----- 1 peter peter 68K Dec 12 2019 ./javafx/72/result-1.png
-rw-r----- 1 peter peter 5.4K Dec 12 2019 ./mark-occs/72/result-1.png
-rw-r----- 1 peter peter 32K Dec 12 2019 ./maven-crud/72/result-1.png
-rw-r----- 1 peter peter 37K Dec 12 2019 ./maven-quickstart/72/result-1.png
-rw-r----- 1 peter peter 7.4K Dec 12 2019 ./projecttypes/72pics/result-1.png
-rw-r----- 1 peter peter 14K Dec 12 2019 ./qsearch/72/result-1.png
o The new site reverses this, decomposing by version first and then the tutorials. Now, instead of '{tutorial}/72/result-1.png', you have '72/images/result-1.png'. Exactly one. Which one of these is in that folder?
-rw-r----- 1 peter peter 68K Jan 25 18:17 result-1.png
Judging by the size, I'd say you kept the one from "javafx". Every other tutorial now gets "javafx"'s result-1.png because they are all in the '72' folder and all use the same "graphics" folder. The same thing happens for every other release number.
2 Not all tutorials used only illustrations from their own directories. In some cases, they re-used graphics from a previous version, so there was some cross-linking between folders.
I have taken two approaches:
1. The first simply re-used last night's work, mapping every path/to/image.png onto a corresponding path-to-image.png in a single directory. Using this approach, we get :
-rw-r----- 1 peter peter 12152 Dec 12 2019 ./cc-72-result-1.png
-rw-r----- 1 peter peter 65580 Dec 12 2019 ./crud-72-result-1.png
-rw-r----- 1 peter peter 7238 Dec 12 2019 ./hint-72-result-1.png
-rw-r----- 1 peter peter 128879 Dec 12 2019 ./htmleditor-72-result-1.png
-rw-r----- 1 peter peter 16721 Dec 12 2019 ./javacc-72-result-1.png
-rw-r----- 1 peter peter 68977 Dec 12 2019 ./javafx-72-result-1.png
-rw-r----- 1 peter peter 5444 Dec 12 2019 ./mark-occs-72-result-1.png
-rw-r----- 1 peter peter 32202 Dec 12 2019 ./maven-crud-72-result-1.png
-rw-r----- 1 peter peter 37059 Dec 12 2019 ./maven-quickstart-72-result-1.png
-rw-r----- 1 peter peter 14205 Dec 12 2019 ./qsearch-72-result-1.png
I'm not sure if I pasted all of them, but you get the point.
I then wrote a script that fixes every .asciidoc version of the tutorial in-place to match this new naming scheme.
2. The problem with #1 was that my script put everything into one monolithic "legacy" folder. So, right now I am putting the finishing touches on putting all of the '72' images into the 72/graphics folder and massaging the .asciidoc files to make that. This will be close to what you have now.
As near as I can tell, your changes do not address the problem above. Let me know if I misunderstand.
Respectfully,
Peter
________________________________
From: antonio <an...@vieiro.net>
Sent: Tuesday, January 25, 2022 4:12 PM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>
Subject: Re: "Original" NB tutorials?
Hi Peter,
I think we have it! What about the tutorials at
https://github.com/vieiro/netbeans-website/tree/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials
For instance
https://github.com/vieiro/netbeans-website/blob/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials/nbm-javacc-lexer.asciidoc
https://github.com/vieiro/netbeans-website/blob/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials/nbm-code-completion.asciidoc
Do these look better now?
Thanks,
Antonio
El 24/1/22 a las 15:50, Peter Blemel escribió:
> Antonio,
>
> I haven't been through all of the tutorials, but many of the ones that I've been looking at have problems. For example,
> https://netbeans.apache.org/tutorials/nbm-javacc-lexer.html has "stock trader" graphics.
> https://netbeans.apache.org/tutorials/nbm-copyfqn.html has "POV Ray" graphics
> https://netbeans.apache.org/tutorials/nbm-code-completion.html Stock trader
> https://netbeans.apache.org/tutorials/nbm-java-hint.html Stock trader
> and so on.
>
> It looks like the tutorials each used to live in its own directory, many using the same file name for their individual graphics - which was fine because the directory structure at the time kept the file names from colliding with each other. When they were subsequently all put into one folder, files with the same name became a problem. Each tutorial copied into the directory overwrote files already there. Now they all link to the same graphic because the individual graphics were not renamed.
>
> Brad suggested re-creating the images to bring them up-to-date. That will take some time. Giving all of the old files unique file names and fixing each HTML file is also a lot of work. Another, easier solution is to rebuild the tutorials folder using the original directory structure. That will not bring the graphics up to date, but will solve the problem in an expedient way.
>
> Best,
> Peter
>
> ________________________________
> From: antonio <an...@vieiro.net>
> Sent: Monday, January 24, 2022 12:01 AM
> To: dev@netbeans.apache.org <de...@netbeans.apache.org>
> Subject: Re: "Original" NB tutorials?
>
> Hi Peter,
>
> Originals are kept here for reference
>
> https://github.com/wadechandler/netbeans-static-site (src/content)
>
> Cheers,
> Antonio
>
> P.S.: I'm curious, which illustrations are incorrect?
>
>
> El 24/1/22 a las 3:18, Peter Blemel escribió:
>> Hi,
>>
>> After looking through the tutorials, the thing that jumps out at me the most is that many of them have incorrect illustrations. I used many of these tutorials "back in the day", and recall that the illustrations were not such a jumble. If someone can point me to the original directories from before they were moved, I will try to get the right images back into their respective tutorials in the GitHub repo before moving on to updating individual tutorials.
>>
>> Thanks,
>> Peter
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.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-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by Peter Blemel <pb...@hotmail.com>.
Antonio,
I'm looking at what you've done in the context of what I've learned 🙂. I've spent some time on this this afternoon. Here's what I understand now:
1. The old tutorials images used a hierarchical structure that matched the tutorials. They were organized by tutorial name and then version. Each folder had both images and sub-folders for each release containing images. To illustrate the problem, let's pick result-1 and result-2 to illustrate what's happening. There are many "result-1.png"s in lots of 72 subdirectories. This was okay because they were all unique under their path.
-rw-r----- 1 peter peter 12K Dec 12 2019 ./cc/72/result-1.png
-rw-r----- 1 peter peter 65K Dec 12 2019 ./crud/72/result-1.png
-rw-r----- 1 peter peter 7.1K Dec 12 2019 ./hint/72/result-1.png
-rw-r----- 1 peter peter 126K Dec 12 2019 ./htmleditor/72/result-1.png
-rw-r----- 1 peter peter 17K Dec 12 2019 ./javacc/72/result-1.png
-rw-r----- 1 peter peter 68K Dec 12 2019 ./javafx/72/result-1.png
-rw-r----- 1 peter peter 5.4K Dec 12 2019 ./mark-occs/72/result-1.png
-rw-r----- 1 peter peter 32K Dec 12 2019 ./maven-crud/72/result-1.png
-rw-r----- 1 peter peter 37K Dec 12 2019 ./maven-quickstart/72/result-1.png
-rw-r----- 1 peter peter 7.4K Dec 12 2019 ./projecttypes/72pics/result-1.png
-rw-r----- 1 peter peter 14K Dec 12 2019 ./qsearch/72/result-1.png
o The new site reverses this, decomposing by version first and then the tutorials. Now, instead of '{tutorial}/72/result-1.png', you have '72/images/result-1.png'. Exactly one. Which one of these is in that folder?
-rw-r----- 1 peter peter 68K Jan 25 18:17 result-1.png
Judging by the size, I'd say you kept the one from "javafx". Every other tutorial now gets "javafx"'s result-1.png because they are all in the '72' folder and all use the same "graphics" folder. The same thing happens for every other release number.
2 Not all tutorials used only illustrations from their own directories. In some cases, they re-used graphics from a previous version, so there was some cross-linking between folders.
I have taken two approaches:
1. The first simply re-used last night's work, mapping every path/to/image.png onto a corresponding path-to-image.png in a single directory. Using this approach, we get :
-rw-r----- 1 peter peter 12152 Dec 12 2019 ./cc-72-result-1.png
-rw-r----- 1 peter peter 65580 Dec 12 2019 ./crud-72-result-1.png
-rw-r----- 1 peter peter 7238 Dec 12 2019 ./hint-72-result-1.png
-rw-r----- 1 peter peter 128879 Dec 12 2019 ./htmleditor-72-result-1.png
-rw-r----- 1 peter peter 16721 Dec 12 2019 ./javacc-72-result-1.png
-rw-r----- 1 peter peter 68977 Dec 12 2019 ./javafx-72-result-1.png
-rw-r----- 1 peter peter 5444 Dec 12 2019 ./mark-occs-72-result-1.png
-rw-r----- 1 peter peter 32202 Dec 12 2019 ./maven-crud-72-result-1.png
-rw-r----- 1 peter peter 37059 Dec 12 2019 ./maven-quickstart-72-result-1.png
-rw-r----- 1 peter peter 14205 Dec 12 2019 ./qsearch-72-result-1.png
I'm not sure if I pasted all of them, but you get the point.
I then wrote a script that fixes every .asciidoc version of the tutorial in-place to match this new naming scheme.
2. The problem with #1 was that my script put everything into one monolithic "legacy" folder. So, right now I am putting the finishing touches on putting all of the '72' images into the 72/graphics folder and massaging the .asciidoc files to make that. This will be close to what you have now.
As near as I can tell, your changes do not address the problem above. Let me know if I misunderstand.
Respectfully,
Peter
________________________________
From: antonio <an...@vieiro.net>
Sent: Tuesday, January 25, 2022 4:12 PM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>
Subject: Re: "Original" NB tutorials?
Hi Peter,
I think we have it! What about the tutorials at
https://github.com/vieiro/netbeans-website/tree/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials
For instance
https://github.com/vieiro/netbeans-website/blob/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials/nbm-javacc-lexer.asciidoc
https://github.com/vieiro/netbeans-website/blob/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials/nbm-code-completion.asciidoc
Do these look better now?
Thanks,
Antonio
El 24/1/22 a las 15:50, Peter Blemel escribió:
> Antonio,
>
> I haven't been through all of the tutorials, but many of the ones that I've been looking at have problems. For example,
> https://netbeans.apache.org/tutorials/nbm-javacc-lexer.html has "stock trader" graphics.
> https://netbeans.apache.org/tutorials/nbm-copyfqn.html has "POV Ray" graphics
> https://netbeans.apache.org/tutorials/nbm-code-completion.html Stock trader
> https://netbeans.apache.org/tutorials/nbm-java-hint.html Stock trader
> and so on.
>
> It looks like the tutorials each used to live in its own directory, many using the same file name for their individual graphics - which was fine because the directory structure at the time kept the file names from colliding with each other. When they were subsequently all put into one folder, files with the same name became a problem. Each tutorial copied into the directory overwrote files already there. Now they all link to the same graphic because the individual graphics were not renamed.
>
> Brad suggested re-creating the images to bring them up-to-date. That will take some time. Giving all of the old files unique file names and fixing each HTML file is also a lot of work. Another, easier solution is to rebuild the tutorials folder using the original directory structure. That will not bring the graphics up to date, but will solve the problem in an expedient way.
>
> Best,
> Peter
>
> ________________________________
> From: antonio <an...@vieiro.net>
> Sent: Monday, January 24, 2022 12:01 AM
> To: dev@netbeans.apache.org <de...@netbeans.apache.org>
> Subject: Re: "Original" NB tutorials?
>
> Hi Peter,
>
> Originals are kept here for reference
>
> https://github.com/wadechandler/netbeans-static-site (src/content)
>
> Cheers,
> Antonio
>
> P.S.: I'm curious, which illustrations are incorrect?
>
>
> El 24/1/22 a las 3:18, Peter Blemel escribió:
>> Hi,
>>
>> After looking through the tutorials, the thing that jumps out at me the most is that many of them have incorrect illustrations. I used many of these tutorials "back in the day", and recall that the illustrations were not such a jumble. If someone can point me to the original directories from before they were moved, I will try to get the right images back into their respective tutorials in the GitHub repo before moving on to updating individual tutorials.
>>
>> Thanks,
>> Peter
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.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-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by antonio <an...@vieiro.net>.
Hi Peter,
I think we have it! What about the tutorials at
https://github.com/vieiro/netbeans-website/tree/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials
For instance
https://github.com/vieiro/netbeans-website/blob/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials/nbm-javacc-lexer.asciidoc
https://github.com/vieiro/netbeans-website/blob/hotfix/images-for-tutorials/netbeans.apache.org/src/content/tutorials/nbm-code-completion.asciidoc
Do these look better now?
Thanks,
Antonio
El 24/1/22 a las 15:50, Peter Blemel escribió:
> Antonio,
>
> I haven't been through all of the tutorials, but many of the ones that I've been looking at have problems. For example,
> https://netbeans.apache.org/tutorials/nbm-javacc-lexer.html has "stock trader" graphics.
> https://netbeans.apache.org/tutorials/nbm-copyfqn.html has "POV Ray" graphics
> https://netbeans.apache.org/tutorials/nbm-code-completion.html Stock trader
> https://netbeans.apache.org/tutorials/nbm-java-hint.html Stock trader
> and so on.
>
> It looks like the tutorials each used to live in its own directory, many using the same file name for their individual graphics - which was fine because the directory structure at the time kept the file names from colliding with each other. When they were subsequently all put into one folder, files with the same name became a problem. Each tutorial copied into the directory overwrote files already there. Now they all link to the same graphic because the individual graphics were not renamed.
>
> Brad suggested re-creating the images to bring them up-to-date. That will take some time. Giving all of the old files unique file names and fixing each HTML file is also a lot of work. Another, easier solution is to rebuild the tutorials folder using the original directory structure. That will not bring the graphics up to date, but will solve the problem in an expedient way.
>
> Best,
> Peter
>
> ________________________________
> From: antonio <an...@vieiro.net>
> Sent: Monday, January 24, 2022 12:01 AM
> To: dev@netbeans.apache.org <de...@netbeans.apache.org>
> Subject: Re: "Original" NB tutorials?
>
> Hi Peter,
>
> Originals are kept here for reference
>
> https://github.com/wadechandler/netbeans-static-site (src/content)
>
> Cheers,
> Antonio
>
> P.S.: I'm curious, which illustrations are incorrect?
>
>
> El 24/1/22 a las 3:18, Peter Blemel escribió:
>> Hi,
>>
>> After looking through the tutorials, the thing that jumps out at me the most is that many of them have incorrect illustrations. I used many of these tutorials "back in the day", and recall that the illustrations were not such a jumble. If someone can point me to the original directories from before they were moved, I will try to get the right images back into their respective tutorials in the GitHub repo before moving on to updating individual tutorials.
>>
>> Thanks,
>> Peter
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.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-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by Brad Hards <br...@frogmouth.net>.
On Wednesday, 26 January 2022 7:34:09 AM AEDT antonio wrote:
> Yep, .html files have an exact match to .asciidoc files (but for certain
> index files, see [2]).
When merging, please remember that some of the tutorials have already been
updated. So that archive is not 1:1 with the current content.
Brad
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by antonio <an...@vieiro.net>.
Hi Peter,
Yep, .html files have an exact match to .asciidoc files (but for certain
index files, see [2]).
No git really required. You can download the whole website as a zip file
from [1]. The directory you're looking for is
"netbeans.apache.org/src/content/tutorials/" (you may want to unzip that
one only).
Once done we can tackle the git aspects :-).
Cheers,
Antonio
P.S.: I was thinking we may want to use a Lua script instead...
[1]
https://github.com/apache/netbeans-website/archive/refs/heads/master.zip
[2]
#!/usr/bin/env sh
# Run this on the directory containing asciidoc files
HTML_DIRECTORY=/home/antonio/REPOS/NETBEANS/platform-tutorials/tutorials
IMAGE_DIRECTORY=/home/antonio/REPOS/NETBEANS/platform-tutorials/images/
for A in `find . -name "*.asciidoc"`
do
H_NAME=`echo $A | sed 's-asciidoc-html-g'`
H="$HTML_DIRECTORY/$H_NAME"
if [ ! -f $H ]; then
echo "Missing HTML file for $A"
exit 1
fi
echo "$A - $H_NAME"
done
---
[...]
./70/nbm-maven-modulesuite_ru.asciidoc - ./70/nbm-maven-modulesuite_ru.html
./70/nbm-quick-search.asciidoc - ./70/nbm-quick-search.html
./70/nbm-code-generator_pt_BR.asciidoc - ./70/nbm-code-generator_pt_BR.html
./70/nbm-visual_library3.asciidoc - ./70/nbm-visual_library3.html
Missing HTML file for ./70/index_zh_CN.asciidoc
---
This means that "index_zh_CN.asciidoc" has not a corresponding
"./70/index_zh_CN.html" file. You can probably dismiss that one.
El 25/1/22 a las 20:44, Peter Blemel escribió:
> Getting unique image names was probably the heavier lift. If I know
> which html file is the original for which asciidoc file, I can probably
> write a script to fix up the image file names in the asciidoc. Is it
> safe to assume that the "latest" html file was used for the current
> asciidoc file? I can clone the repo. I personally use Mercurial, so I'll
> need to brush up on my git fu to push any changes back.
>
> From there, I can maybe start updating the images themselves as I work
> through the tutorials.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by Peter Blemel <pb...@hotmail.com>.
Antonio,
Getting unique image names was probably the heavier lift. If I know which html file is the original for which asciidoc file, I can probably write a script to fix up the image file names in the asciidoc. Is it safe to assume that the "latest" html file was used for the current asciidoc file? I can clone the repo. I personally use Mercurial, so I'll need to brush up on my git fu to push any changes back.
From there, I can maybe start updating the images themselves as I work through the tutorials.
Peter
________________________________
From: antonio <an...@vieiro.net>
Sent: Tuesday, January 25, 2022 11:52 AM
To: Peter Blemel <pb...@hotmail.com>; dev@netbeans.apache.org <de...@netbeans.apache.org>
Subject: Re: "Original" NB tutorials?
Hi Peter,
Thanks for this. I'm afraid we'll have to update the asciidoc translated
files (not the HTML ones), because there have been updates since the
migration (2018 perhaps?), and if we run the HTML>Asciidoc tool again on
these we'll miss many changes.
If you're busy I'll try to give it a run during the weekend or so.
Kind regards,
Antonio
On 25/01/2022 11:43, Peter Blemel wrote:
> I don't know what Outlook / OneDrive did to that link. Lets try again
> <https://1drv.ms/u/s!ArASQL2pSWgomUonDIkTyvHqKESd?e=9u8l5d>
>
> flat-tutorials.tgz
> <https://1drv.ms/u/s!ArASQL2pSWgomUonDIkTyvHqKESd?e=9u8l5d>
Re: "Original" NB tutorials?
Posted by antonio <an...@vieiro.net>.
Hi Peter,
Thanks for this. I'm afraid we'll have to update the asciidoc translated
files (not the HTML ones), because there have been updates since the
migration (2018 perhaps?), and if we run the HTML>Asciidoc tool again on
these we'll miss many changes.
If you're busy I'll try to give it a run during the weekend or so.
Kind regards,
Antonio
On 25/01/2022 11:43, Peter Blemel wrote:
> I don't know what Outlook / OneDrive did to that link. Lets try again
> <https://1drv.ms/u/s!ArASQL2pSWgomUonDIkTyvHqKESd?e=9u8l5d>
>
> flat-tutorials.tgz
> <https://1drv.ms/u/s!ArASQL2pSWgomUonDIkTyvHqKESd?e=9u8l5d>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by Peter Blemel <pb...@hotmail.com>.
I don't know what Outlook / OneDrive did to that link. Lets try again<https://1drv.ms/u/s!ArASQL2pSWgomUonDIkTyvHqKESd?e=9u8l5d>
[https://outlook-2.cdn.office.net/assets/mail/file-icon/png/generic_16x16.png]flat-tutorials.tgz<https://1drv.ms/u/s!ArASQL2pSWgomUonDIkTyvHqKESd?e=9u8l5d>
________________________________
From: Peter Blemel <pb...@hotmail.com>
Sent: Tuesday, January 25, 2022 3:39 AM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>; antonio <an...@vieiro.net>
Subject: Re: "Original" NB tutorials?
I decided to let it run while I finished something else. Here's a first pass at flattening everything. I didn't realize that some of the tutorial folders had resources in them (eg tutorials/80/new.png) so I'll need to fix those,
but here's what I have so far. There's likely some mistakes that I'll need to clean up.
I blew away the .svn folders. They don't make any sense with everything flattened. I basically turned/every/path into turned-every-path.
Peter
[https://outlook-1.cdn.office.net/assets/mail/file-icon/png/generic_16x16.png]flat-tutorials.tgz<https://1drv.ms/u/s!ArASQL2pSWgomUonDIkTyvHqKESd>
________________________________
From: antonio <an...@vieiro.net>
Sent: Tuesday, January 25, 2022 1:46 AM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>
Subject: Re: "Original" NB tutorials?
Hi,
Well, the tutorial section was committed around 2019, AFAIR, I don't see
a reason we should hurry now :-).
Thanks,
Antonio
El 25/1/22 a las 9:11, Peter Blemel escribió:
> Seems pretty straightforward, but it's 1AM here in my timezone 🙂. So, I will probably get to this sometime in the next few days, maybe over the weekend.
>
> Thanks,
> Peter
>
> ________________________________
> From: antonio <an...@vieiro.net>
> Sent: Tuesday, January 25, 2022 1:04 AM
> To: dev@netbeans.apache.org <de...@netbeans.apache.org>
> Subject: Re: "Original" NB tutorials?
>
> Of course!
>
> images.tgz: https://ufile.io/twj9inhm
> tutorials.tgz: https://ufile.io/qpk1abf3
>
> Note that "tutorials.tgz" has the original HTML file of each tutorial
> (i.e., not transformed to asciidoc). For instance "nbm-java-hint.html"
> is related to "nbm-java-hint.asciidoc" now [1].
>
> What I was thinking is that it would be easier to scan the images in
> each asciidoc file (with a sed script), find the proper equivalent in
> "images.tgz", copy the proper image (with a prefix that could be the
> name of the tutorial, for instance) and update the asciidoc file.
>
> Let me know if you need any assistance on this.
>
> Thanks & kind regards,
> Antonio
>
> [1]
> https://github.com/apache/netbeans-website/blob/master/netbeans.apache.org/src/content/tutorials/nbm-java-hint.asciidoc
>
> El 25/1/22 a las 8:49, Peter Blemel escribió:
>> Antonio,
>>
>> I have much experience with sed/etc and moving files around en-masse on the file system using scripting. If you want, I can probably write a script to give each graphic/illustration a unique name based on its original folder and merge the directories in pretty short order. I'd just need to get a tarball/zip of everything from you.
>>
>> Peter
>>
>> ________________________________
>> From: antonio <an...@vieiro.net>
>> Sent: Tuesday, January 25, 2022 12:42 AM
>> To: dev@netbeans.apache.org <de...@netbeans.apache.org>
>> Subject: Re: "Original" NB tutorials?
>>
>> Hi Peter,
>>
>> Thanks for detecting this!
>>
>> The "/tutorials" path in netbeans.apache.org comes from
>> "http://platform.netbeans.org/tutorials", this is, it comes from the
>> domain "platform.netbeans.org" and not from "www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org>>>>". So these
>> are not available in Wade Chandler's copy of "www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org>>>>".
>>
>> The "platform.netbeans.org" web comes from these two svn repositories:
>>
>> - https://svn.netbeans.org/svn/platform~platform-content/trunk/tutorials/
>> - https://svn.netbeans.org/svn/platform~platform-content/trunk/images/
>>
>> These are not currently available now, but we're lucky I still keep a
>> clone of these repositories on my hard disk and, as you say, images do
>> indeed come from different directories and were overwroten in the migration.
>>
>> These are 1476 tutorials (for different NetBeans versions which are now
>> outdated) and possibly even for different languages [1].
>>
>> I'll see what I can do to recover the proper images in each tutorial.
>>
>> Thanks & kind regards,
>> Antonio
>>
>>
>>
>> [1]
>> The nbm-java-hint tutorial has these versions online
>>
>> https://netbeans.apache.org/tutorials/67/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/68/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/691/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/69/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/70/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/71/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/72/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/73/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/74/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/80/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/nbm-java-hint.html
>>
>>
>>
>>
>> El 24/1/22 a las 15:50, Peter Blemel escribió:
>>> I haven't been through all of the tutorials, but many of the ones that I've been looking at have problems. For example,
>>> https://netbeans.apache.org/tutorials/nbm-javacc-lexer.html has "stock trader" graphics.
>>> https://netbeans.apache.org/tutorials/nbm-copyfqn.html has "POV Ray" graphics
>>> https://netbeans.apache.org/tutorials/nbm-code-completion.html Stock trader
>>> https://netbeans.apache.org/tutorials/nbm-java-hint.html Stock trader
>>> and so on.
>>>
>>> It looks like the tutorials each used to live in its own directory, many using the same file name for their individual graphics - which was fine because the directory structure at the time kept the file names from colliding with each other. When they were subsequently all put into one folder, files with the same name became a problem. Each tutorial copied into the directory overwrote files already there. Now they all link to the same graphic because the individual graphics were not renamed.
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
>> For additional commands, e-mail: dev-help@netbeans.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-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.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-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by Peter Blemel <pb...@hotmail.com>.
I decided to let it run while I finished something else. Here's a first pass at flattening everything. I didn't realize that some of the tutorial folders had resources in them (eg tutorials/80/new.png) so I'll need to fix those,
but here's what I have so far. There's likely some mistakes that I'll need to clean up.
I blew away the .svn folders. They don't make any sense with everything flattened. I basically turned/every/path into turned-every-path.
Peter
[https://outlook-1.cdn.office.net/assets/mail/file-icon/png/generic_16x16.png]flat-tutorials.tgz<https://1drv.ms/u/s!ArASQL2pSWgomUonDIkTyvHqKESd>
________________________________
From: antonio <an...@vieiro.net>
Sent: Tuesday, January 25, 2022 1:46 AM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>
Subject: Re: "Original" NB tutorials?
Hi,
Well, the tutorial section was committed around 2019, AFAIR, I don't see
a reason we should hurry now :-).
Thanks,
Antonio
El 25/1/22 a las 9:11, Peter Blemel escribió:
> Seems pretty straightforward, but it's 1AM here in my timezone 🙂. So, I will probably get to this sometime in the next few days, maybe over the weekend.
>
> Thanks,
> Peter
>
> ________________________________
> From: antonio <an...@vieiro.net>
> Sent: Tuesday, January 25, 2022 1:04 AM
> To: dev@netbeans.apache.org <de...@netbeans.apache.org>
> Subject: Re: "Original" NB tutorials?
>
> Of course!
>
> images.tgz: https://ufile.io/twj9inhm
> tutorials.tgz: https://ufile.io/qpk1abf3
>
> Note that "tutorials.tgz" has the original HTML file of each tutorial
> (i.e., not transformed to asciidoc). For instance "nbm-java-hint.html"
> is related to "nbm-java-hint.asciidoc" now [1].
>
> What I was thinking is that it would be easier to scan the images in
> each asciidoc file (with a sed script), find the proper equivalent in
> "images.tgz", copy the proper image (with a prefix that could be the
> name of the tutorial, for instance) and update the asciidoc file.
>
> Let me know if you need any assistance on this.
>
> Thanks & kind regards,
> Antonio
>
> [1]
> https://github.com/apache/netbeans-website/blob/master/netbeans.apache.org/src/content/tutorials/nbm-java-hint.asciidoc
>
> El 25/1/22 a las 8:49, Peter Blemel escribió:
>> Antonio,
>>
>> I have much experience with sed/etc and moving files around en-masse on the file system using scripting. If you want, I can probably write a script to give each graphic/illustration a unique name based on its original folder and merge the directories in pretty short order. I'd just need to get a tarball/zip of everything from you.
>>
>> Peter
>>
>> ________________________________
>> From: antonio <an...@vieiro.net>
>> Sent: Tuesday, January 25, 2022 12:42 AM
>> To: dev@netbeans.apache.org <de...@netbeans.apache.org>
>> Subject: Re: "Original" NB tutorials?
>>
>> Hi Peter,
>>
>> Thanks for detecting this!
>>
>> The "/tutorials" path in netbeans.apache.org comes from
>> "http://platform.netbeans.org/tutorials", this is, it comes from the
>> domain "platform.netbeans.org" and not from "www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org>>>". So these
>> are not available in Wade Chandler's copy of "www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org>>>".
>>
>> The "platform.netbeans.org" web comes from these two svn repositories:
>>
>> - https://svn.netbeans.org/svn/platform~platform-content/trunk/tutorials/
>> - https://svn.netbeans.org/svn/platform~platform-content/trunk/images/
>>
>> These are not currently available now, but we're lucky I still keep a
>> clone of these repositories on my hard disk and, as you say, images do
>> indeed come from different directories and were overwroten in the migration.
>>
>> These are 1476 tutorials (for different NetBeans versions which are now
>> outdated) and possibly even for different languages [1].
>>
>> I'll see what I can do to recover the proper images in each tutorial.
>>
>> Thanks & kind regards,
>> Antonio
>>
>>
>>
>> [1]
>> The nbm-java-hint tutorial has these versions online
>>
>> https://netbeans.apache.org/tutorials/67/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/68/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/691/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/69/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/70/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/71/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/72/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/73/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/74/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/80/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/nbm-java-hint.html
>>
>>
>>
>>
>> El 24/1/22 a las 15:50, Peter Blemel escribió:
>>> I haven't been through all of the tutorials, but many of the ones that I've been looking at have problems. For example,
>>> https://netbeans.apache.org/tutorials/nbm-javacc-lexer.html has "stock trader" graphics.
>>> https://netbeans.apache.org/tutorials/nbm-copyfqn.html has "POV Ray" graphics
>>> https://netbeans.apache.org/tutorials/nbm-code-completion.html Stock trader
>>> https://netbeans.apache.org/tutorials/nbm-java-hint.html Stock trader
>>> and so on.
>>>
>>> It looks like the tutorials each used to live in its own directory, many using the same file name for their individual graphics - which was fine because the directory structure at the time kept the file names from colliding with each other. When they were subsequently all put into one folder, files with the same name became a problem. Each tutorial copied into the directory overwrote files already there. Now they all link to the same graphic because the individual graphics were not renamed.
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
>> For additional commands, e-mail: dev-help@netbeans.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-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.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-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by antonio <an...@vieiro.net>.
Hi,
Well, the tutorial section was committed around 2019, AFAIR, I don't see
a reason we should hurry now :-).
Thanks,
Antonio
El 25/1/22 a las 9:11, Peter Blemel escribió:
> Seems pretty straightforward, but it's 1AM here in my timezone 🙂. So, I will probably get to this sometime in the next few days, maybe over the weekend.
>
> Thanks,
> Peter
>
> ________________________________
> From: antonio <an...@vieiro.net>
> Sent: Tuesday, January 25, 2022 1:04 AM
> To: dev@netbeans.apache.org <de...@netbeans.apache.org>
> Subject: Re: "Original" NB tutorials?
>
> Of course!
>
> images.tgz: https://ufile.io/twj9inhm
> tutorials.tgz: https://ufile.io/qpk1abf3
>
> Note that "tutorials.tgz" has the original HTML file of each tutorial
> (i.e., not transformed to asciidoc). For instance "nbm-java-hint.html"
> is related to "nbm-java-hint.asciidoc" now [1].
>
> What I was thinking is that it would be easier to scan the images in
> each asciidoc file (with a sed script), find the proper equivalent in
> "images.tgz", copy the proper image (with a prefix that could be the
> name of the tutorial, for instance) and update the asciidoc file.
>
> Let me know if you need any assistance on this.
>
> Thanks & kind regards,
> Antonio
>
> [1]
> https://github.com/apache/netbeans-website/blob/master/netbeans.apache.org/src/content/tutorials/nbm-java-hint.asciidoc
>
> El 25/1/22 a las 8:49, Peter Blemel escribió:
>> Antonio,
>>
>> I have much experience with sed/etc and moving files around en-masse on the file system using scripting. If you want, I can probably write a script to give each graphic/illustration a unique name based on its original folder and merge the directories in pretty short order. I'd just need to get a tarball/zip of everything from you.
>>
>> Peter
>>
>> ________________________________
>> From: antonio <an...@vieiro.net>
>> Sent: Tuesday, January 25, 2022 12:42 AM
>> To: dev@netbeans.apache.org <de...@netbeans.apache.org>
>> Subject: Re: "Original" NB tutorials?
>>
>> Hi Peter,
>>
>> Thanks for detecting this!
>>
>> The "/tutorials" path in netbeans.apache.org comes from
>> "http://platform.netbeans.org/tutorials", this is, it comes from the
>> domain "platform.netbeans.org" and not from "www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org>>". So these
>> are not available in Wade Chandler's copy of "www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org>>".
>>
>> The "platform.netbeans.org" web comes from these two svn repositories:
>>
>> - https://svn.netbeans.org/svn/platform~platform-content/trunk/tutorials/
>> - https://svn.netbeans.org/svn/platform~platform-content/trunk/images/
>>
>> These are not currently available now, but we're lucky I still keep a
>> clone of these repositories on my hard disk and, as you say, images do
>> indeed come from different directories and were overwroten in the migration.
>>
>> These are 1476 tutorials (for different NetBeans versions which are now
>> outdated) and possibly even for different languages [1].
>>
>> I'll see what I can do to recover the proper images in each tutorial.
>>
>> Thanks & kind regards,
>> Antonio
>>
>>
>>
>> [1]
>> The nbm-java-hint tutorial has these versions online
>>
>> https://netbeans.apache.org/tutorials/67/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/68/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/691/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/69/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/70/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/71/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/72/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/73/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/74/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/80/nbm-java-hint.html
>> https://netbeans.apache.org/tutorials/nbm-java-hint.html
>>
>>
>>
>>
>> El 24/1/22 a las 15:50, Peter Blemel escribió:
>>> I haven't been through all of the tutorials, but many of the ones that I've been looking at have problems. For example,
>>> https://netbeans.apache.org/tutorials/nbm-javacc-lexer.html has "stock trader" graphics.
>>> https://netbeans.apache.org/tutorials/nbm-copyfqn.html has "POV Ray" graphics
>>> https://netbeans.apache.org/tutorials/nbm-code-completion.html Stock trader
>>> https://netbeans.apache.org/tutorials/nbm-java-hint.html Stock trader
>>> and so on.
>>>
>>> It looks like the tutorials each used to live in its own directory, many using the same file name for their individual graphics - which was fine because the directory structure at the time kept the file names from colliding with each other. When they were subsequently all put into one folder, files with the same name became a problem. Each tutorial copied into the directory overwrote files already there. Now they all link to the same graphic because the individual graphics were not renamed.
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
>> For additional commands, e-mail: dev-help@netbeans.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-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.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-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by Peter Blemel <pb...@hotmail.com>.
Seems pretty straightforward, but it's 1AM here in my timezone 🙂. So, I will probably get to this sometime in the next few days, maybe over the weekend.
Thanks,
Peter
________________________________
From: antonio <an...@vieiro.net>
Sent: Tuesday, January 25, 2022 1:04 AM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>
Subject: Re: "Original" NB tutorials?
Of course!
images.tgz: https://ufile.io/twj9inhm
tutorials.tgz: https://ufile.io/qpk1abf3
Note that "tutorials.tgz" has the original HTML file of each tutorial
(i.e., not transformed to asciidoc). For instance "nbm-java-hint.html"
is related to "nbm-java-hint.asciidoc" now [1].
What I was thinking is that it would be easier to scan the images in
each asciidoc file (with a sed script), find the proper equivalent in
"images.tgz", copy the proper image (with a prefix that could be the
name of the tutorial, for instance) and update the asciidoc file.
Let me know if you need any assistance on this.
Thanks & kind regards,
Antonio
[1]
https://github.com/apache/netbeans-website/blob/master/netbeans.apache.org/src/content/tutorials/nbm-java-hint.asciidoc
El 25/1/22 a las 8:49, Peter Blemel escribió:
> Antonio,
>
> I have much experience with sed/etc and moving files around en-masse on the file system using scripting. If you want, I can probably write a script to give each graphic/illustration a unique name based on its original folder and merge the directories in pretty short order. I'd just need to get a tarball/zip of everything from you.
>
> Peter
>
> ________________________________
> From: antonio <an...@vieiro.net>
> Sent: Tuesday, January 25, 2022 12:42 AM
> To: dev@netbeans.apache.org <de...@netbeans.apache.org>
> Subject: Re: "Original" NB tutorials?
>
> Hi Peter,
>
> Thanks for detecting this!
>
> The "/tutorials" path in netbeans.apache.org comes from
> "http://platform.netbeans.org/tutorials", this is, it comes from the
> domain "platform.netbeans.org" and not from "www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org>>". So these
> are not available in Wade Chandler's copy of "www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org<http://www.netbeans.org>>".
>
> The "platform.netbeans.org" web comes from these two svn repositories:
>
> - https://svn.netbeans.org/svn/platform~platform-content/trunk/tutorials/
> - https://svn.netbeans.org/svn/platform~platform-content/trunk/images/
>
> These are not currently available now, but we're lucky I still keep a
> clone of these repositories on my hard disk and, as you say, images do
> indeed come from different directories and were overwroten in the migration.
>
> These are 1476 tutorials (for different NetBeans versions which are now
> outdated) and possibly even for different languages [1].
>
> I'll see what I can do to recover the proper images in each tutorial.
>
> Thanks & kind regards,
> Antonio
>
>
>
> [1]
> The nbm-java-hint tutorial has these versions online
>
> https://netbeans.apache.org/tutorials/67/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/68/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/691/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/69/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/70/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/71/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/72/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/73/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/74/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/80/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/nbm-java-hint.html
>
>
>
>
> El 24/1/22 a las 15:50, Peter Blemel escribió:
>> I haven't been through all of the tutorials, but many of the ones that I've been looking at have problems. For example,
>> https://netbeans.apache.org/tutorials/nbm-javacc-lexer.html has "stock trader" graphics.
>> https://netbeans.apache.org/tutorials/nbm-copyfqn.html has "POV Ray" graphics
>> https://netbeans.apache.org/tutorials/nbm-code-completion.html Stock trader
>> https://netbeans.apache.org/tutorials/nbm-java-hint.html Stock trader
>> and so on.
>>
>> It looks like the tutorials each used to live in its own directory, many using the same file name for their individual graphics - which was fine because the directory structure at the time kept the file names from colliding with each other. When they were subsequently all put into one folder, files with the same name became a problem. Each tutorial copied into the directory overwrote files already there. Now they all link to the same graphic because the individual graphics were not renamed.
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.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-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by antonio <an...@vieiro.net>.
Of course!
images.tgz: https://ufile.io/twj9inhm
tutorials.tgz: https://ufile.io/qpk1abf3
Note that "tutorials.tgz" has the original HTML file of each tutorial
(i.e., not transformed to asciidoc). For instance "nbm-java-hint.html"
is related to "nbm-java-hint.asciidoc" now [1].
What I was thinking is that it would be easier to scan the images in
each asciidoc file (with a sed script), find the proper equivalent in
"images.tgz", copy the proper image (with a prefix that could be the
name of the tutorial, for instance) and update the asciidoc file.
Let me know if you need any assistance on this.
Thanks & kind regards,
Antonio
[1]
https://github.com/apache/netbeans-website/blob/master/netbeans.apache.org/src/content/tutorials/nbm-java-hint.asciidoc
El 25/1/22 a las 8:49, Peter Blemel escribió:
> Antonio,
>
> I have much experience with sed/etc and moving files around en-masse on the file system using scripting. If you want, I can probably write a script to give each graphic/illustration a unique name based on its original folder and merge the directories in pretty short order. I'd just need to get a tarball/zip of everything from you.
>
> Peter
>
> ________________________________
> From: antonio <an...@vieiro.net>
> Sent: Tuesday, January 25, 2022 12:42 AM
> To: dev@netbeans.apache.org <de...@netbeans.apache.org>
> Subject: Re: "Original" NB tutorials?
>
> Hi Peter,
>
> Thanks for detecting this!
>
> The "/tutorials" path in netbeans.apache.org comes from
> "http://platform.netbeans.org/tutorials", this is, it comes from the
> domain "platform.netbeans.org" and not from "www.netbeans.org<http://www.netbeans.org>". So these
> are not available in Wade Chandler's copy of "www.netbeans.org<http://www.netbeans.org>".
>
> The "platform.netbeans.org" web comes from these two svn repositories:
>
> - https://svn.netbeans.org/svn/platform~platform-content/trunk/tutorials/
> - https://svn.netbeans.org/svn/platform~platform-content/trunk/images/
>
> These are not currently available now, but we're lucky I still keep a
> clone of these repositories on my hard disk and, as you say, images do
> indeed come from different directories and were overwroten in the migration.
>
> These are 1476 tutorials (for different NetBeans versions which are now
> outdated) and possibly even for different languages [1].
>
> I'll see what I can do to recover the proper images in each tutorial.
>
> Thanks & kind regards,
> Antonio
>
>
>
> [1]
> The nbm-java-hint tutorial has these versions online
>
> https://netbeans.apache.org/tutorials/67/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/68/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/691/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/69/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/70/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/71/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/72/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/73/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/74/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/80/nbm-java-hint.html
> https://netbeans.apache.org/tutorials/nbm-java-hint.html
>
>
>
>
> El 24/1/22 a las 15:50, Peter Blemel escribió:
>> I haven't been through all of the tutorials, but many of the ones that I've been looking at have problems. For example,
>> https://netbeans.apache.org/tutorials/nbm-javacc-lexer.html has "stock trader" graphics.
>> https://netbeans.apache.org/tutorials/nbm-copyfqn.html has "POV Ray" graphics
>> https://netbeans.apache.org/tutorials/nbm-code-completion.html Stock trader
>> https://netbeans.apache.org/tutorials/nbm-java-hint.html Stock trader
>> and so on.
>>
>> It looks like the tutorials each used to live in its own directory, many using the same file name for their individual graphics - which was fine because the directory structure at the time kept the file names from colliding with each other. When they were subsequently all put into one folder, files with the same name became a problem. Each tutorial copied into the directory overwrote files already there. Now they all link to the same graphic because the individual graphics were not renamed.
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
> For additional commands, e-mail: dev-help@netbeans.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-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by Peter Blemel <pb...@hotmail.com>.
Antonio,
I have much experience with sed/etc and moving files around en-masse on the file system using scripting. If you want, I can probably write a script to give each graphic/illustration a unique name based on its original folder and merge the directories in pretty short order. I'd just need to get a tarball/zip of everything from you.
Peter
________________________________
From: antonio <an...@vieiro.net>
Sent: Tuesday, January 25, 2022 12:42 AM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>
Subject: Re: "Original" NB tutorials?
Hi Peter,
Thanks for detecting this!
The "/tutorials" path in netbeans.apache.org comes from
"http://platform.netbeans.org/tutorials", this is, it comes from the
domain "platform.netbeans.org" and not from "www.netbeans.org<http://www.netbeans.org>". So these
are not available in Wade Chandler's copy of "www.netbeans.org<http://www.netbeans.org>".
The "platform.netbeans.org" web comes from these two svn repositories:
- https://svn.netbeans.org/svn/platform~platform-content/trunk/tutorials/
- https://svn.netbeans.org/svn/platform~platform-content/trunk/images/
These are not currently available now, but we're lucky I still keep a
clone of these repositories on my hard disk and, as you say, images do
indeed come from different directories and were overwroten in the migration.
These are 1476 tutorials (for different NetBeans versions which are now
outdated) and possibly even for different languages [1].
I'll see what I can do to recover the proper images in each tutorial.
Thanks & kind regards,
Antonio
[1]
The nbm-java-hint tutorial has these versions online
https://netbeans.apache.org/tutorials/67/nbm-java-hint.html
https://netbeans.apache.org/tutorials/68/nbm-java-hint.html
https://netbeans.apache.org/tutorials/691/nbm-java-hint.html
https://netbeans.apache.org/tutorials/69/nbm-java-hint.html
https://netbeans.apache.org/tutorials/70/nbm-java-hint.html
https://netbeans.apache.org/tutorials/71/nbm-java-hint.html
https://netbeans.apache.org/tutorials/72/nbm-java-hint.html
https://netbeans.apache.org/tutorials/73/nbm-java-hint.html
https://netbeans.apache.org/tutorials/74/nbm-java-hint.html
https://netbeans.apache.org/tutorials/80/nbm-java-hint.html
https://netbeans.apache.org/tutorials/nbm-java-hint.html
El 24/1/22 a las 15:50, Peter Blemel escribió:
> I haven't been through all of the tutorials, but many of the ones that I've been looking at have problems. For example,
> https://netbeans.apache.org/tutorials/nbm-javacc-lexer.html has "stock trader" graphics.
> https://netbeans.apache.org/tutorials/nbm-copyfqn.html has "POV Ray" graphics
> https://netbeans.apache.org/tutorials/nbm-code-completion.html Stock trader
> https://netbeans.apache.org/tutorials/nbm-java-hint.html Stock trader
> and so on.
>
> It looks like the tutorials each used to live in its own directory, many using the same file name for their individual graphics - which was fine because the directory structure at the time kept the file names from colliding with each other. When they were subsequently all put into one folder, files with the same name became a problem. Each tutorial copied into the directory overwrote files already there. Now they all link to the same graphic because the individual graphics were not renamed.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by antonio <an...@vieiro.net>.
Hi Peter,
Thanks for detecting this!
The "/tutorials" path in netbeans.apache.org comes from
"http://platform.netbeans.org/tutorials", this is, it comes from the
domain "platform.netbeans.org" and not from "www.netbeans.org". So these
are not available in Wade Chandler's copy of "www.netbeans.org".
The "platform.netbeans.org" web comes from these two svn repositories:
- https://svn.netbeans.org/svn/platform~platform-content/trunk/tutorials/
- https://svn.netbeans.org/svn/platform~platform-content/trunk/images/
These are not currently available now, but we're lucky I still keep a
clone of these repositories on my hard disk and, as you say, images do
indeed come from different directories and were overwroten in the migration.
These are 1476 tutorials (for different NetBeans versions which are now
outdated) and possibly even for different languages [1].
I'll see what I can do to recover the proper images in each tutorial.
Thanks & kind regards,
Antonio
[1]
The nbm-java-hint tutorial has these versions online
https://netbeans.apache.org/tutorials/67/nbm-java-hint.html
https://netbeans.apache.org/tutorials/68/nbm-java-hint.html
https://netbeans.apache.org/tutorials/691/nbm-java-hint.html
https://netbeans.apache.org/tutorials/69/nbm-java-hint.html
https://netbeans.apache.org/tutorials/70/nbm-java-hint.html
https://netbeans.apache.org/tutorials/71/nbm-java-hint.html
https://netbeans.apache.org/tutorials/72/nbm-java-hint.html
https://netbeans.apache.org/tutorials/73/nbm-java-hint.html
https://netbeans.apache.org/tutorials/74/nbm-java-hint.html
https://netbeans.apache.org/tutorials/80/nbm-java-hint.html
https://netbeans.apache.org/tutorials/nbm-java-hint.html
El 24/1/22 a las 15:50, Peter Blemel escribió:
> I haven't been through all of the tutorials, but many of the ones that I've been looking at have problems. For example,
> https://netbeans.apache.org/tutorials/nbm-javacc-lexer.html has "stock trader" graphics.
> https://netbeans.apache.org/tutorials/nbm-copyfqn.html has "POV Ray" graphics
> https://netbeans.apache.org/tutorials/nbm-code-completion.html Stock trader
> https://netbeans.apache.org/tutorials/nbm-java-hint.html Stock trader
> and so on.
>
> It looks like the tutorials each used to live in its own directory, many using the same file name for their individual graphics - which was fine because the directory structure at the time kept the file names from colliding with each other. When they were subsequently all put into one folder, files with the same name became a problem. Each tutorial copied into the directory overwrote files already there. Now they all link to the same graphic because the individual graphics were not renamed.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by Peter Blemel <pb...@hotmail.com>.
Antonio,
I haven't been through all of the tutorials, but many of the ones that I've been looking at have problems. For example,
https://netbeans.apache.org/tutorials/nbm-javacc-lexer.html has "stock trader" graphics.
https://netbeans.apache.org/tutorials/nbm-copyfqn.html has "POV Ray" graphics
https://netbeans.apache.org/tutorials/nbm-code-completion.html Stock trader
https://netbeans.apache.org/tutorials/nbm-java-hint.html Stock trader
and so on.
It looks like the tutorials each used to live in its own directory, many using the same file name for their individual graphics - which was fine because the directory structure at the time kept the file names from colliding with each other. When they were subsequently all put into one folder, files with the same name became a problem. Each tutorial copied into the directory overwrote files already there. Now they all link to the same graphic because the individual graphics were not renamed.
Brad suggested re-creating the images to bring them up-to-date. That will take some time. Giving all of the old files unique file names and fixing each HTML file is also a lot of work. Another, easier solution is to rebuild the tutorials folder using the original directory structure. That will not bring the graphics up to date, but will solve the problem in an expedient way.
Best,
Peter
________________________________
From: antonio <an...@vieiro.net>
Sent: Monday, January 24, 2022 12:01 AM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>
Subject: Re: "Original" NB tutorials?
Hi Peter,
Originals are kept here for reference
https://github.com/wadechandler/netbeans-static-site (src/content)
Cheers,
Antonio
P.S.: I'm curious, which illustrations are incorrect?
El 24/1/22 a las 3:18, Peter Blemel escribió:
> Hi,
>
> After looking through the tutorials, the thing that jumps out at me the most is that many of them have incorrect illustrations. I used many of these tutorials "back in the day", and recall that the illustrations were not such a jumble. If someone can point me to the original directories from before they were moved, I will try to get the right images back into their respective tutorials in the GitHub repo before moving on to updating individual tutorials.
>
> Thanks,
> Peter
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by antonio <an...@vieiro.net>.
Hi Peter,
Originals are kept here for reference
https://github.com/wadechandler/netbeans-static-site (src/content)
Cheers,
Antonio
P.S.: I'm curious, which illustrations are incorrect?
El 24/1/22 a las 3:18, Peter Blemel escribió:
> Hi,
>
> After looking through the tutorials, the thing that jumps out at me the most is that many of them have incorrect illustrations. I used many of these tutorials "back in the day", and recall that the illustrations were not such a jumble. If someone can point me to the original directories from before they were moved, I will try to get the right images back into their respective tutorials in the GitHub repo before moving on to updating individual tutorials.
>
> Thanks,
> Peter
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: "Original" NB tutorials?
Posted by Peter Blemel <pb...@hotmail.com>.
That was my guess. Thanks, I'll take a look.
Peter
________________________________
From: Brad Hards <br...@frogmouth.net>
Sent: Sunday, January 23, 2022 7:31 PM
To: dev@netbeans.apache.org <de...@netbeans.apache.org>
Cc: Peter Blemel <pb...@hotmail.com>
Subject: Re: "Original" NB tutorials?
On Monday, 24 January 2022 1:18:09 PM AEDT Peter Blemel wrote:
> Hi,
>
> After looking through the tutorials, the thing that jumps out at me the most
> is that many of them have incorrect illustrations. I used many of these
> tutorials "back in the day", and recall that the illustrations were not
> such a jumble.
When I worked these, it looked like some tutorials had images that used the
same names, and there was overwriting when the directory structure was
flattened.
> If someone can point me to the original directories from
> before they were moved, I will try to get the right images back into their
> respective tutorials in the GitHub repo before moving on to updating
> individual tutorials.
I can only suggest the archive. For example:
https://web.archive.org/web/20190103205150/https://netbeans.org/kb/index.html
Note that some of the images are so old that they are misleading. Regenerating
them would be ideal, and I found it easier than trying to find the old images.
Brad
Re: "Original" NB tutorials?
Posted by Brad Hards <br...@frogmouth.net>.
On Monday, 24 January 2022 1:18:09 PM AEDT Peter Blemel wrote:
> Hi,
>
> After looking through the tutorials, the thing that jumps out at me the most
> is that many of them have incorrect illustrations. I used many of these
> tutorials "back in the day", and recall that the illustrations were not
> such a jumble.
When I worked these, it looked like some tutorials had images that used the
same names, and there was overwriting when the directory structure was
flattened.
> If someone can point me to the original directories from
> before they were moved, I will try to get the right images back into their
> respective tutorials in the GitHub repo before moving on to updating
> individual tutorials.
I can only suggest the archive. For example:
https://web.archive.org/web/20190103205150/https://netbeans.org/kb/index.html
Note that some of the images are so old that they are misleading. Regenerating
them would be ideal, and I found it easier than trying to find the old images.
Brad
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@netbeans.apache.org
For additional commands, e-mail: dev-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists