Skip to content

Dead links (The Internal Edition) #595

Open
processing/processing-contributions
#68
@twisst

Description

@twisst
Contributor

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

404  https://processing.org/reference/libraries/r.liang@tue.nl in https://processing.org/reference/libraries/
404  https://processing.org/reference/libraries/steele@osteele.com in https://processing.org/reference/libraries/
404  https://processing.org/reference/libraries/steele@osteele.com 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/s.geiger.s@gmail.com 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.

Activity

swastikCommits

swastikCommits commented on Mar 8, 2025

@swastikCommits

Is this fixed? I am willing to work on it

SableRaf

SableRaf commented on Mar 25, 2025

@SableRaf
Collaborator

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

twisst

twisst commented on Apr 3, 2025

@twisst
ContributorAuthor

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

SableRaf commented on Apr 4, 2025

@SableRaf
Collaborator

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

twisst commented on Apr 4, 2025

@twisst
ContributorAuthor

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

twisst commented on Apr 4, 2025

@twisst
ContributorAuthor

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.

added a commit that references this issue on Apr 5, 2025
bcefca7
linked a pull request that will close this issue on Apr 5, 2025
mingness

mingness commented on Apr 5, 2025

@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

mingness commented on Apr 5, 2025

@mingness

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

twisst

twisst commented on Apr 9, 2025

@twisst
ContributorAuthor

@mingness @SableRaf Like I said, I think it's better someone more knowledgeable takes on changing those conversion scripts :-)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

      Participants

      @SableRaf@twisst@mingness@swastikCommits

      Issue actions

        Dead links (The Internal Edition) · Issue #595 · processing/processing-website