Skip to content

Commit e450bc8

Browse files
committed
Use Markdown for Specifications list.
Also fix `active` class on Specifications dropdown (which caused the whole dropdown list to appear stuck open over the page...).
1 parent 5a848b0 commit e450bc8

File tree

3 files changed

+81
-99
lines changed

3 files changed

+81
-99
lines changed

_layouts/fomantic.liquid

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@
7575
</a>
7676

7777
<!-- Dropdown menu -->
78-
<div class="ui simple dropdown item {% if page.url == '/spec/' %}active{% endif %}">
78+
<div class="ui simple dropdown item">
7979
<i class="folder open icon"></i>
8080
Specifications
8181
<i class="dropdown icon"></i>

spec/index.html

Lines changed: 0 additions & 98 deletions
This file was deleted.

spec/index.md

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
---
2+
layout: fomantic
3+
title: Specifications
4+
ga: 40462488
5+
---
6+
7+
# Specifications
8+
9+
JSON-LD has been designed to be a modular set of specifications. It
10+
consists of two base specifications: The JSON-LD Syntax and the JSON-LD
11+
API. All other JSON-LD specifications are layered upon the previous two
12+
specifications, allowing the community to build experimental extensions
13+
on top of the base specifications.
14+
15+
## [The JSON-LD Syntax](latest/json-ld/) {#syntax}
16+
17+
Defines JSON-LD, a JSON-based format to serialize Linked Data. The
18+
syntax is designed to easily integrate into deployed systems that
19+
already use JSON, and provides a smooth upgrade path from JSON to
20+
JSON-LD. It is primarily intended to be a way to use Linked Data in
21+
Web-based programming environments, to build interoperable Web services,
22+
and to store Linked Data in JSON-based storage engines.
23+
24+
Links to JSON-LD specifications: [Latest](latest/json-ld/)
25+
{%- for draft in specs['json-ld'] -%}, [{{ draft[0]}}]({{ draft[1] }}) {%- endfor %}
26+
{%- for draft in specs['json-ld-syntax'] -%}, [{{ draft[0] }}]({{ draft[1] }}) {%- endfor %}
27+
28+
29+
## [The JSON-LD API](latest/json-ld-api/) {#api}
30+
31+
An Application Programming Interface (API) and a set of algorithms for
32+
programmatic transformations of JSON-LD documents. This API defines
33+
algorithms for applying and removing JSON-LD contexts.
34+
35+
Links to JSON-LD API specifications: [Latest](latest/json-ld-api/)
36+
{%- for draft in specs['json-ld-api'] -%}, [{{ draft[0]}}]({{ draft[1] }}) {%- endfor %}
37+
38+
39+
## [JSON-LD Best Practices](https://w3c.github.io/json-ld-bp) {#best-practices}
40+
41+
Best practices for publishing JSON-LD and building APIs.
42+
43+
Links to JSON-LD API specifications:
44+
[Latest](https://w3c.github.io/json-ld-bp)
45+
{%- for draft in specs['json-ld-api-best-practices'] -%} , [{{ draft[0]}}({{ draft[1] }}) {%- endfor %}
46+
47+
48+
49+
## [JSON-LD Framing](latest/json-ld-framing/) {#framing}
50+
51+
JSON-LD Framing allows developers to perform *query by example* and
52+
force a specific tree layout to a JSON-LD document. It allows developers
53+
to restructure data retrieved from the Web according to the specific
54+
needs of their application. Restructuring JSON-LD data before your
55+
application processes it leads to simpler code when processing data from
56+
external sources.
57+
58+
Links to JSON-LD Framing specifications:
59+
[Latest](latest/json-ld-framing/)
60+
{%- for draft in specs['json-ld-framing'] -%} , [{{ draft[0] }}]({{ draft[1] }}) {%- endfor %}
61+
62+
63+
64+
## [JSON-LD RDF API](latest/json-ld-rdf/)
65+
66+
JSON-LD RDF API describes access methods for transforming and abstract
67+
RDF represention into JSON-LD and back.
68+
69+
Links to JSON-LD RDF API specifications:
70+
[Latest](latest/json-ld-rdf/)
71+
{%- for draft in specs['json-ld-rdf'] -%} , [{{ draft[0] }}]({{ draft[1] }}) {%- endfor %}
72+
73+
74+
<div id="footer" class="ui message">
75+
76+
JSON-LD Specifications are covered by the [W3C DOCUMENT
77+
LICENSE](https://www.w3.org/Consortium/Legal/2015/doc-license) except
78+
where an alternate is specified.
79+
80+
</div>

0 commit comments

Comments
 (0)