netbeans-website icon indicating copy to clipboard operation
netbeans-website copied to clipboard

Reduce image sizes in NB Platform Quickstart tutorial

Open icojb25 opened this issue 2 years ago • 6 comments

The current image sizes are very large in the NB Platform quickstart tutorial which makes reading it quick tricky (scrolling up and down to find the text), so I've suggested we reduce the image sizes slightly

icojb25 avatar Mar 11 '23 11:03 icojb25

so, the giant screenshot appeared after #648 as mentioned https://github.com/apache/netbeans-website/pull/648#issuecomment-1462588002 :)

I am no expert with this website either, but noticed that there are two variants of the screenshots: https://github.com/apache/netbeans-website/blob/10170847062a64cb7024556aeb0ca97198a72c24/netbeans.apache.org/src/content/tutorials/images/quickstart_platform_new-api-1.png (full component) https://github.com/apache/netbeans-website/blob/f03ab9809fab1bf7755ab9b92ef37615ca973793/netbeans.apache.org/src/content/tutorials/images/quickstart-platform_73_new-api-1.png (cropped version highlighting a smaller part)

and the last PR switched from cropped to full (to fix some links). So... lets switch it back selectively?

mbien avatar Mar 11 '23 18:03 mbien

so, the giant screenshot appeared after #648 as mentioned #648 (comment) :)

I am no expert with this website either, but noticed that there are two variants of the screenshots: https://github.com/apache/netbeans-website/blob/10170847062a64cb7024556aeb0ca97198a72c24/netbeans.apache.org/src/content/tutorials/images/quickstart_platform_new-api-1.png (full component) https://github.com/apache/netbeans-website/blob/f03ab9809fab1bf7755ab9b92ef37615ca973793/netbeans.apache.org/src/content/tutorials/images/quickstart-platform_73_new-api-1.png (cropped version highlighting a smaller part)

and the last PR switched from cropped to full (to fix some links). So... lets switch it back selectively?

Ah, I see.

Well, one can use "Clickable Screenshots", so that the "small image" can be clicked to show a "larger detailed one", for an example on how to do this see https://netbeans.apache.org/kb/docs/contributing.html#_clickable_screenshots

If small images are available, I'd suggest using these smaller images and make them clickable to the larger ones.

vieiro avatar Mar 11 '23 18:03 vieiro

on closer look: one screenshot uses metal and the other uses windows LAF, which might be slightly confusing if it changes on click.

mbien avatar Mar 11 '23 18:03 mbien

none of the images are appearing, the links are pointing to the wrong folder

here's an incorrect example:

src="images/nbm-googlebar/new-project-3.png"

not only does it point to non existing folder, but the image names are all wring. This looks like some kind of migration process of the images failed to address the links.

dat-linux avatar May 05 '23 21:05 dat-linux

@dat-linux https://netbeans.apache.org/tutorials/nbm-quick-start.html seems to have all the images. You are writing about another page ?

ebarboni avatar May 11 '23 10:05 ebarboni

#669 should improve the situation for missing images. But we kind of need a common way to thumbnail or manage the large image

ebarboni avatar Aug 01 '23 08:08 ebarboni