Move Embedding JSON-LD in HTML to the end of Advanced Concepts
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Wed, 20 Mar 2013 13:25:56 +0100
changeset 1458 a30424df0a18
parent 1457 78975e50f155
child 1459 211abd209cd2
Move Embedding JSON-LD in HTML to the end of Advanced Concepts

This is something completely orthogonal to the rest of the spec. I think moving it to the end makes that text flow better.

This addresses #231.
spec/latest/json-ld-syntax/index.html
--- a/spec/latest/json-ld-syntax/index.html	Wed Mar 20 13:21:04 2013 +0100
+++ b/spec/latest/json-ld-syntax/index.html	Wed Mar 20 13:25:56 2013 +0100
@@ -1459,44 +1459,6 @@
 </section>
 
 <section>
-  <h2>Embedding JSON-LD in HTML Documents</h2>
-  <p>HTML script tags can be used to embed blocks of data in documents.
-    This way, JSON-LD content can be easily embedded in HTML by placing
-    it in a script element with the <code>type</code> attribute set to
-    <code>application/ld+json</code>.</p>
-
-  <pre class="example" data-transform="updateExample"
-       title="Embedding JSON-LD in HTML">
-  <!--
-  ****<script type="application/ld+json">****
-  {
-    "@context": "http://json-ld.org/contexts/person.jsonld",
-    "@id": "http://dbpedia.org/resource/John_Lennon",
-    "name": "John Lennon",
-    "born": "1940-10-09",
-    "spouse": "http://dbpedia.org/resource/Cynthia_Lennon"
-  }
-  ****</script>****
-  -->
-  </pre>
-
-  <p>Depending on how the HTML document is served, certain strings may need
-    to be escaped.</p>
-
-  <p>If a processor extracts the JSON-LD content into RDF, it should expand the
-    JSON-LD fragment into an RDF dataset using the algorithm defined in
-    <cite><a href="../json-ld-api/#convert-to-rdf-algorithm">
-      JSON-LD-API Convert to RDF Algorithm
-    </a></cite>
-    [[JSON-LD-API]]. If the HTML
-    file contains multiple JSON-LD <code>script</code> tags, or other RDF statements are
-    extracted, the result is the RDF merge of the datasets.</p>
-
-  <p>Other processors implementing this mechanism may choose to
-    return the expanded JSON-LD output.</p>
-</section>
-
-<section>
   <h2>String Internationalization</h2>
 
   <p>At times, it is important to annotate a <tref>string</tref>
@@ -2645,6 +2607,43 @@
   </pre>
 </section>
 
+<section>
+  <h2>Embedding JSON-LD in HTML Documents</h2>
+
+  <p>HTML script tags can be used to embed blocks of data in documents.
+    This way, JSON-LD content can be easily embedded in HTML by placing
+    it in a script element with the <code>type</code> attribute set to
+    <code>application/ld+json</code>.</p>
+
+  <pre class="example" data-transform="updateExample"
+       title="Embedding JSON-LD in HTML">
+  <!--
+  ****<script type="application/ld+json">****
+  {
+    "@context": "http://json-ld.org/contexts/person.jsonld",
+    "@id": "http://dbpedia.org/resource/John_Lennon",
+    "name": "John Lennon",
+    "born": "1940-10-09",
+    "spouse": "http://dbpedia.org/resource/Cynthia_Lennon"
+  }
+  ****</script>****
+  -->
+  </pre>
+
+  <p>Depending on how the HTML document is served, certain strings may need
+    to be escaped.</p>
+
+  <p>If a processor extracts the JSON-LD content into RDF, it should expand the
+    JSON-LD fragment into an RDF dataset using the algorithm defined in
+    <cite><a href="../json-ld-api/#convert-to-rdf-algorithm">JSON-LD-API Convert to RDF Algorithm</a></cite>
+    [[JSON-LD-API]]. If the HTML file contains multiple JSON-LD <code>script</code>
+    tags, or other RDF statements are extracted, the result is the RDF merge
+    of the datasets.</p>
+
+  <p>Other processors implementing this mechanism may choose to
+    return the expanded JSON-LD output.</p>
+</section>
+
 </section>
 
 <section class="appendix normative">