iugu-docs-theme 0.1.0

data/_includes/schema/nested_table.liquid

@@ -0,0 +1,44 @@
+{% assign name = include.property[0] %}
+{% assign param = include.property[1] %}
+{% if param.type == 'object' or param.type == 'array' %}
+  {% assign nesting = true %}
+{% else %}
+  {% assign nesting = false %}
+{% endif %}
+
+<table class="w-full bg-slate-400/5 dark:bg-slate-600/5">
+  <tbody>
+    <tr class="hover:bg-neutral-100 dark:hover:bg-neutral-800" >
+      <td colspan="2" {% if nesting %} class="cursor-pointer" x-data @click="$store.{{name}}Open = ! $store.{{name}}Open"{% endif %}>
+        {% include params/card.liquid
+                  name=name
+                  item_required=param.item_required
+                  type=param.type
+                  description=param.description
+                  example=param.example
+                  nesting=nesting %}
+      </td>
+    </tr>
+    {% if param.type == 'object' %}
+      <tr>
+        <td colspan="2">
+          <div class="border-l border-dashed border-neutral-300 dark:border-neutral-700 ml-6" x-collapse x-show="Alpine.store('{{name}}Open')">
+            {% for prop in param.properties %}
+              {% include schema/nested_table.liquid property=prop %}
+            {% endfor %}
+          </div>
+        </td>
+      </tr>
+    {% elsif param.type == 'array' %}
+      <tr>
+        <td colspan='2'>
+          <div class="border-l border-dashed border-neutral-300 dark:border-neutral-700 ml-6" x-data x-collapse x-show="Alpine.store('{{name}}Open')">
+            {% for prop in param.items.properties %}
+              {% include schema/nested_table.liquid property = prop %}
+            {% endfor %}
+          </div>
+        </td>
+      </tr>
+    {% endif %}
+  </tbody>
+</table>

data/_includes/schema/table.liquid

@@ -0,0 +1,36 @@
+{% if schema %}
+  {% assign properties = schema %}
+{% elsif include.properties %}
+  {% assign properties = include.properties %}
+{% endif %}
+
+<div class='not-prose'>
+  <div class='relative border dark:border-neutral-800 dark:bg-neutral-900 rounded-xl overflow-auto'>
+    <div class='shadow-sm overflow-hidden'>
+      <table class='border-collapse table-auto w-full text-sm'>
+        <thead>
+          <tr>
+            <th colspan='2' class='dark:border-neutral-800 bg-neutral-100 dark:bg-neutral-800 pl-6 font-medium py-3 dark:text-slate-200 text-left'>
+              <p class="text-xl pb-2 font-semibold">
+                {{ include.title | default: "Schema" }}
+                {% if include.request_required %}
+                  <i class='pt-2 text-xs text-red-500'>{% t schema.table.required %}</i>
+                {% endif %}
+              </p>
+              <p class="italic">{% t schema.table.content_type %}: {{ include.type }}</p>
+            </th>
+          </tr>
+        </thead>
+        <tbody x-data>
+          <tr>
+            <td>
+              {% for property in properties %}
+                {% include schema/nested_table.liquid property=property %}
+              {% endfor %}
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+  </div>
+</div>

data/_includes/search_modal.liquid

@@ -0,0 +1,34 @@
+<div id="buttonmodal" class="bg-black/50 fixed hidden top-0 justify-center z-50 w-full h-full">
+  <div class="modal pt-32 h-32 w-1/3">
+    <input type="text" placeholder="{% t search_modal.search %}" onfocus="this.value=''" name="search" id="searchInput" class="bg-neutral-100 w-full block rounded-md text-left px-4 py-1.5 outline-none shadow-md text-neutral-500">
+    <div class="pt-1" id="searchResults">
+    </div>
+</div>
+
+<script>
+  const element = document.getElementById('search-modal');
+
+  element.addEventListener('click', function(event) {
+    event.preventDefault();
+    event.stopPropagation();
+    document.getElementById('buttonmodal').style.display = 'flex';
+    document.getElementById('searchInput').focus()
+  });
+
+  document.getElementById('buttonmodal').addEventListener('click', function(event) {
+    if(event.target.closest('.modal')) return;
+    document.getElementById('buttonmodal').style.display = 'none';
+  });
+
+  document.addEventListener("keydown", function(event){
+    if((event.ctrlKey || event.metaKey) && event.key == "k") {
+      element.click()
+    }
+
+    if(event.key == "Escape") {
+      document.getElementById('buttonmodal').style.display = 'none';
+      document.getElementById('searchInput').focus
+    }
+  });
+
+</script>

