diff --git a/README.md b/README.md index d4c84a073b..b73d57f9fe 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,11 @@ This site contains the OpenAPI Initiative Registry and content for the HTML vers ## Development +> [!NOTE] +> As of 2024-08-28 Jekyll version 4.3.2 does _not_ work with Ruby 3.3.x. +> +> Make sure you have Ruby 3.2.x or lower installed. + Install [jekyll](https://jekyllrb.com/docs/installation/) for your platform, install the site ~~~sh bundle install diff --git a/index.md b/index.md index 3798a9a22c..2b80996f5b 100644 --- a/index.md +++ b/index.md @@ -28,15 +28,20 @@ This site contains the OpenAPI Initiative Registry and content for the HTML vers {% assign schema_files = site.static_files | where: "extname", "" | sort: "path" | reverse %} {% assign last_version = "" %} +{% assign last_kind = "" %} {%- for file in schema_files -%} {%- assign segments = file.path | split: "/" -%} -{%- if segments[1] == "oas" and file.basename contains "lat" -%} +{%- if segments[1] == "oas" and file.basename contains "-" -%} {%- if segments[2] != last_version -%} {%- assign last_version = segments[2] %} * **v{{ last_version }}** +{%- endif -%} +{%- if segments[3] != last_kind -%} +{%- assign last_kind = segments[3] %} + * [**{{ last_kind }}**]({{ site.baseurl }}/oas/{{ last_version }}/{{ last_kind }}/latest.html) {%- assign separator = ": " -%} {%- endif -%} -{{ separator }}[{{ segments[3] }}]({{ file.path }}) +{{ separator }} [{{ file.basename }}]({{ site.baseurl }}{{ file.path }}) {%- assign separator = ", " -%} {%- endif -%} -{%- endfor -%} +{%- endfor %} diff --git a/oas/3.0/schema/latest.md b/oas/3.0/schema/latest.md new file mode 100644 index 0000000000..b4af544a38 --- /dev/null +++ b/oas/3.0/schema/latest.md @@ -0,0 +1,9 @@ +--- +title: JSON Schema for OpenAPI 3.0 +layout: default +parent: Schemas +--- + +```json +{% include_relative latest %} +``` \ No newline at end of file diff --git a/oas/3.1/schema-base/latest.md b/oas/3.1/schema-base/latest.md new file mode 100644 index 0000000000..b38cc2864d --- /dev/null +++ b/oas/3.1/schema-base/latest.md @@ -0,0 +1,9 @@ +--- +title: JSON Schema for OpenAPI 3.1 - with schema validation +layout: default +parent: Schemas +--- + +```json +{% include_relative latest %} +``` \ No newline at end of file diff --git a/oas/3.1/schema/latest.md b/oas/3.1/schema/latest.md new file mode 100644 index 0000000000..c80f6d0b23 --- /dev/null +++ b/oas/3.1/schema/latest.md @@ -0,0 +1,9 @@ +--- +title: JSON Schema for OpenAPI 3.1 - without schema validation +layout: default +parent: Schemas +--- + +```json +{% include_relative latest %} +``` \ No newline at end of file