haveapi 0.31.1 → 0.32.0

data/lib/haveapi/views/version_page/auth_body.erb

@@ -1,17 +1,18 @@
-<h2 id="auth-<%= name %>"><%= name.to_s.humanize %></h2>
+<section data-doc-section id="auth-<%= escape_html(name) %>">
+<h2><%= escape_html(name.to_s.humanize) %><%= documentation_permalink("auth-#{name}", name.to_s.humanize) %></h2>
 <hr>
 
 <p><%= info[:description] %></p>
 
 <% if name == :token %>
-  <dl>
+  <dl class="docs-metadata">
     <dt>HTTP header:</dt>
     <dd><%= info[:http_header] %></dd>
     <dt>Query parameter:</dt>
     <dd><%= info[:query_parameter] %></dd>
   </dl>
 <% elsif name == :oauth2 %>
-  <dl>
+  <dl class="docs-metadata">
     <dt>Authorize URL:</dt>
     <dd><%= info[:authorize_url] %></dd>
     <dt>Token URL:</dt>
@@ -21,37 +22,15 @@
   </dl>
 <% end %>
 
-<% if info[:resources] %>
-  <h2>Resources</h2>
+<% unless (info[:resources] || {}).empty? %>
+  <% resources_target = documentation_reference_anchor(authentication: name, section: :resources) %>
+  <h2 id="<%= escape_html(resources_target) %>">Resources<%= documentation_permalink(resources_target, 'Resources') %></h2>
   <% sort_hash(info[:resources]).each do |resource, desc| %>
-    <%= erb :"version_page/resource_body", locals: {resource: resource.to_s, info: desc, path: [], prefix: 'root', name: nil} %>
+    <%= erb :"version_page/resource_body", locals: {resource: resource.to_s, info: desc, path: [], prefix: 'root', name: nil, authentication_resource: true, authentication_provider: name} %>
   <% end %>
 <% end %>
 
-<% baseid = "auth-#{name}" %>
-<div id="<%= baseid %>-tabbar"></div>
-
-<div id="<%= baseid %>-examples">
-  <% documentation_panels(:auth, auth_method: name, auth_description: info).each do |client, result| %>
-    <div id="<%= escape_html("#{baseid}-#{client.id}") %>">
-      <%= erb :"version_page/client_auth", locals: {client: client, result: result} %>
-    </div>
-  <% end %>
-</div>
-
-<script type="text/javascript">
-nojsTabs({
-  tabs: document.getElementById('<%= "#{baseid}-examples" %>'),
-  titleSelector: 'h4',
-  tabBar: document.getElementById('<%= "#{baseid}-tabbar" %>'),
-  hiddenClass: 'tab-hidden',
-  activeClass: 'active',
-  createElement: function (el) {
-    if (el.tagName == 'UL')
-      el.classList.add('nav', 'nav-tabs');
-
-    else if (el.tagName == 'LI')
-      el.setAttribute('role', 'presentation');
-  }
-});
-</script>
+<% examples_target = documentation_reference_anchor(authentication: name, section: :examples) %>
+<h3 id="<%= escape_html(examples_target) %>">Examples<%= documentation_permalink(examples_target, 'Examples') %></h3>
+<%= erb :'version_page/example_panels', locals: {baseid: "auth-#{name}", kind: :auth, changes: {auth_method: name, auth_description: info}} %>
+</section>

data/lib/haveapi/views/version_page/client_overview.erb