data/_includes/sidebar_menu.liquid

@@ -0,0 +1,28 @@
+{% assign has_toc = site.pages | find: "path", "toc.yaml" %}
+<section>
+  <div
+    class="sidebar-menu z-50 p-5 top-16 bg-white dark:bg-neutral-950 w-full fixed h-full overflow-y-auto md:left-0"
+    :class="{ 'hidden': !open }"
+    x-cloak>
+    <div class="lg:hidden flex justify-end">
+      {% include dark_mode_button.liquid %}
+    </div>
+    {% if has_toc %}
+      {{ page.path | toc_yaml }}
+    {% endif %}
+  </div>
+  {% if has_toc %}
+    <div
+      x-data="$store.sidebarOpen = true"
+      :class="Alpine.store('sidebarOpen') ? 'w-full max-w-[25ch]' : 'w-0'"
+      class="sidebar-menu z-50 p-5 top-16 bg-white dark:bg-neutral-950 fixed h-full overflow-y-auto md:left-0 border-r border-r-gray-100 dark:border-r-neutral-800 hidden lg:block">
+      <div
+        @click="$store.sidebarOpen = !$store.sidebarOpen"
+        class="cursor-pointer w-5 h-auto absolute top-0 end-0"
+        title="recolher barra lateral">
+        <button class="arrow left" :class="{left: Alpine.store('sidebarOpen'), right: !Alpine.store('sidebarOpen')}"></button>
+      </div>
+      <div id="sidebar-links" x-show="Alpine.store('sidebarOpen')" x-collapse>{{ page.path | toc_yaml }}</div>
+    </div>
+  {% endif %}
+</section>

data/_includes/toc.html

