Core, CSDL, and JSON Format: starter documents and tool tweaks (#34)

Fixes #29 
Fixes #33
Fixes #36
Fixes #38 

Tool issues:
- [x] `odata-json-format.html` is generated empty
- [x] `odata-data-aggregation-ext.md` and
`odata-data-aggregation-ext.html` are generated empty
- [x] generate PDF

Documents:
- [x] CSDL JSON starter
- [x] CSDL XML starter 
- [x] JSON Format 
- [x] Protocol starter 
- [x] URL Conventions starter

.vscode/settings.json

@@ -0,0 +1,9 @@
+{
+  "cSpell.words": [
+    "ETag",
+    "odata",
+    "pandoc",
+    "subsec",
+    "subsubsec"
+  ]
+}

docs/index.md

@@ -2,4 +2,9 @@
 
 This repository contains working drafts for OData specifications:
 
-* [OData Extension for Data Aggregation Working Draft for CS03](odata-data-aggregation-ext/odata-data-aggregation-ext.html)
+* [OData Version 4.02 Part 1: Protocol - Working Draft for CS01](odata-protocol/odata-protocol.html)
+* [OData Version 4.02 Part 2: URL Conventions - Working Draft for CS01](odata-url-conventions/odata-url-conventions.html)
+* [OData CSDL JSON Version 4.02 - Working Draft for CS01](odata-csdl-json/odata-csdl-json.html)
+* [OData CSDL JSON Version 4.02 - Working Draft for CS01](odata-csdl-xml/odata-csdl-xml.html)
+* [OData JSON Format Version 4.02 - Working Draft for CS01](odata-json-format/odata-json-format.html)
+* [OData Extension for Data Aggregation Version 4.0 - Working Draft for CS03](odata-data-aggregation-ext/odata-data-aggregation-ext.html)

docs/odata-csdl-json/styles/markdown-styles-v1.7.3b.css

@@ -0,0 +1,91 @@
+/* OASIS specification styles for HTML generated from Markdown or similar sources */
+/* usually used after basic w3.css */
+/* Paul Knight 2018-09-27 */
+/* pk 2018-10-01 - v1.2 reduced section header and title (h*) font sizes */
+/* pk 2018-10-02 - v1.3 added right margin; allowed text wrapping in code blocks and scrolling for overflowing text */
+/* pk 2018-10-19 - v1.4 added display:inline to avoid page-wide background coloring */
+/* pk 2018-10-25 - v1.5 added use of <h6> as citation tag for References section or elsewhere */
+/* pk 2018-10-26 - v1.5.1 (experimental) and v1.6 added use of <hr /> as a page break when generating PDF from the HTML */
+/* pk 2018-11-14 - v1.6.1 - lighter gray background color for code blocks */
+/* pk 2019-02-18 - v1.7 - Use Liberation Sans and Liberation Mono fonts if possible */
+/* pk 2019-02-18 - v1.7.1 (experimental) changed px to pt (and reduced numbers) for fonts and tables; added bigtitle style */
+/* pk 2019-05-23 - v1.7.2 (based on 1.7.1) changed monospace "code" font to Courier New */
+/* pk 2019-08-01 - v1.7.3 substitute PostScript name for fonts (LiberationSans for "Liberation Sans" and CourierNew for "Courier New") to address a flaw in "wkhtmltopdf" which rendered all text as bold. Changed "bigtitle" to "h1big"*/
+/* dk 2020-10-21 - v1.7.3a (unofficial for jadn, based on 1.7.3) update block quotes and code blocks */
+/* Heiko Theißen 2023-06-02 - v1.7.3b (unofficial for odata-data-aggregation-ext, based on v1.7.3a) include local font names "Liberation Sans" and "Courier New" */
+
+body {
+    margin-left: 3pc;
+    margin-right: 3pc;
+    font-family: LiberationSans, "Liberation Sans", Arial, Helvetica, sans-serif;
+	font-size:12pt;
+	line-height:1.2;
+     }
+
+html{overflow-x:auto}
+
+	 /* styles for section headings - levels 1-5 (maybe include heading1, etc. later) */
+h1{font-size:18pt}h2{font-size:14pt}h3{font-size:13pt}h4{font-size:12pt}h5{font-size:11pt}
+h1big{font-size: 24pt}
+h1,h2,h3,h4,h5,h1big{font-family: LiberationSans, "Liberation Sans", Arial, Helvetica, sans-serif;font-weight: bold;margin:8pt 0;color: #446CAA}
+	/* style for h6, for use as Reference tag */
+h6{font-size:12pt; line-height:1.0}
+h6{font-family: LiberationSans, "Liberation Sans", Arial, Helvetica, sans-serif;font-weight: bold;margin:0pt;}
+	/* not needed - can just use brackets in the label itself */
+	/* h6::before {content: "["} */
+	/* h6::after {content: "]"} */
+
+		/* style for hr to insert a page break before each ruled line (generated in markdown by 3 or more hyphens alone on a line) */
+hr{page-break-before: always;}
+
+
+/* Table styles - bordered with option for striped */
+table {
+    border-collapse: collapse;
+}
+
+table {
+	border-collapse:collapse;
+	border-spacing:0;
+	width:100%;
+	display:table;
+	font-size:12pt;
+	margin-top: 6pt;
+	}
+
+table, th, td {
+    border: 1pt solid black;
+    padding:6pt 6pt;
+	text-align:left;
+	vertical-align:top;
+}
+th {
+	color:#ffffff;
+	background-color: #446CAA;
+	}
+		/* "table-striped" tag is not generated by pandoc - add manually in HTML if wanted */
+.table-striped tbody tr:nth-child(even){background-color:#d6f3ff}
+
+/* style for code blocks */
+pre {
+    background-color:#f0f0f0;
+    padding: 6px;
+}
+
+code,kbd,samp{
+    font-family:CourierNew, "Courier New", monospace;
+    white-space: pre-wrap;
+    font-size: 10pt;
+}
+
+/* offset block quote */
+blockquote {
+    background-color:#f0f0f0;
+    padding-left: 10px;
+    border-left: solid lightgray 6px;
+}
+
+/* space bullets a bit */
+li {
+    margin: 3px 0;
+}

docs/odata-csdl-json/styles/odata.css

@@ -0,0 +1,188 @@
+a:target {
+	background-color: yellow;
+}
+
+a[href^="#OData"],
+a[href^="#RFC"],
+a[href^="#SQL"] {
+	font-weight: bold;
+}
+
+a[href^="#OData"]::before,
+a[href^="#RFC"]::before,
+a[href^="#SQL"]::before {
+	content: "[";
+	font-weight: bold;
+}
+
+a[href^="#OData"]::after,
+a[href^="#RFC"]::after,
+a[href^="#SQL"]::after {
+	content: "]";
+	font-weight: bold;
+}
+
+.toc li {
+	list-style-type: none;
+}
+
+.example,
+.example table {
+	font-size: smaller;
+}
+
+.example p,
+.example li {
+	font-style: italic;
+}
+
+table {
+	width: auto;
+}
+
+.example table,
+.example th,
+.example td {
+	padding: 2pt 6pt;
+	white-space: nowrap;
+}
+
+.example td[rowspan] {
+	text-align: right;
+	vertical-align: middle;
+	border-style: dotted;
+}
+
+.example th[colspan] {
+	text-align: center;
+}
+
+.example-data {
+	position: relative;
+}
+
+.example-data div {
+	position: absolute;
+}
+
+.example-data p {
+	font-style: unset !important;
+}
+
+.example-data svg {
+	position: absolute;
+	left: 0;
+	right: 0;
+	top: 0;
+	bottom: 0;
+}
+
+.cross tbody tr:first-of-type,
+.cross tbody tr:nth-of-type(2),
+.cross td:first-of-type,
+.cross td:nth-of-type(2) {
+	font-weight: bold;
+	color: white;
+	background-color: #446CAA
+}
+
+.cross tbody tr:first-of-type td:first-of-type,
+.cross tbody tr:nth-of-type(2) td:first-of-type,
+.cross tbody tr:first-of-type td:nth-of-type(2),
+.cross tbody tr:nth-of-type(2) td:nth-of-type(2) {
+	border: none;
+	background-color: white;
+}
+
+.example-data th:first-of-type:not(:last-of-type),
+.legend tbody tr:first-of-type {
+	background-color: green;
+}
+
+.nav th:nth-of-type(2),
+.nav-2 th:nth-of-type(3),
+.nav-2 th:nth-of-type(4),
+.nav-2 th:nth-of-type(5),
+.legend tbody tr:last-of-type {
+	background-color: rgb(255, 128, 0);
+}
+
+.legend td {
+	font-weight: bold;
+	color: white;
+}
+
+.example-data svg>path {
+	fill: none;
+	stroke: black;
+	stroke-width: 2;
+}
+
+p code,
+li code,
+h1 code,
+h2 code,
+h3 code,
+h4 code,
+h5 code,
+h6 code {
+	font-family: MJXZERO, MJXTEX-T;
+	font-size: 1em;
+	line-height: 0;
+}
+
+.example p code,
+.example li code {
+	font-style: initial;
+}
+
+.example pre {
+	margin-left: 40px;
+}
+
+h1 code,
+h2 code,
+h3 code,
+h4 code,
+h5 code,
+h6 code {
+	font-size: unset;
+}
+
+mjx-container {
+	font-size: unset !important;
+}
+
+mjx-container[display=true] {
+	text-align: left !important;
+	margin-left: 40px !important;
+}
+
+/* The following rule enables typewriter single quotes in maths, like $\hbox{\tt{'$Q$'}}$ */
+mjx-c.mjx-c2019::before {
+	content: "\27" !important;
+	padding-right: 0.525em !important;
+	font-family: MJXZERO, MJXTEX-T;
+}
+
+code .er {
+	color: unset !important;
+	font-weight: unset !important;
+}
+
+hr:first-of-type {
+	page-break-before: avoid;
+}
+
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+	page-break-after: avoid;
+}
+
+h2[id="22-example-data"] {
+	page-break-before: always;
+}