Package: manpages.debian.org
Severity: minor

        [Please do not Cc: me, as I’m “on the list,” so to say, and
        I try to reserve my inbox for private communication only.
        I’d have set up Mail-Followup-To:, but there doesn’t seem to
        be a way to make it point to the report being filed.]

        While I’m not sure if it perhaps /is/ an accepted practice,
        I’d venture to guess that the way manpages.debian.org encodes
        JSON-LD objects as strings /and then/ encodes the resulting
        strings as JSON strings /yet again,/ is going to confuse some
        of the processing tools out there.

        Consider, e. g. (split for readability):

<script type="application/ld+json">
"{\"@context\":\"http://schema.org\",\"@type\":\"BreadcrumbList\";,
\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,
\"item\":{\"@type\":\"Thing\",\"@id\":\"/contents-unstable.html\",
\"name\":\"unstable\"}},{\"@type\":\"ListItem\",\"position\":2,
\"item\":{\"@type\":\"Thing\",\"@id\":\"/unstable/acl/index.html\",
\"name\":\"acl\"}},{\"@type\":\"ListItem\",\"position\":3,
\"item\":{\"@type\":\"Thing\",\"@id\":\"\",\"name\":\"getfacl(1)\"}}]}"
</script>

— https://manpages.debian.org/unstable/acl/getfacl.1.en.html

        Versus, say, https://en.wikipedia.org/wiki/JSON-LD (which
        I presume is the correct usage):

<script type="application/ld+json"
>{"@context":"https:\/\/schema.org","@type":"Article","name":"JSON-LD",
"url":"https:\/\/en.wikipedia.org\/wiki\/JSON-LD",
"sameAs":"http:\/\/www.wikidata.org\/entity\/Q6108942",
"mainEntity":"http:\/\/www.wikidata.org\/entity\/Q6108942",
"author":{"@type":"Organization",
"name":"Contributors to Wikimedia projects"},
"publisher":{"@type":"Organization","name":"Wikimedia Foundation, Inc.",
"logo":{"@type":"ImageObject",
"url":"https:\/\/www.wikimedia.org\/static\/images\/wmf-hor-googpub.png"}},
"datePublished":"2011-12-30T17:43:17Z",
"dateModified":"2022-11-15T22:34:49Z",
"headline":"a method of encoding Linked Data using JSON"}</script>

-- 
FSF associate member #7257  http://am-1.org/~ivan/

Reply via email to