@@ -0,0 +1,174 @@
+{% capture tocWorkspace %}
+    {% comment %}
+        Copyright (c) 2017 Vladimir "allejo" Jimenez
+        Permission is hereby granted, free of charge, to any person
+        obtaining a copy of this software and associated documentation
+        files (the "Software"), to deal in the Software without
+        restriction, including without limitation the rights to use,
+        copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the
+        Software is furnished to do so, subject to the following
+        conditions:
+        The above copyright notice and this permission notice shall be
+        included in all copies or substantial portions of the Software.
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+        OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+        NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+        HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+        WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+        FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+        OTHER DEALINGS IN THE SOFTWARE.
+    {% endcomment %}
+    {% comment %}
+        Version 1.2.0
+          https://github.com/allejo/jekyll-toc
+        "...like all things liquid - where there's a will, and ~36 hours to spare, there's usually a/some way" ~jaybe
+        Usage:
+            {% include toc.html html=content sanitize=true class="inline_toc" id="my_toc" h_min=2 h_max=3 %}
+        Parameters:
+            * html         (string) - the HTML of compiled markdown generated by kramdown in Jekyll
+        Optional Parameters:
+            * sanitize      (bool)   : false  - when set to true, the headers will be stripped of any HTML in the TOC
+            * class         (string) :   ''   - a CSS class assigned to the TOC
+            * id            (string) :   ''   - an ID to assigned to the TOC
+            * h_min         (int)    :   1    - the minimum TOC header level to use; any header lower than this value will be ignored
+            * h_max         (int)    :   6    - the maximum TOC header level to use; any header greater than this value will be ignored
+            * ordered       (bool)   : false  - when set to true, an ordered list will be outputted instead of an unordered list
+            * item_class    (string) :   ''   - add custom class(es) for each list item; has support for '%level%' placeholder, which is the current heading level
+            * submenu_class (string) :   ''   - add custom class(es) for each child group of headings; has support for '%level%' placeholder which is the current "submenu" heading level
+            * base_url      (string) :   ''   - add a base url to the TOC links for when your TOC is on another page than the actual content
+            * anchor_class  (string) :   ''   - add custom class(es) for each anchor element
+            * skip_no_ids   (bool)   : false  - skip headers that do not have an `id` attribute
+        Output:
+            An ordered or unordered list representing the table of contents of a markdown block. This snippet will only
+            generate the table of contents and will NOT output the markdown given to it
+    {% endcomment %}
+
+    {% capture newline %}
+    {% endcapture %}
+    {% assign newline = newline | rstrip %} <!-- Remove the extra spacing but preserve the newline -->
+
+    {% capture deprecation_warnings %}{% endcapture %}
+
+    {% if include.baseurl %}
+        {% capture deprecation_warnings %}{{ deprecation_warnings }}<!-- jekyll-toc :: "baseurl" has been deprecated, use "base_url" instead -->{{ newline }}{% endcapture %}
+    {% endif %}
+
+    {% if include.skipNoIDs %}
+        {% capture deprecation_warnings %}{{ deprecation_warnings }}<!-- jekyll-toc :: "skipNoIDs" has been deprecated, use "skip_no_ids" instead -->{{ newline }}{% endcapture %}
+    {% endif %}
+
+    {% capture jekyll_toc %}{% endcapture %}
+    {% assign orderedList = include.ordered | default: false %}
+    {% assign baseURL = include.base_url | default: include.baseurl | default: '' %}
+    {% assign skipNoIDs = include.skip_no_ids | default: include.skipNoIDs | default: false %}
+    {% assign minHeader = include.h_min | default: 1 %}
+    {% assign maxHeader = include.h_max | default: 6 %}
+    {% assign nodes = include.html | strip | split: '<h' %}
+
+    {% assign firstHeader = true %}
+    {% assign currLevel = 0 %}
+    {% assign lastLevel = 0 %}
+
+    {% capture listModifier %}{% if orderedList %}ol{% else %}ul{% endif %}{% endcapture %}
+
+    {% for node in nodes %}
+        {% if node == "" %}
+            {% continue %}
+        {% endif %}
+
+        {% assign currLevel = node | replace: '"', '' | slice: 0, 1 | times: 1 %}
+
+        {% if currLevel < minHeader or currLevel > maxHeader %}
+            {% continue %}
+        {% endif %}
+
+        {% assign _workspace = node | split: '</h' %}
+
+        {% assign _idWorkspace = _workspace[0] | split: 'id="' %}
+        {% assign _idWorkspace = _idWorkspace[1] | split: '"' %}
+        {% assign htmlID = _idWorkspace[0] %}
+
+        {% assign _classWorkspace = _workspace[0] | split: 'class="' %}
+        {% assign _classWorkspace = _classWorkspace[1] | split: '"' %}
+        {% assign htmlClass = _classWorkspace[0] %}
+
+        {% if htmlClass contains "no_toc" %}
+            {% continue %}
+        {% endif %}
+
+        {% if firstHeader %}
+            {% assign minHeader = currLevel %}
+        {% endif %}
+
+        {% capture _hAttrToStrip %}{{ _workspace[0] | split: '>' | first }}>{% endcapture %}
+        {% assign header = _workspace[0] | replace: _hAttrToStrip, '' %}
+
+        {% if include.item_class and include.item_class != blank %}
+            {% capture listItemClass %} class="{{ include.item_class | replace: '%level%', currLevel | split: '.' | join: ' ' }}"{% endcapture %}
+        {% endif %}
+
+        {% if include.submenu_class and include.submenu_class != blank %}
+            {% assign subMenuLevel = currLevel | minus: 1 %}
+            {% capture subMenuClass %} class="{{ include.submenu_class | replace: '%level%', subMenuLevel | split: '.' | join: ' ' }}"{% endcapture %}
+        {% endif %}
+
+        {% capture anchorBody %}{% if include.sanitize %}{{ header | strip_html }}{% else %}{{ header }}{% endif %}{% endcapture %}
+
+        {% if htmlID %}
+            {% capture anchorAttributes %} href="{% if baseURL %}{{ baseURL }}{% endif %}#{{ htmlID }}"{% endcapture %}
+
+            {% if include.anchor_class %}
+                {% capture anchorAttributes %}{{ anchorAttributes }} class="{{ include.anchor_class | split: '.' | join: ' ' }}"{% endcapture %}
+            {% endif %}
+
+            {% capture listItem %}<a{{ anchorAttributes }}>{{ anchorBody }}</a>{% endcapture %}
+        {% elsif skipNoIDs == true %}
+            {% continue %}
+        {% else %}
+            {% capture listItem %}{{ anchorBody }}{% endcapture %}
+        {% endif %}
+
+        {% if currLevel > lastLevel %}
+            {% capture jekyll_toc %}{{ jekyll_toc }}<{{ listModifier }}{{ subMenuClass }}>{% endcapture %}
+        {% elsif currLevel < lastLevel %}
+            {% assign repeatCount = lastLevel | minus: currLevel %}
+
+            {% for i in (1..repeatCount) %}
+                {% capture jekyll_toc %}{{ jekyll_toc }}</li></{{ listModifier }}>{% endcapture %}
+            {% endfor %}
+
+            {% capture jekyll_toc %}{{ jekyll_toc }}</li>{% endcapture %}
+        {% else %}
+            {% capture jekyll_toc %}{{ jekyll_toc }}</li>{% endcapture %}
+        {% endif %}
+
+        {% capture jekyll_toc %}{{ jekyll_toc }}<li{{ listItemClass }}>{{ listItem }}{% endcapture %}
+
+        {% assign lastLevel = currLevel %}
+        {% assign firstHeader = false %}
+    {% endfor %}
+
+    {% assign repeatCount = minHeader | minus: 1 %}
+    {% assign repeatCount = lastLevel | minus: repeatCount %}
+    {% for i in (1..repeatCount) %}
+        {% capture jekyll_toc %}{{ jekyll_toc }}</li></{{ listModifier }}>{% endcapture %}
+    {% endfor %}
+
+    {% if jekyll_toc != '' %}
+        {% assign rootAttributes = '' %}
+        {% if include.class and include.class != blank %}
+            {% capture rootAttributes %} class="{{ include.class | split: '.' | join: ' ' }}"{% endcapture %}
+        {% endif %}
+
+        {% if include.id and include.id != blank %}
+            {% capture rootAttributes %}{{ rootAttributes }} id="{{ include.id }}"{% endcapture %}
+        {% endif %}
+
+        {% if rootAttributes %}
+            {% assign nodes = jekyll_toc | split: '>' %}
+            {% capture jekyll_toc %}<{{ listModifier }}{{ rootAttributes }}>{{ nodes | shift | join: '>' }}>{% endcapture %}
+        {% endif %}
+    {% endif %}
+{% endcapture %}{% assign tocWorkspace = '' %}{{ deprecation_warnings }}{{ jekyll_toc -}}

