FYI: anchors aren't in .html thus cannot be easily validated

[yarikoptic]

JS-powered https://w3c.github.io/json-ld-syntax is really nice, but we encountered difficulty with linkchecker to verify that URLs we use are still correct. The reason is that it seems that the anchors are populated and/or handled by JS, so anything which just downloads the page without running JS would fail to find those id's.

E.g. in our case it is https://w3c.github.io/json-ld-syntax/#named-graphs link, for which there is no "named-graphs" id in the actual source .html:

$> wget -q -O- 'https://w3c.github.io/json-ld-syntax/#named-graphs' | grep 'named-graphs' | grep -v 'href="#named-graphs"'
$> 

I am not sure if there is an easy workaround at any level, or may be some alternative link which would lead to an .html version with those anchors?

PS Please pardon my ignorance if it is something really simple ;)

[gkellogg]

You should use the published version at https://www.w3.org/TR/json-ld11/, which is the result of processing the editors draft and resolving all such links.

The editors draft is in a "raw" format, and makes use of ReSpec. It does provide some features that the published version doesn't (unfortunately), such as highlighted variables within algorithms. ReSpec is widely used for W3C specifications.

There is a processes used in our continuous integration to create a fully resolved version from the source in .travis-ci.yaml, if you really want to work off of the editor's draft:

json-ld-syntax/.travis.yml

Lines 21 to 33 in a65dd9a

	- stage: links
	name: "Check internal links and HTML"
	sudo: required
	services:
	- docker
	# Because (alas) rawgit is end of life, we'll run this only on the master branch.
	if: branch = master
	language: ruby
	rvm: 2.6
	script:
	- docker pull stupchiy/checklink
	- docker run -it stupchiy/checklink -b -X '(http|https|mailto):' "https://labs.w3.org/spec-generator/?type=respec&url=https://w3c.github.io/json-ld-syntax/index.html?specStatus=WD&shortName=json-ld11"
	- bundle exec rake check_html

[gkellogg]

Resolved to close, as the final form will have anchors in the html.

[yarikoptic]

Thank you @gkellogg !