ExportFormatter: Add book description and check for empty book and chapter descriptio...

[bookstack] / resources / views / api-docs / index.blade.php

diff --git a/resources/views/api-docs/index.blade.php b/resources/views/api-docs/index.blade.php
index 181bcd746149dd37d0457a7c94144ec2ff64d379..9345a7bcead45420fdb3825b1cf51227edb21861 100644 (file)
--- a/resources/views/api-docs/index.blade.php
+++ b/resources/views/api-docs/index.blade.php
@@ -1,44 +1,53 @@
-@extends('simple-layout')
+@extends('layouts.simple')

 
 @section('body')
 
     <div class="container pt-xl">
 
         <div class="grid right-focus reverse-collapse">
 
 @section('body')
 
     <div class="container pt-xl">
 
         <div class="grid right-focus reverse-collapse">

-

             <div>
             <div>

-                @foreach($docs as $model => $endpoints)
-                    <p class="text-uppercase text-muted mb-xm mt-l"><strong>{{ $model }}</strong></p>
-
-                    @foreach($endpoints as $endpoint)
-                        <div class="mb-xs">
-                            <a href="#{{ $endpoint['name'] }}" class="text-mono">
-                                <span class="api-method" data-method="{{ $endpoint['method'] }}">{{ $endpoint['method'] }}</span>
-                                /{{ $endpoint['uri'] }}
-                            </a>
-                        </div>
+
+                <div class="sticky-sidebar">
+                    <p class="text-uppercase text-muted mb-xm mt-l"><strong>Getting Started</strong></p>
+
+                    <div class="text-mono">
+                        <div class="mb-xs"><a href="#authentication">Authentication</a></div>
+                        <div class="mb-xs"><a href="#request-format">Request Format</a></div>
+                        <div class="mb-xs"><a href="#listing-endpoints">Listing Endpoints</a></div>
+                        <div class="mb-xs"><a href="#error-handling">Error Handling</a></div>
+                        <div class="mb-xs"><a href="#rate-limits">Rate Limits</a></div>
+                        <div class="mb-xs"><a href="#content-security">Content Security</a></div>
+                    </div>
+
+                    @foreach($docs as $model => $endpoints)
+                        <p class="text-uppercase text-muted mb-xm mt-l"><strong>{{ $model }}</strong></p>
+
+                        @foreach($endpoints as $endpoint)
+                            <div class="mb-xs">
+                                <a href="#{{ $endpoint['name'] }}" class="text-mono inline block mr-s">
+                                    <span class="api-method" data-method="{{ $endpoint['method'] }}">{{ $endpoint['method'] }}</span>
+                                </a>
+                                <a href="#{{ $endpoint['name'] }}" class="text-mono">
+                                    {{ $endpoint['controller_method_kebab'] }}
+                                </a>
+                            </div>
+                        @endforeach

                     @endforeach
                     @endforeach

-                @endforeach
+                </div>

             </div>
 
             </div>
 

-            <div>
+            <div style="overflow: auto;">
+
+                <section component="code-highlighter" class="card content-wrap auto-height">
+                    @include('api-docs.parts.getting-started')
+                </section>
+

                 @foreach($docs as $model => $endpoints)
                     <section class="card content-wrap auto-height">
                         <h1 class="list-heading text-capitals">{{ $model }}</h1>
 
                         @foreach($endpoints as $endpoint)
                 @foreach($docs as $model => $endpoints)
                     <section class="card content-wrap auto-height">
                         <h1 class="list-heading text-capitals">{{ $model }}</h1>
 
                         @foreach($endpoints as $endpoint)

-                            <h5 id="{{ $endpoint['name'] }}" class="text-mono mb-m">
-                                <span class="api-method" data-method="{{ $endpoint['method'] }}">{{ $endpoint['method'] }}</span>
-                                {{ url($endpoint['uri']) }}
-                            </h5>
-                            <p class="mb-m">{{ $endpoint['description'] ?? '' }}</p>
-                            @if($endpoint['example_response'] ?? false)
-                                <details details-highlighter>
-                                    <summary class="text-muted">Example Response</summary>
-                                    <pre><code class="language-json">{{ $endpoint['example_response'] }}</code></pre>
-                                </details>
-                                <hr class="mt-m">
-                            @endif
+                            @include('api-docs.parts.endpoint', ['endpoint' => $endpoint, 'loop' => $loop])

                         @endforeach
                     </section>
                 @endforeach
                         @endforeach
                     </section>
                 @endforeach