data/_includes/toc_content.liquid

@@ -0,0 +1,21 @@
+{% if include.subsection %}
+  {% assign tree = include.subsection %}
+{% else %}
+  {% assign tree = nav_h %}
+{% endif %}
+
+{% for branch in tree %}
+  {% if branch.title %}
+    <li class="py-1 flex border-l-4  hover:border-neutral-800  justify-between border-neutral-100 dark:border-neutral-900 hover:dark:border-neutral-200 hover:text-black hover:dark:text-white text-neutral-600 dark:text-neutral-400">
+      <a class="pl-2 toc-h1 font-medium" href="{{ site.baseurl }}{{ branch.url }}"> {{ branch.title }}</a>
+      {% if branch.method %}
+        <span class="font-semibold {{ site.data.method-colors[branch.method] }} uppercase text-center text-white h-5 w-12 py-0.5 px-1 rounded-md text-[10px]">{{ branch.method }}</span>
+      {% endif %}
+    </li>
+  {% else %}
+    <h2 class="py-2 uppercase text-black dark:text-white font-semibold text-md">{{ branch.section }}</h2>
+    <ul class="pl-2 mb-2">
+      {% include toc_content.liquid subsection = branch.children %}
+    </ul>
+  {% endif %}
+{% endfor %}

data/_includes/widget.liquid

