Added JSON /views example (#1857)

Author: Steveb-p

docs/api/rest_api/rest_api_reference/input/examples/views/POST/ViewInput.json.example

@@ -0,0 +1,28 @@
+{
+    "ViewInput": {
+        "identifier": "TitleView",
+        "Query": {
+            "Filter": {
+                "ContentTypeIdentifierCriterion": "image",
+                "SectionIdentifierCriterion": "media",
+                "DateMetadataCriterion": {
+                    "Target": "modified",
+                    "Value": 1675681020,
+                    "Operator": "gte"
+                }
+            },
+            "limit": 10,
+            "offset": 0,
+            "SortClauses": {
+                "ContentName": "ascending"
+            },
+            "Aggregations": [
+                {
+                    "ContentTypeTermAggregation": {
+                        "name": "some name"
+                    }
+                }
+            ]
+        }
+    }
+}

docs/api/rest_api/rest_api_reference/input/examples/views/POST/ViewInput.xml.example

@@ -1,18 +1,27 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <ViewInput>
   <identifier>TitleView</identifier>
-  <ContentQuery>
+  <Query>
     <Filter>
       <ContentTypeIdentifierCriterion>image</ContentTypeIdentifierCriterion>
       <SectionIdentifierCriterion>media</SectionIdentifierCriterion>
+      <DateMetadataCriterion>
+        <Target>modified</Target>
+        <Value>1675681020</Value>
+        <Operator>gte</Operator>
+      </DateMetadataCriterion>
     </Filter>
     <limit>10</limit>
     <offset>0</offset>
     <SortClauses>
       <ContentName>ascending</ContentName>
     </SortClauses>
-    <FacetBuilders>
-      <contentTypeFacetBuilder/>
-    </FacetBuilders>
-  </ContentQuery>
+    <Aggregations>
+      <Aggregation>
+        <ContentTypeTermAggregation>
+          <name>some name</name>
+        </ContentTypeTermAggregation>
+      </Aggregation>
+    </Aggregations>
+  </Query>
 </ViewInput>

docs/api/rest_api/rest_api_reference/input/ez-views.raml

@@ -1,7 +1,12 @@
 displayName: Views
 post:
     displayName: Create View
-    description: Executes a query and returns a View including the results. The View input reflects the criteria model of the public API.
+    description: |
+        Executes a query and returns a View including the results.
+
+        View input reflects the criteria model of the public API.
+
+        Refer to [Search Criteria Reference](/en/latest/search/criteria_reference/search_criteria_reference/)
     headers:
         Accept:
             description: The view in XML or JSON format.
@@ -21,6 +26,9 @@ post:
         application/vnd.ibexa.api.ViewInput+xml:
             type: ViewInput
             example: !include examples/views/POST/ViewInput.xml.example
+        application/vnd.ibexa.api.ViewInput+json:
+            type: ViewInput
+            example: !include examples/views/POST/ViewInput.json.example
     responses:
         200:
             body:

tools/raml2html/composer.json

@@ -20,7 +20,9 @@
         "raml-org/raml-php-parser": "dev-master",
         "twig/twig": "^2.0",
         "symfony/filesystem": "^4.2",
-        "ramsey/uuid": "^3.9"
+        "ramsey/uuid": "^3.9",
+        "twig/markdown-extra": "^3.5",
+        "league/commonmark": "^2.3"
     },
     "require-dev": {
         "symfony/var-dumper": "^4.2",

tools/raml2html/src/Application.php

@@ -12,6 +12,10 @@
 use EzSystems\Raml2Html\Twig\Extension\RenderExtension;
 use Symfony\Component\Console\Application as BaseApplication;
 use Twig as Twig;
+use Twig\Extra\Markdown\DefaultMarkdown;
+use Twig\Extra\Markdown\MarkdownExtension;
+use Twig\Extra\Markdown\MarkdownRuntime;
+use Twig\RuntimeLoader\RuntimeLoaderInterface;
 
 final class Application extends BaseApplication
 {
@@ -49,6 +53,16 @@ public function getTwig(): Twig\Environment
 
             $this->twig = new Twig\Environment($loader, $options);
             $this->twig->addExtension(new RenderExtension());
+            $this->twig->addExtension(new MarkdownExtension());
+            $this->twig->addRuntimeLoader(new class implements RuntimeLoaderInterface {
+                public function load($class): ?MarkdownRuntime {
+                    if (MarkdownRuntime::class === $class) {
+                        return new MarkdownRuntime(new DefaultMarkdown());
+                    }
+
+                    return null;
+                }
+            });
         }
 
         return $this->twig;

tools/raml2html/themes/default/resource.html.twig

@@ -15,7 +15,7 @@
                 <span data-field="method" class="badge badge--sm badge--{{ method.type|lower }}">{{ method.type }}</span>
                 <span data-field="url">{{ resource.uri }}</span>
             </p>
-            <p data-field="body">{{ method.description }}</p>
+            <p data-field="body">{{ method.description|default('')|markdown_to_html }}</p>
             {% include theme ~ "/method-headers.html.twig" %}
 
             {% include theme ~ "/method-query-parameters.html.twig" %}