Dead links (The Internal Edition)

[twisst]

At the risk of becoming a nuisance, I have now compiled a list of internal broken links :-)

404  https://processing.org/reference/libraries/[email protected] in https://processing.org/reference/libraries/
404  https://processing.org/reference/libraries/[email protected] in https://processing.org/reference/libraries/
404  https://processing.org/reference/libraries/[email protected] in https://processing.org/reference/libraries/
404  https://processing.org/reference/libraries/Papa in https://processing.org/reference/libraries/
404  https://processing.org/reference/libraries/Papa in https://processing.org/reference/libraries/
404  https://processing.org/reference/libraries/[email protected] in https://processing.org/reference/libraries/
404  https://processing.org/reference/libraries/www.pierdr.com in https://processing.org/reference/libraries/
404  https://processing.org/reference/tools/modes/ in https://processing.org/people/
404  https://processing.org/reference/PGraphics_textFont_.html in https://processing.org/reference/pfont
404  https://processing.org/reference/String_.html in https://processing.org/reference/text_
404  https://processing.org/reference/rightshift_.html in https://processing.org/reference/green_
404  https://processing.org/reference/rightshift_.html in https://processing.org/reference/blue_
404  https://processing.org/reference/rightshift_.html in https://processing.org/reference/red_
404,301  http://processing.org/learning/pixels/ in https://processing.org/tutorials/text/
404,301  http://processing.org/learning/transform2d/ in https://processing.org/tutorials/text/
404,301  http://processing.org/reference/updatePixels.html in https://processing.org/tutorials/pixels/
404,301  http://processing.org/reference/draw_.html)draw()%5D in https://processing.org/tutorials/pvector/
404  https://processing.org/reference/floatconvert.html in https://processing.org/examples/datatypeconversion
404  https://processing.org/reference/intconvert.html in https://processing.org/examples/datatypeconversion
404  https://processing.org/reference/byteconvert.html in https://processing.org/examples/datatypeconversion
404  https://processing.org/reference/charconvert.html in https://processing.org/examples/datatypeconversion
404  https://processing.org/reference/pixels[].html in https://processing.org/examples/mandelbrot
404  https://processing.org/reference/Pimage_pixels[J.html in https://processing.org/examples/blur
404  htts://processing.org/reference/Pimage_.html in https://processing.org/examples/convolution
404  htts://processing.org/reference/Pimage_.html in https://processing.org/examples/pixelarray
404  https://processing.org/reference/PVector_sub.html in https://processing.org/examples/vectormath
404  https://processing.org/reference/PGraphics_alpha_.html in https://processing.org/reference/pimage_copy_
404  https://processing.org/libraries appears 520 times, everywhere where the breadcrumbs appear.
404  https://processing.org/reference/libraries/serial/LIB_serial/serialEvent_.html in https://processing.org/reference/libraries/serial/serial
404  https://processing.org/reference/libraries/net/LIB_net/clientEvent_.html in https://processing.org/reference/libraries/net/client
404  https://processing.org/reference/librari...d/MultiChannel_availableChannels_.html in https://processing.org/reference/libraries/sound/multichannel_activechannel
404  https://processing.org/reference/libraries/sound/sound/Sound_list.html in https://processing.org/reference/libraries/sound/multichannel_useportaudio_
404  https://processing.org/reference/libraries/sound/sound/Sound_list.html in https://processing.org/reference/libraries/sound/sound_inputdevice_
404  https://processing.org/reference/libraries/sound/sound/Sound_list.html in https://processing.org/reference/libraries/sound/sound_outputdevice_
404  https://processing.org/reference/librarie...und/sound/Sound_outputDevice_.html in https://processing.org/reference/libraries/sound/multichannel_availablechannels_
404  https://processing.org/reference/libraries/sound/sound/AudioSample_cue_.html in https://processing.org/reference/libraries/sound/audiosample_jump_
404  https://processing.org/reference/libraries/sound/sound/AudioSample_cue_.html in https://processing.org/reference/libraries/sound/audiosample_jumpframe_
404  https://processing.org/reference/libraries/sound/sound/AudioSample_cue_.html in https://processing.org/reference/libraries/sound/audiosample_pause_
404  https://processing.org/reference/libraries/sound/sound/AudioSample_play_.html in https://processing.org/reference/libraries/sound/audiosample_jump_
404  https://processing.org/reference/libraries/sound/sound/AudioSample_play_.html in https://processing.org/reference/libraries/sound/audiosample_jumpframe_
404  https://processing.org/reference/libraries/sound/sound/MultiChannel.html in https://processing.org/reference/libraries/sound/sound