@@ -0,0 +1,17 @@
+<a href="{{include.app.url}}" class="m-0 no-underline">
+  <li class="flex flex-row justify-between rounded-lg my-0 hover:bg-neutral-50 dark:hover:bg-neutral-700 border border-neutral-100 dark:border-neutral-700 bg-white dark:bg-neutral-800 shadow h-32">
+    {% if include.app.logo %}
+      <img src="{{include.app.logo }}" class="h-16 md:h-20 m-4 md:m-5 self-center">
+    {% else %}
+      <div class="h-16 md:h-20 aspect-square m-4 md:m-5 rounded-full bg-blue-500 flex-shrink-0 flex justify-center self-center items-center">
+        <span class="text-3xl lg:text-4xl text-white dark:text-black">{{include.app.name | truncate: 2, ""}}</span>
+      </div>
+    {% endif %}
+    <div class="w-2/3 flex p-4">
+      <div class="flex flex-1 w-full flex-col">
+        <p class="mb-1 mt-0 text-md lg:text-lg font-bold text-neutral-900 dark:text-neutral-100">{{include.app.name | capitalize}}</p>
+        <p class="text-sm my-0 line-clamp-3 text-neutral-500 dark:text-neutral-300">{{include.app.description}}</p>
+      </div>
+    </div>
+  </li>
+</a>

data/_includes/widgets_base.liquid

@@ -0,0 +1,5 @@
+<ul role="list" class="grid grid-cols-1 gap-5 sm:grid-cols-2 md:grid-cols-2 lg:grid-cols-3 px-6">
+  {% for app in content.apps %}
+    {% include widget.liquid  app=app%}
+  {% endfor %}
+</ul>

data/_layouts/default.html