@@ -0,0 +1,40 @@
+<% library_paths = {
+  '0' => 'clients/ruby#client-library',
+  '3' => 'clients/ruby#cli',
+  'javascript-callback' => 'clients/js#javascript-with-callbacks',
+  'javascript-async' => 'clients/js#javascript-with-async-await',
+  'typescript-callback' => 'clients/js#typescript-with-callbacks',
+  'typescript-async' => 'clients/js#typescript-with-async-await',
+  'python-sync' => 'clients/python#synchronous-client',
+  'python-async' => 'clients/python#asynchronous-client',
+  '2' => 'clients/php'
+} %>
+<% generator_paths = {
+  'go' => 'clients/go',
+  'rust-async' => 'clients/rust',
+  'rust-blocking' => 'clients/rust',
+  'typescript-generated' => 'clients/typescript'
+} %>
+<% clients = documentation_clients %>
+<% library_clients = clients.select { |client| library_paths.has_key?(client.id) || generator_paths.has_key?(client.id) } %>
+<% groups = library_clients.group_by { |client| client.language == 'cli' && library_clients.any? { |candidate| candidate.language == 'ruby' } ? 'ruby' : client.language } %>
+<section id="client-libraries">
+  <h2>Client libraries<%= documentation_permalink('client-libraries', 'Client libraries') %></h2>
+  <ul>
+    <% groups.each_value do |group| %>
+      <% variants = group.length > 1 || group.first.variant %>
+      <% profiles = group.filter_map { |client| documentation_context(client).profile if generator_paths.has_key?(client.id) }.uniq %>
+      <li>
+        <% if variants %><%= escape_html(group.first.language_label) %> (<% end %><% group.each_with_index do |client, index|
+          path = library_paths[client.id] || generator_paths.fetch(client.id)
+          label = variants ? (client.variant&.downcase&.sub(/\Aapi\b/, 'API') || (client.language == 'ruby' ? 'library' : client.language_label)) : client.language_label
+          separator = index.zero? ? '' : (index == group.length - 1 ? ' and ' : ', ')
+        %><%= separator %><a href="<%= escape_html("https://github.com/vpsfreecz/haveapi/tree/master/#{path}") %>"><%= escape_html(label) %></a><% end %><% if variants %>)<% end %><% profiles.each do |profile| %>: <code><%= escape_html(profile.package_name) %></code><% unless profile.package_version.nil? %> <%= escape_html(profile.package_version) %><% end %><% end %>
+      </li>
+    <% end %>
+  </ul>
+  <% request_formats = clients.select { |client| %w[curl http].include?(client.language) } %>
+  <% unless request_formats.empty? %>
+    <p><% request_formats.each_with_index do |client, index| %><%= index.zero? ? '' : ' and ' %><a href="<%= escape_html(documentation_url(page: 'resources')) %>"><%= escape_html(client.label) %></a><% end %> request examples are available on resource pages.</p>
+  <% end %>
+</section>

data/lib/haveapi/views/version_page/example_panels.erb

@@ -0,0 +1,18 @@
+<% legacy_baseid ||= nil %>
+<% variants = documentation_example_variants(kind, **changes) %>
+<% details_by_client = variants.group_by { |client, _detail, _result| client.id }.transform_values { |items| items.map { |_client, detail, _result| detail.to_s } } %>
+<% if legacy_baseid %><%= documentation_reference_alias("#{legacy_baseid}-examples") %><% end %>
+<div class="docs-example" data-example data-example-details="<%= escape_html(JSON.generate(details_by_client)) %>" id="<%= escape_html("#{baseid}-examples") %>">
+  <% variants.each do |client, detail, result| %>
+    <% suffix = detail == :thorough ? '-thorough' : '' %>
+    <% if legacy_baseid %><%= documentation_reference_alias("#{legacy_baseid}-#{client.id}#{suffix}") %><% end %>
+    <% if detail == :simple && details_by_client[client.id] == ['simple'] %>
+      <%= documentation_reference_alias("#{legacy_baseid || baseid}-#{client.id}-thorough") %>
+      <% if legacy_baseid %><%= documentation_reference_alias("#{baseid}-#{client.id}-thorough") %><% end %>
+    <% end %>
+    <details data-example-panel data-client="<%= escape_html(client.id) %>" data-language="<%= escape_html(client.language) %>" data-variant="<%= escape_html(client.variant) %>" data-detail="<%= detail %>" id="<%= escape_html("#{baseid}-#{client.id}#{suffix}") %>"<% if detail == :simple %> open<% end %>>
+      <summary><%= escape_html(client.label) %> · <%= detail == :simple ? 'Simple' : 'With error handling' %></summary>
+      <%= erb :'version_page/client_result', locals: {client: client, result: result} %>
+    </details>
+  <% end %>
+</div>

data/lib/haveapi/views/version_page/resource_body.erb

@@ -1,156 +1,115 @@
 <% name ||= resource.humanize %>
+<% authentication_resource ||= false %>
+<% authentication_provider ||= nil %>
 <% resource_path = path.clone << resource %>
 <% resource_info = info %>
-<h2 class="resource" id="<%= "#{prefix}-#{resource}" %>"><%= resource.humanize %></h2>
-<hr>
+<% resource_target = documentation_resource_target(resource_path: resource_path, authentication: authentication_provider) %>
+<% heading = authentication_resource ? 'h3' : 'h1' %>
+<% action_heading = authentication_resource ? 'h4' : 'h2' %>
+<% parameter_heading = authentication_resource ? 'h5' : 'h3' %>
+<% if authentication_resource %><%= documentation_reference_alias("#{prefix}-#{resource}") %><% end %>
+<<%= heading %> class="resource" id="<%= escape_html(resource_target) %>"><%= escape_html(name) %><%= documentation_permalink(resource_target, name) %></<%= heading %>>
 <div class="resource-body">
   <p><%= info[:description] %></p>
-
   <div class="actions">
     <% sort_hash(info[:actions]).each do |action, info| %>
-      <h3 id="<%= "#{prefix}-#{resource}-#{action}" %>"><%= name %> # <%= action.capitalize %></h3>
-      <div class="action">
-        <dl>
-          <dt>Path:</dt>
-          <dd><%= info[:method] %> <%= info[:path] %></dd>
-          <dt>Description:</dt>
-          <dd><%= info[:description] %></dd>
-          <dt>Authentication required:</dt>
-          <dd><%= info[:auth] ? 'yes' : 'no' %></dd>
-          <dt>Scope:</dt>
-          <dd><%= info[:scope] %></dd>
-          <dt>Aliases:</dt>
-          <dd><%= info[:aliases].join(', ') %></dd>
-          <dt>Blocking:</dt>
-          <dd><%= info[:blocking] ? 'yes' : 'no' %></dd>
-        </dl>
-
-        <h4>Input parameters</h4>
-        <div class="parameters">
+      <% action_target = documentation_resource_target(resource_path: resource_path, action_name: action, authentication: authentication_provider) %>
+      <% sections = documentation_action_sections(info, resource_path: resource_path, action_name: action, authentication: authentication_provider) %>
+      <% if authentication_resource %><%= documentation_reference_alias("#{prefix}-#{resource}-#{action}") %><% end %>
+      <section data-doc-section id="<%= escape_html(action_target) %>">
+        <<%= action_heading %>><%= escape_html(action.capitalize) %><%= documentation_permalink(action_target, action.to_s.capitalize) %></<%= action_heading %>>
+        <div class="action">
+          <dl class="docs-metadata">
+            <dt>Path</dt><dd><%= info[:method] %> <%= info[:path] %></dd>
+            <dt>Description</dt><dd><%= info[:description] %></dd>
+            <dt>Authentication required</dt><dd><%= info[:auth] ? 'yes' : 'no' %></dd>
+            <dt>Scope</dt><dd><%= info[:scope] %></dd>
+            <dt>Aliases</dt><dd><%= info[:aliases].join(', ') %></dd>
+            <dt>Blocking</dt><dd><%= info[:blocking] ? 'yes' : 'no' %></dd>
+          </dl>
+          <<%= parameter_heading %> id="<%= escape_html(sections[0][:id]) %>">Input parameters<%= documentation_permalink(sections[0][:id], 'Input parameters') %></<%= parameter_heading %>>
           <% if info[:input][:parameters].empty? %>
             <p>No parameters.</p>
           <% else %>
-            <dl>
-              <dt>Layout:</dt>
-              <dd><%= info[:input][:layout] %></dd>
-              <dt>Namespace:</dt>
-              <dd><%= info[:input][:namespace] %></dd>
+            <dl class="docs-metadata">
+              <dt>Layout</dt><dd><%= info[:input][:layout] %></dd>
+              <dt>Namespace</dt><dd><%= info[:input][:namespace] %></dd>
             </dl>
-
-            <table class="table table-striped table-hover table-bordered">
-              <tr>
-                <th>Label</th>
-                <th>Name</th>
-                <th>Required</th>
-                <th>Type</th>
-                <th>Validators</th>
-                <th>Default</th>
-                <th>Description</th>
-              </tr>
-              <% info[:input][:parameters].each do |param, info| %>
-                <tr>
-                  <td><%= info[:label] %></td>
-                  <td><%= param %></td>
-                  <td><%= info[:required] ? 'yes' : 'no' %></td>
-                  <td><%= format_param_type(info) %></td>
-                  <td><%= format_validators(info[:validators]) %></td>
-                  <td><%= info[:default] == :_nil ? '' : escape_html(info[:default]) %></td>
-                  <td><%= escape_html(info[:description]) %></td>
-                </tr>
-              <% end %>
-            </table>
+            <div class="docs-table-scroll" tabindex="0" role="region" aria-label="Input parameters">
+              <table class="docs-input-parameters">
+                <thead><tr><th>Parameter</th><th>Type</th><th>Required</th><th>Details</th></tr></thead>
+                <tbody>
+                  <% info[:input][:parameters].each do |param, parameter| %>
+                    <tr id="<%= escape_html(documentation_parameter_anchor(resource_path: resource_path, action_name: action, direction: :input, parameter_name: param, authentication: authentication_provider)) %>">
+                      <td class="docs-param-name"><code><%= escape_html(param) %></code><% if parameter[:label].to_s != param.to_s %><div><%= parameter[:label] %></div><% end %></td>
+                      <td><%= format_param_type(parameter) %></td>
+                      <td><%= parameter[:required] ? 'yes' : 'no' %></td>
+                      <td class="docs-param-details">
+                        <% if parameter[:description] %><p><%= escape_html(parameter[:description]) %></p><% end %>
+                        <% if parameter.has_key?(:default) && parameter[:default] != :_nil %>
+                          <p><strong>Default:</strong> <code><%= escape_html(parameter[:default].nil? ? 'null' : parameter[:default] == '' ? '""' : parameter[:default]) %></code></p>
+                        <% end %>
+                        <%= format_validators(parameter[:validators], type: parameter[:type]) %>
+                      </td>
+                    </tr>
+                  <% end %>
+                </tbody>
+              </table>
+            </div>
           <% end %>
-        </div>
-
-        <h4>Output parameters</h4>
-        <div class="parameters">
+          <<%= parameter_heading %> id="<%= escape_html(sections[1][:id]) %>">Output parameters<%= documentation_permalink(sections[1][:id], 'Output parameters') %></<%= parameter_heading %>>
           <% if info[:output][:parameters].empty? && info[:output][:format].nil? %>
             <p>No parameters.</p>
           <% else %>
-            <dl>
-              <dt>Layout:</dt>
-              <dd><%= info[:output][:layout] %></dd>
-              <dt>Namespace:</dt>
-              <dd><%= info[:output][:namespace] %></dd>
+            <dl class="docs-metadata">
+              <dt>Layout</dt><dd><%= info[:output][:layout] %></dd>
+              <dt>Namespace</dt><dd><%= info[:output][:namespace] %></dd>
             </dl>
-
-            <table class="table table-striped table-hover table-bordered">
-              <tr>
-                <th>Label</th>
-                <th>Name</th>
-                <th>Type</th>
-                <th>Description</th>
-              </tr>
-              <% info[:output][:parameters].each do |param, info| %>
-                <tr>
-                  <td><%= info[:label] %></td>
-                  <td><%= param %></td>
-                  <td><%= format_param_type(info) %></td>
-                  <td><%= escape_html(info[:description]) %></td>
-                </tr>
-              <% end %>
-            </table>
+            <div class="docs-table-scroll" tabindex="0" role="region" aria-label="Output parameters">
+              <table class="docs-output-parameters">
+                <thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead>
+                <tbody>
+                  <% info[:output][:parameters].each do |param, parameter| %>
+                    <tr id="<%= escape_html(documentation_parameter_anchor(resource_path: resource_path, action_name: action, direction: :output, parameter_name: param, authentication: authentication_provider)) %>">
+                      <td class="docs-param-name"><code><%= escape_html(param) %></code><% if parameter[:label].to_s != param.to_s %><div><%= parameter[:label] %></div><% end %></td>
+                      <td><%= format_param_type(parameter) %></td>
+                      <td class="docs-param-details"><%= escape_html(parameter[:description]) %></td>
+                    </tr>
+                  <% end %>
+                </tbody>
+              </table>
+            </div>
           <% end %>
-        </div>
-
-        <% unless info[:examples].empty? %>
-          <h4>Examples</h4>
-          <% info[:examples].each_with_index do |example, i| %>
-              <h5><%= example[:title].empty? ? "Example ##{i}" : example[:title] %></h5>
+          <% unless info[:examples].empty? %>
+            <<%= parameter_heading %> id="<%= escape_html(sections[2][:id]) %>">Examples<%= documentation_permalink(sections[2][:id], 'Examples') %></<%= parameter_heading %>>
+            <p>Examples use an initialized <code>api</code> client, authenticated when required. See <a href="<%= escape_html(documentation_url(anchor: 'initialization')) %>">initialization</a> and <a href="<%= escape_html(documentation_url(page: 'authentication')) %>">authentication</a>.</p>
+            <% info[:examples].each_with_index do |example, index| %>
+              <% example_title = example[:title].empty? ? "Example ##{index}" : example[:title] %>
+              <% example_target = documentation_reference_anchor(resource_path: resource_path, action_name: action, authentication: authentication_provider, section: :example_title, example_index: index) %>
+              <h4 id="<%= escape_html(example_target) %>"><%= escape_html(example_title) %><%= documentation_permalink(example_target, example_title) %></h4>
               <p><%= example[:comment] %></p>
-
-              <% baseid = "example-#{resource_path.join('.')}-#{action}-#{i}" %>
-              <%# placeholder for tabs %>
-              <div id="<%= "#{baseid}-tabbar" %>"></div>
-
-              <div id="<%= "#{baseid}-examples" %>">
-                <% documentation_panels(:example, resource_path: resource_path, resource: resource_info, action_name: action, action: info, sample: example).each do |client, result| %>
-                  <div id="<%= escape_html("#{baseid}-#{client.id}") %>">
-                    <%=
-                      erb :"version_page/client_example", locals: {
-                        client: client,
-                        result: result,
-                      }
-                    %>
-                  </div>
-                <% end %>
-              </div>
-
-              <script type="text/javascript">
-              nojsTabs({
-                tabs: document.getElementById('<%= "#{baseid}-examples" %>'),
-                titleSelector: 'h6',
-                tabBar: document.getElementById('<%= "#{baseid}-tabbar" %>'),
-                hiddenClass: 'tab-hidden',
-                activeClass: 'active',
-                createElement: function (el) {
-                  if (el.tagName == 'UL')
-                    el.classList.add('nav', 'nav-tabs');
-
-                  else if (el.tagName == 'LI')
-                    el.setAttribute('role', 'presentation');
-                }
-              });
-              </script>
+              <% old_baseid = "example-#{resource_path.join('.')}-#{action}-#{index}" %>
+              <% panel_baseid = authentication_resource ? documentation_reference_anchor(resource_path: resource_path, action_name: action, authentication: authentication_provider, section: :example, example_index: index) : old_baseid %>
+              <%= erb :'version_page/example_panels', locals: {baseid: panel_baseid, legacy_baseid: authentication_resource ? old_baseid : nil, kind: :example, changes: {resource_path: resource_path, resource: resource_info, action_name: action, action: info, sample: example}} %>
+            <% end %>
           <% end %>
-        <% end %>
-
-      </div>
+        </div>
+      </section>
     <% end %>
   </div>
-
   <% unless info[:resources].empty? %>
-    <% sort_hash(info[:resources]).each do |r, i| %>
-      <%=
-        erb :"version_page/resource_body", locals: {
-          resource: r,
-          info: i,
-          path: resource_path,
-          prefix: "#{prefix}-#{resource}",
-          name: "#{name}.#{r.humanize}",
-        }
-      %>
+    <% children_target = documentation_reference_anchor(resource_path: resource_path, authentication: authentication_provider, section: :children) %>
+    <h2 id="<%= escape_html(children_target) %>">Subresources<%= documentation_permalink(children_target, 'Subresources') %></h2>
+    <% if authentication_resource %>
+      <% sort_hash(info[:resources]).each do |child, child_info| %>
+        <%= erb :'version_page/resource_body', locals: {resource: child, info: child_info, path: resource_path, prefix: "#{prefix}-#{resource}", name: "#{name} / #{child.humanize}", authentication_resource: true, authentication_provider: authentication_provider} %>
+      <% end %>
+    <% else %>
+      <ul>
+        <% sort_hash(info[:resources]).each do |child, child_info| %>
+          <li><a href="<%= escape_html(documentation_url(resource: resource_path + [child.to_s])) %>"><%= escape_html((resource_path + [child.to_s]).join('.')) %></a></li>
+        <% end %>
+      </ul>
     <% end %>
   <% end %>
-
-</div> <!-- resource -->
+</div>

data/lib/haveapi/views/version_page/resource_directory.erb

@@ -0,0 +1,14 @@
+<section id="resources">
+  <h1>Resources<%= documentation_permalink('resources', 'Resources') %></h1>
+  <% if documentation_search_query.empty? %>
+  <nav aria-label="Resources" data-resource-nav>
+  <ul class="docs-resource-list docs-resource-directory">
+    <% sort_hash(@help[:resources]).each do |resource, info| %>
+      <%= erb :'version_sidebar/resource_nav', locals: {resource: resource, info: info, path: []} %>
+    <% end %>
+  </ul>
+  </nav>
+  <% else %>
+    <%= erb :'documentation/search_results', locals: {search: documentation_search_results} %>
+  <% end %>
+</section>

data/lib/haveapi/views/version_page/usage.erb

@@ -0,0 +1,7 @@
+<section aria-labelledby="reference-usage">
+  <h2 id="reference-usage">Using this reference<%= documentation_permalink('reference-usage', 'Using this reference') %></h2>
+  <p>Choose a <strong>Language</strong> and <strong>Client</strong> variant for the examples. <strong>Examples</strong> offers the selected client's supported formats. Your choices apply to every example and stay selected as you browse.</p>
+  <p>Start with <a href="#initialization">Initialization</a> below and <a href="<%= escape_html(documentation_url(page: 'authentication')) %>">Authentication</a> for credentials. Open <a href="<%= escape_html(documentation_url(page: 'resources')) %>">Resources</a> to browse the API, then choose a resource to see its actions, parameters and examples.</p>
+  <p>Search finds resources, actions and input or output parameters. Follow a result to its reference entry.</p>
+  <p>While signed out, the reference shows all declared resources, actions and parameters.<% if documentation_account_context&.dig(:controls) %> Sign in to show only those available to your account.<% end %> Each API request still checks permissions for the requested operation.</p>
+</section>

data/lib/haveapi/views/version_page.erb

@@ -1,119 +1,38 @@
-<h1 id="api">API v<%= @v %></h1>
-
-<ol class="breadcrumb">
-  <li><a href="<%= escape_html(root) %>"><%= escape_html(host) %></a></li>
-  <li class="active">v<%= @v %></li>
-</ol>
-
-<p>
-  This page contains a list of resources available in API v<%= @v %>, their actions,
-  description, parameters and example usage.
-</p>
-
-<p>
-  This API is based on the <a href="https://github.com/vpsfreecz/haveapi">HaveAPI</a> framework.
-  You can access it using existing clients:
-</p>
-
-<ul>
-  <li><a href="https://github.com/vpsfreecz/haveapi/tree/master/clients/ruby" target="_blank" rel="noopener">Ruby library and CLI</a></li>
-  <li><a href="https://github.com/vpsfreecz/haveapi/tree/master/clients/js" target="_blank" rel="noopener">JavaScript and TypeScript (callback and async)</a></li>
-  <li><a href="https://github.com/vpsfreecz/haveapi/tree/master/clients/python" target="_blank" rel="noopener">Python (sync and async)</a></li>
-  <% settings.api_server.documentation_client_profiles(@v).each do |language, profile| %>
-    <li><a href="https://github.com/vpsfreecz/haveapi/tree/master/clients/<%= escape_html(language) %>" target="_blank" rel="noopener"><%= { go: 'Go', rust: 'Rust (async and blocking)', typescript: 'TypeScript (generated)' }.fetch(language) %></a>: <code><%= escape_html(profile.package_name) %></code><% if profile.package_version %> <%= escape_html(profile.package_version) %><% end %></li>
+<% if @documentation_page == 'overview' %>
+  <h1 id="api">API v<%= escape_html(@v) %><%= documentation_permalink('api', "API v#{@v}") %></h1>
+  <%= erb :'version_page/usage' %>
+  <p>Connect to <code><%= escape_html("#{base_url}#{root}") %></code> with a <a href="https://github.com/vpsfreecz/haveapi">HaveAPI client</a>.</p>
+  <%= erb :'version_page/client_overview' %>
+  <p>Examples target API v<%= escape_html(@v) %>. API clients use their own package versions and must match this API.</p>
+  <section id="initialization" data-doc-section>
+    <h2>Initialization<%= documentation_permalink('initialization', 'Initialization') %></h2>
+    <p>Initialize your client, then follow the <a href="<%= escape_html(documentation_url(page: 'authentication')) %>">authentication instructions</a> when credentials are required.</p>
+    <%= erb :'version_page/example_panels', locals: {baseid: 'init', kind: :init, changes: {}} %>
+  </section>
+  <p><a href="<%= escape_html(documentation_url(page: 'resources')) %>" data-resource-directory-link>Browse all resources</a> to find their actions, parameters and examples.</p>
+<% elsif @documentation_page == 'resources' %>
+  <%= erb :'version_page/resource_directory' %>
+<% elsif @documentation_page == 'authentication' %>
+  <nav aria-label="Breadcrumb"><ol><li><a href="<%= escape_html(documentation_url) %>">Overview</a></li><li aria-current="page">Authentication</li></ol></nav>
+  <h1 id="auth">Authentication<%= documentation_permalink('auth', 'Authentication') %></h1>
+  <p>Initialize your client using the <a href="<%= escape_html(documentation_url(anchor: 'initialization')) %>">overview examples</a>, then choose an authentication method.</p>
+  <% if @help[:authentication].empty? %><p>Authentication is disabled for this API.</p><% end %>
+  <% @help[:authentication].each do |name, info| %>
+    <%= erb :'version_page/auth_body', locals: {name: name, info: info} %>
   <% end %>
-  <li><a href="https://github.com/vpsfreecz/haveapi/tree/master/clients/php" target="_blank" rel="noopener">PHP</a></li>
-  <li>
-    <a href="https://github.com/vpsfreecz/haveapi-webui" target="_blank">Generic web interface</a>
-    (<a href="https://webui.haveapi.org/v<%= version %>/#<%= urlescape(base_url) %>" target="_blank">connect to this API</a>)
-  </li>
-</ul>
-
-<p>
-  These examples target API v<%= escape_html(@v) %>. The framework and dynamic
-  clients share HaveAPI package versions. Generated Go, Rust and TypeScript SDKs use their
-  own package versions. Their configured SDKs are expected to match this API.
-</p>
-
-<h2>Initialization</h2>
-
-<div id="init-tabbar"></div>
-
-<div id="init-examples">
-  <% documentation_panels(:init).each do |client, result| %>
-    <div id="<%= escape_html("init-#{client.id}") %>">
-      <%= erb :"version_page/client_init", locals: {client: client, result: result} %>
-    </div>
-  <% end %>
-</div>
-
-<script type="text/javascript">
-nojsTabs({
-  tabs: document.getElementById('init-examples'),
-  titleSelector: 'h4',
-  tabBar: document.getElementById('init-tabbar'),
-  hiddenClass: 'tab-hidden',
-  activeClass: 'active',
-  createElement: function (el) {
-    if (el.tagName == 'UL')
-      el.classList.add('nav', 'nav-tabs');
-
-    else if (el.tagName == 'LI')
-      el.setAttribute('role', 'presentation');
-  }
-});
-</script>
-
-<h1 id="auth">Authentication methods</h1>
-<% @help[:authentication].each do |name, info| %>
-  <%= erb :"version_page/auth_body", locals: {name: name, info: info} %>
-<% end %>
-
-<h1 id="resources">Resources</h1>
-<p>Follows a list of all resources in this API and their actions.</p>
-
-<% sort_hash(@help[:resources]).each do |resource, info| %>
-  <%=
-    erb :"version_page/resource_body", locals: {
-      resource: resource,
-      info: info,
-      path: [],
-      prefix: 'root',
-      name: nil,
-    }
-  %>
+<% else %>
+  <% entry = @documentation_resource %>
+  <nav aria-label="Breadcrumb" data-resource-breadcrumbs>
+    <ol>
+      <li><a href="<%= escape_html(documentation_url(page: 'resources')) %>">Resources</a></li>
+      <% entry[:path].each_with_index do |part, index| %>
+        <% if index == entry[:path].length - 1 %>
+          <li aria-current="page"><%= escape_html(part.humanize) %></li>
+        <% else %>
+          <li><a href="<%= escape_html(documentation_url(resource: entry[:path][0..index])) %>"><%= escape_html(part.humanize) %></a></li>
+        <% end %>
+      <% end %>
+    </ol>
+  </nav>
+  <%= erb :'version_page/resource_body', locals: {resource: entry[:path].last, info: entry[:info], path: entry[:path][0...-1], prefix: "root#{entry[:path][0...-1].map { |part| "-#{part}" }.join}", name: entry[:key], authentication_resource: false} %>
 <% end %>
-</div>
-
-<script type="text/javascript">
-  $(document).ready(function(){
-    // Login/logout user
-    $('.authentication a.login').click(function(event){
-      $.ajax({
-        type: 'GET',
-        url: this.href,
-        async: false,
-        complete: function (){
-          window.location.reload();
-        }
-      });
-
-      event.preventDefault();
-    });
-
-    $('.authentication a.logout').click(function(event){
-      $.ajax({
-        type: 'GET',
-        url: this.href,
-        async: true,
-        username: '_log',
-        password: 'out',
-        complete: function() {
-          window.location.reload();
-        }
-      });
-
-      event.preventDefault();
-    });
-  });
-</script>

data/lib/haveapi/views/version_sidebar/auth_nav.erb

@@ -1,20 +1,16 @@
-<ul>
+<ul class="docs-authentication-submenu">
   <% methods.each do |method, info| %>
-    <li>
-      <a href="#auth-<%= method %>"><%= method.to_s.humanize %></a>
-      <% if info[:resources] %>
-        <ul>
-          <% sort_hash(info[:resources]).each do |resource, info| %>
-            <%=
-              erb :"version_sidebar/resource_nav", locals: {
-                resource: resource.to_s,
-                info: info,
-                prefix: "auth-#{method}",
-              }
-            %>
-          <% end %>
-        </ul>
-      <% end %>
+    <% target = "auth-#{method}" %>
+    <li data-doc-nav-owner="<%= escape_html(target) %>">
+      <a data-doc-primary href="#<%= escape_html(target) %>"><%= escape_html(method.to_s.humanize) %></a>
+      <ul data-doc-subnav="<%= escape_html(target) %>">
+        <% unless (info[:resources] || {}).empty? %>
+          <li><a data-doc-subsection href="#<%= escape_html(documentation_reference_anchor(authentication: method, section: :resources)) %>">Resources</a>
+            <%= erb :'version_sidebar/auth_resource_nav', locals: {resources: info[:resources], path: [], authentication_provider: method} %>
+          </li>
+        <% end %>
+        <li><a data-doc-subsection href="#<%= escape_html(documentation_reference_anchor(authentication: method, section: :examples)) %>">Examples</a></li>
+      </ul>
     </li>
   <% end %>
 </ul>