In my defense, I do plan to fix them all myself :-)

The only one that someone else should probably fix, is the https://processing.org/libraries link in the breadcrumbs at the top of all pages in the Libraries section. That link could either be changed to https://processing.org/reference/libraries or a redirect could be made.

[swastikCommits]

Is this fixed? I am willing to work on it

[SableRaf]

Hey @twisst :) Are you still planning on working on this or should we assign it to someone else?

[twisst]

Hi @SableRaf, I don't mind letting it go, but are you sure that my fix would not work? You said "most of these changes can't be made directly in the website repository anyway. For example, the contributions, reference, and examples are all generated from other sources".
I could not find those other sources in the repository, and when I had a chance to talk to @Stefterv in Berlin he wasn't sure either.

[SableRaf]

Hi @twisst and apologies for the confusion. Information about data sources for various part of the website can be found in the README here: https://github.com/processing/processing-website?tab=readme-ov-file#page-content

[twisst]

Aaah I see. It makes sense now. I'll have a go applying the changes I previously made to the JSONs to the source files instead.

[twisst]

I suspect most broken links are caused by the script that converts the Javadoc annotations to a json file. Things mostly go wrong where the java files use '@see_external'.

This line in the documentation for the green() function. In my commit you see that it results in a 404 instead of this page.
Same 404 is in the documentation for red() and blue().

I'm not 100% sure if the script needs to be changed or maybe some internal redirects on the website, but it is probably better I'm not the one messing with either :-) Same goes for the breadcrumb links I already mentioned above.

These are the other 404's in the list above that are somehow caused by the automatic conversion:

• the JSON for DatatypeConversion contains ["floatconvert", "intconvert", "byteconvert", "charconvert"] even though the .pde it is based on only mentions "int(), float(), char(), byte()". On the website this somehow leads to a link to byteconvert.html when it should be byteconvert_.html.
• pixels[] in Topics/Fractals and L-Systems/Mandelbrot/Mandelbrot.pde ends up in Mandelbrot.json as 'pixels[]' -- which results in a 404 because it should be 'pixels'.
• Blur.json contains 'PImage_pixels[]' but that should be 'PImage_pixels' to get a proper link. Blur.pde does mention 'PImage' and also 'pixels' but not 'PImage_pixels'.
• Convolution.pde contains 'PImage', which results in Convolution.json linking to 'PImage_' instead of to 'PImage'.
• ditto PixelArray: linking to 'PImage_' instead of to 'PImage'.
• VectorMath leads to 'PVector_sub' instead of 'PVector_sub_' (so here there should be an underscore).
• this line in Client.java leads to content/references/translations/en/net/Client.json linking to 'LIB_net/clientEvent_' instead of 'net/clientEvent_'
• PFont: 'PGraphics_textFont_' where it should be 'textFont_'
• PImage_copy_.json: 'PGraphics_alpha_' instead of 'alpha_'
• text: 'String_' instead of 'String' (another case of '@see_external')
• Serial: 'LIB_serial/serialEvent_' instead of 'serial/Serial_serialEvent_'
• AudioSample.java has these lines '@see AudioSample#cue(float)' and '@see AudioSample#play()' and that leads to 404's in AudioSample_jumpFrame_.json, AudioSample_jump_.json, AudioSample_pause_.json
• I'm getting bored now :-) but the same problem is occuring in MultiChannel.java and Sound.java

I'm going to make a PR now for the links I could fix.

[mingness]

@twisst Thanks for your work on this issue - I think a plausible solution is one that you suggested - change the script in processing-contributions that creates the jsons to change common formatting "errors". For now we could merge the changes in the yaml that you've created a PR for, but this is not a permanent solution, since these entries will be overwritten the next time the library is updated. I'll converse more in the PR

[mingness]

@Stefterv apologies have forgotten - are the json artifacts from processing-contributions now used for the website?