@@ -0,0 +1,100 @@
+<!DOCTYPE html>
+<html lang="{{ site.lang | default: "en-US" }}" class="light">
+  <head>
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta charset="utf-8">
+    <title>{{ page.title }} - {{ site.title }}</title>
+    <link rel="stylesheet" href="{{ "/assets/css/application.css" | absolute_url }}">
+    <link rel="stylesheet" href="{{ "/assets/css/highlight.css" | absolute_url }}">
+    <script type="module" src="{{ "/assets/js/main.js" | absolute_url }}"></script>
+    <script src="{{ "/assets/js/highlight_menu.js" | absolute_url }}"></script>
+    <script src="https://rawcdn.githack.com/nextapps-de/flexsearch/0.7.31/dist/flexsearch.bundle.js"></script>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/markdown-it/13.0.1/markdown-it.min.js"></script>
+
+    <script type="module">
+      import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs';
+    </script>
+    <script defer src="https://cdn.jsdelivr.net/npm/@alpinejs/collapse@3.x.x/dist/cdn.min.js"></script>
+    <script src="//unpkg.com/alpinejs" defer></script>
+
+    {% assign reversed_posts = site.posts | reverse %}
+
+    {% if reversed_posts %}
+        <link rel="next" href="{{site.baseurl}}{{reversed_posts.first.url}}" />
+    {% endif %}
+
+    <script type="text/javascript">
+      window.addEventListener('DOMContentLoaded', () => {
+
+        var firstEl = document.querySelector("#toc .toc-entry a");
+        if (firstEl) {
+          // document.querySelectorAll(`.toc-ref .title`).forEach( j => { j.textContent = firstEl.textContent } )
+        }
+        document.querySelectorAll("#toc .toc-entry a").forEach( entry => {
+          entry.addEventListener("click", e => {
+            document.querySelectorAll("#toc .toc-entry a").forEach( j => { j.className = "" })
+            e.target.className = "active";
+            document.querySelectorAll(`.toc-ref .title`).forEach( j => { j.textContent = e.target.textContent } )
+          });
+        });
+
+      const observer = new IntersectionObserver(entries => {
+        entries.every(entry => {
+          const id = entry.target.getAttribute('id');
+          if (entry.intersectionRatio > 0) {
+            let el = document.querySelector(`#toc li a[href="#${id}"]`);
+            if (el) {
+              document.querySelectorAll(`#toc li a`).forEach( e => e.classList.remove('active') );
+              el.classList.add('active');
+              document.querySelectorAll(`.toc-ref .title`).forEach( e => e.innerHTML = entry.target.textContent );
+              return false;
+            }
+            return true;
+          }
+        });
+      });
+
+      // Track all sections that have an `id` applied
+      document.querySelectorAll('h1[id],h2[id],h3[id],h4[id],h5[id]').forEach((section) => {
+        observer.observe(section);
+      });
+
+      });
+    </script>
+  </head>
+  <body class="dark:bg-black">
+    <div class="relative bg-white dark:bg-neutral-950 ml-auto mr-auto">
+      {%- include header.html -%}
+      {% assign has_toc = site.pages | find: "path", "toc.yaml" %}
+      {% if has_toc %}
+        {% assign left_margin = 'lg:ml-[25ch]' %}
+      {% endif %}
+      {% if page.toc %}
+        {% assign right_margin = 'md:mr-[22ch]' %}
+      {% endif %}
+      <div x-data :class="{'lg:ml-[2ch]': !$store.sidebarOpen, 'lg:ml-[25ch]': $store.sidebarOpen }"  class="{{ left_margin }} {{right_margin}} ">
+        <article class="antialiased prose max-w-[120ch] ml-auto mr-auto px-10 mb-10 dark:prose-invert prose-headings:font-semibold prose-code:text-gray-500 prose-pre:bg-neutral-800">
+          {{ content }}
+          {% if reversed_posts %}
+            <a href="{{site.baseurl}}{{reversed_posts.first.url}}" class="navigation navigation-next navigation-unique" aria-label="Next page: {{reversed_posts.first.title}}">
+              <i class="fa fa-angle-right"></i>
+            </a>
+          {% endif %}
+          {{ page.url | navigation }}
+        </article>
+      </div>
+      <div x-data="{scrollBackTop: false}" x-cloak>
+        <button
+         x-show="scrollBackTop"
+         x-on:scroll.document="scrollBackTop = (document.documentElement.scrollTop > 500) ? true : false"
+         @click="window.scrollTo({top: 0, behavior: 'smooth'})"
+         aria-label="Back to top"
+         class="fixed w-10 h-10 rounded-full z-50 bottom-0 right-0 p-2 mx-5 my-5 dark:bg-gray-500 text-white bg-gray-200 hover:bg-gray-700 dark:hover:bg-slate-300 focus:outline-none">
+           <i class="arrow up"></i>
+        </button>
+      </div>
+      {%- include footer.html -%}
+    </div>
+    {% include search_modal.liquid %}
+  </body>
+</html>

data/_layouts/page.html

@@ -0,0 +1,5 @@
+---
+layout: default
+---
+
+{{ content }}

data/_layouts/post.html

@@ -0,0 +1,5 @@
+---
+layout: default
+---
+
+{{ content }}

data/_plugins/authorization_parser.rb

