Support #6350: https://www.saxonica.com/saxon-js/demos2/clocks-with-server.zip gives error 404: file not found - SaxonJS - Saxonica Developer Community

Actions

Send by e-mail Copy link

Support #6350

closed

https://www.saxonica.com/saxon-js/demos2/clocks-with-server.zip gives error 404: file not found

Added by Johan Gheys 3 months ago. Updated 2 months ago.

Status:

Closed

Priority:

Normal

Assignee:

Category:

Documentation

Sprint/Milestone:

Start date:

2024-02-16

Due date:

% Done:

100%

Estimated time:

Applies to JS Branch:

Fix Committed on JS Branch:

Fixed in JS Release:

SEF Generated with:

Platforms:

Company:

Contact person:

Additional contact persons:

Description

On page https://www.saxonica.com/saxon-js/documentation2/index.html#!samples/clocks/clocks-client-server, the link to clocks-with-server resources zip is broken.

Actions

Copy link

Updated by Debbie Lockett 3 months ago

Apologies, and thanks for letting us know.

It looks like we need to rebuild this zip and upload it. I have found an old (original?) version of the zip from June 2020, which contains the SaxonJS 2.0 browser runtime. But it would be good to update that to the latest version 2.6.

We test the samples (including this one) in our gradle build, but this is not yet linked to what is online under demos2 (as the documentation is for instance).

Actions

Copy link

Updated by Debbie Lockett 3 months ago

When I try running the demo locally, I actually hit an error:

Error: listen EADDRINUSE: address already in use :::5000

It seems that Macs now use this port. So we should use something else for the local server in this sample.

(Note that when we run the sample in testing, it runs off our testing server instead.)

Actions

Copy link

Updated by Norm Tovey-Walsh 3 months ago

Well, port numbers above 1024 are technically unreserved, but that's not the same as unused. I suppose the ideal thing would be to let it be configurable, but that might be more trouble than it's worth. In the meantime, there's a Wikipedia page that lists a lot of port numbers. There's a lot of contention for 5000. I see that 6311 is in the intersection of "prime numbers less than 10,000" and "port numbers not listed on that page."

I suggest we change the demo to use 6311 :-)

Actions

Copy link

Updated by Debbie Lockett 3 months ago

Status changed from New to In Progress

Updates committed to the saxonjs2 branch:

I've updated the demo to use port 6311 instead of 5000, as Norm suggested; and updated the info in the documentation accordingly.
I've updated the build-demos.gradle script so that it correctly builds all the browser demos for the website, including the zip for this clocks-with-server demo. The output goes in the build/website/saxon-js/demos2 directory, ready to be copied to www-saxonica-com/static/saxon-js for uploading to the website.
Relatedly, I've updated the build-doc.gradle script to add tasks to copy the built documentation to the build/website/saxon-js/documentation2 directory; so that all content for the website is in one place (build/website/saxon-js).