@@ -0,0 +1,51 @@
+class AuthorizationParser
+  def self.parse(api)
+    new.parse(api)
+  end
+
+  def parse(api)
+    return if api.dig('components', 'securitySchemes').nil?
+        
+    array = []
+    security_schemes = api['components']['securitySchemes']
+    security_schemes.each do |k, v|
+      obj = {'items' => {}}
+      obj['Title'] = k
+      obj['Type'] = v['type']
+      obj['Description'] = v['description'] if v['description']
+      case v['type']
+      when 'apiKey'
+        obj['items']['Name'] = v['name']
+        obj['items']['In'] = v['in']
+      when 'http'
+        obj['items']['HTTP'] = v['bearerFormat'] if v['bearerFormat']
+        obj['items']['HTTP Authorization Scheme'] = v['scheme']
+      when 'mutualTLS'
+        puts "\n\nmutualTLS security scheme parser not implemented yet\n\n"
+      when 'oauth2' then oauth2_parser(v, obj)
+      when 'openIdConnect'
+        puts "\n\nopenIdConnect security scheme parser not implemented yet\n\n"
+      end
+      array << obj
+    end
+    array
+  end
+
+  def oauth2_parser(scheme, obj)
+    scheme['flows'].each do |flow, flow_object|
+      obj['items']['Flow type'] = flow
+      obj['items']['Authorization URL'] = flow_object['authorizationUrl'] if flow_object['authorizationUrl'] 
+      obj['items']['Token URL'] = flow_object['tokenUrl'] if flow_object['tokenUrl']
+      obj['items']['Refresh URL'] = flow_object['refreshUrl'] if flow_object['refreshUrl']
+      obj['items']['Scopes'] = oauth2_scopes(flow_object['scopes'])
+    end
+  end
+
+  def oauth2_scopes(scopes)
+    result = "<ul>\n"
+    scopes.map do |scope, description|
+      result += "<li>#{scope} - #{description}</li>\n"
+    end
+    result += "</ul>\n"
+  end
+end

data/_plugins/button_processor.rb

@@ -0,0 +1,24 @@
+module Jekyll
+  module Converters
+    class ButtonProcessor < Converter
+      safe true
+      priority :low
+
+      def matches(ext)
+        ext =~ /md/i
+      end
+
+      def output_ext(_ext)
+        ".html"
+      end
+
+      def convert(content)
+        content.gsub(/\$button\[(.*?)\]\[(.*?)\]\$/) do
+          button_text = Regexp.last_match(1)
+          tailwind_class = Regexp.last_match(2)
+          "<button class=\"rounded-md m-0 py-1 px-2 text-center text-sm font-semibold text-white shadow-sm #{tailwind_class}\">#{button_text}</button>"
+        end
+      end
+    end
+  end
+end

data/_plugins/check_required_filter.rb

@@ -0,0 +1,48 @@
+module Jekyll
+  module CheckRequiredFilter
+    def check_required(input, type = "request_body")
+      case type 
+      when 'request_body' then schema = input.dig('content', 'application/json', 'schema')
+      when 'response' then schema = input[1].dig('content', 'application/json', 'schema')
+      end
+      return if schema.nil?
+
+      inject_required(schema, schema['required'] || [])
+      return
+    end
+
+    private
+
+    def inject_required(schema, requires = [])
+      properties = if schema['type'] == 'array'
+                     schema['items']['anyOf'] ? [] : schema['items']['properties']
+                   else
+                     schema['properties']
+                   end
+        if schema['allOf']
+        schema['allOf'].each do |item|
+          inject_required(item, requires)
+        end
+      end
+      requires |= schema['required'] if schema['required'].is_a?(Array)
+      while requires.is_a?(Array) && requires.any? do
+        key = requires.pop
+        next if properties&.dig(key).nil?
+          
+        properties[key]['item_required'] = true
+      end
+      
+      if !properties.nil? && properties.any?
+        properties.each do |key, value|
+          if value['type'] == 'object'
+            inject_required(value, value['required'])
+          elsif value['type'] == 'array'
+            inject_required(value, value['items']['required'])
+          end
+        end
+      end
+    end
+  end
+end
+
+Liquid::Template.register_filter(Jekyll::CheckRequiredFilter)