haveapi 0.32.1 → 0.32.2

data/lib/haveapi/views/main_layout.erb

@@ -1,12 +1,12 @@
 <!DOCTYPE html>
-<html>
+<html lang="<%= escape_html(documentation_locale) %>">
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
   <title><%= escape_html(documentation_document_title) %></title>
   <% if @documentation_ui %>
-  <script src="<%= escape_html(url('/js/documentation.js', false)) %>" data-highlighter-url="<%= escape_html(url('/js/highlighter.js', false)) %>"></script>
-  <link rel="stylesheet" href="<%= escape_html(url('/css/documentation.css', false)) %>">
+  <script src="<%= escape_html("#{url('/js/documentation.js', false)}?v=#{HaveAPI::DocumentationHelpers::ASSET_DIGESTS.fetch('js/documentation.js')}") %>" data-highlighter-url="<%= escape_html(url('/js/highlighter.js', false)) %>"></script>
+  <link rel="stylesheet" href="<%= escape_html("#{url('/css/documentation.css', false)}?v=#{HaveAPI::DocumentationHelpers::ASSET_DIGESTS.fetch('css/documentation.css')}") %>">
   <% else %>
 
   <link rel="stylesheet" href="/css/bootstrap.min.css">
@@ -86,7 +86,7 @@
 
   <footer class="docs-footer">
     <div>
-      <p class="text-right">Generated by <a href="https://github.com/vpsfreecz/haveapi">HaveAPI</a> v<%= version %></p>
+      <p class="text-right"><%= escape_html(documentation_t('footer.generated')) %> <a href="https://github.com/vpsfreecz/haveapi">HaveAPI</a> v<%= version %></p>
     </div>
   </footer>
 </div>

data/lib/haveapi/views/shared_documentation.erb

@@ -1,12 +1,15 @@
 <% if @documentation_page == 'guide' %>
-  <nav aria-label="Breadcrumb">
+  <nav class="docs-breadcrumb" aria-label="<%= escape_html(documentation_t('accessibility.breadcrumb')) %>">
     <ol>
-      <li><a href="<%= escape_html(shared_documentation_url) %>">API versions</a></li>
-      <% unless title == 'HaveAPI internals' %>
-        <li><a href="<%= escape_html(shared_documentation_url('doc')) %>">HaveAPI internals</a></li>
+      <li><a href="<%= escape_html(shared_documentation_url) %>"><%= escape_html(documentation_t('labels.api_versions')) %></a></li>
+      <% unless @documentation_article_id == 'readme' %>
+        <li><a href="<%= escape_html(shared_documentation_url('doc')) %>"><%= escape_html(documentation_t('articles.readme')) %></a></li>
       <% end %>
       <li aria-current="page"><%= escape_html(title) %></li>
     </ol>
   </nav>
 <% end %>
-<%= content %>
+<% if @documentation_article_locale && @documentation_article_locale != documentation_locale %>
+  <p class="docs-article-fallback"><%= escape_html(documentation_t('article.fallback')) %></p>
+<% end %>
+<div lang="<%= escape_html(@documentation_article_locale || documentation_locale) %>"><%= content %></div>

data/lib/haveapi/views/shared_sidebar.erb

@@ -2,24 +2,24 @@
 <% if (search_options = documentation_search_form_options(id: 'docs-search-sidebar')) %>
   <%= erb :'documentation/search_form', locals: search_options %>
 <% end %>
-<nav aria-label="Documentation pages">
+<nav aria-label="<%= escape_html(documentation_t('accessibility.pages')) %>">
   <ul>
-    <li><a href="<%= escape_html(shared_documentation_url) %>"<% if @documentation_page == 'versions' %> aria-current="page"<% end %>>API versions</a></li>
+    <li><a href="<%= escape_html(shared_documentation_url) %>"<% if @documentation_page == 'versions' %> aria-current="page"<% end %>><%= escape_html(documentation_t('labels.api_versions')) %></a></li>
     <% if (reference = shared_documentation_reference_url) %>
-      <li><a href="<%= escape_html(reference) %>">API reference</a></li>
-      <li><a href="<%= escape_html(shared_documentation_reference_url(page: 'resources')) %>">Resources</a></li>
+      <li><a href="<%= escape_html(reference) %>"><%= escape_html(documentation_t('labels.api_reference')) %></a></li>
+      <li><a href="<%= escape_html(shared_documentation_reference_url(page: 'resources')) %>"><%= escape_html(documentation_t('labels.resources')) %></a></li>
     <% end %>
   </ul>
 </nav>
 <% if @documentation_toc && !@documentation_toc.empty? %>
-  <nav aria-label="Contents" data-action-nav><%= @documentation_toc %></nav>
+  <nav aria-label="<%= escape_html(documentation_t('labels.contents')) %>" data-action-nav><%= @documentation_toc %></nav>
 <% end %>
-<nav aria-label="Shared documentation">
-  <h2><a href="<%= escape_html(shared_documentation_url('doc')) %>">HaveAPI internals</a></h2>
+<nav aria-label="<%= escape_html(documentation_t('accessibility.shared')) %>">
+  <h2><a href="<%= escape_html(shared_documentation_url('doc')) %>"><%= escape_html(documentation_t('articles.readme')) %></a></h2>
   <ul>
-    <li><a href="<%= escape_html(shared_documentation_url('doc/protocol')) %>">Protocol</a></li>
-    <li><a href="<%= escape_html(shared_documentation_url('doc/json-schema')) %>">JSON schema</a></li>
-    <li><a href="<%= escape_html(shared_documentation_url('doc/create-client')) %>">Create a client</a></li>
-    <li><a href="<%= escape_html(shared_documentation_url('doc/client-examples')) %>">Client examples</a></li>
+    <li><a href="<%= escape_html(shared_documentation_url('doc/protocol')) %>"><%= escape_html(documentation_t('articles.protocol')) %></a></li>
+    <li><a href="<%= escape_html(shared_documentation_url('doc/json-schema')) %>"><%= escape_html(documentation_t('articles.json_schema')) %></a></li>
+    <li><a href="<%= escape_html(shared_documentation_url('doc/create-client')) %>"><%= escape_html(documentation_t('articles.create_client')) %></a></li>
+    <li><a href="<%= escape_html(shared_documentation_url('doc/client-examples')) %>"><%= escape_html(documentation_t('articles.client_examples')) %></a></li>
   </ul>
 </nav>

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

@@ -6,31 +6,31 @@
 
 <% if name == :token %>
   <dl class="docs-metadata">
-    <dt>HTTP header:</dt>
+    <dt><%= escape_html(documentation_t('labels.http_header')) %></dt>
     <dd><%= info[:http_header] %></dd>
-    <dt>Query parameter:</dt>
+    <dt><%= escape_html(documentation_t('labels.query_parameter')) %></dt>
     <dd><%= info[:query_parameter] %></dd>
   </dl>
 <% elsif name == :oauth2 %>
   <dl class="docs-metadata">
-    <dt>Authorize URL:</dt>
+    <dt><%= escape_html(documentation_t('labels.authorize_url')) %></dt>
     <dd><%= info[:authorize_url] %></dd>
-    <dt>Token URL:</dt>
+    <dt><%= escape_html(documentation_t('labels.token_url')) %></dt>
     <dd><%= info[:token_url] %></dd>
-    <dt>Revoke URL:</dt>
+    <dt><%= escape_html(documentation_t('labels.revoke_url')) %></dt>
     <dd><%= info[:revoke_url] %></dd>
   </dl>
 <% end %>
 
 <% 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>
+  <h2 id="<%= escape_html(resources_target) %>"><%= escape_html(documentation_t('labels.resources')) %><%= documentation_permalink(resources_target, documentation_t('labels.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, authentication_resource: true, authentication_provider: name} %>
   <% end %>
 <% end %>
 
 <% examples_target = documentation_reference_anchor(authentication: name, section: :examples) %>
-<h3 id="<%= escape_html(examples_target) %>">Examples<%= documentation_permalink(examples_target, 'Examples') %></h3>
+<h3 id="<%= escape_html(examples_target) %>"><%= escape_html(documentation_t('labels.examples')) %><%= documentation_permalink(examples_target, documentation_t('labels.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_auth.erb

@@ -1,2 +1,2 @@
-<h4><%= escape_html(client.label) %></h4>
+<h4><%= escape_html(documentation_client_label(client)) %></h4>
 <%= erb :"version_page/client_result", locals: {client: client, result: result} %>

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

@@ -1,2 +1,2 @@
-<h6><%= escape_html(client.label) %></h6>
+<h6><%= escape_html(documentation_client_label(client)) %></h6>
 <%= erb :"version_page/client_result", locals: {client: client, result: result} %>

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

@@ -1,2 +1,2 @@
-<h4><%= escape_html(client.label) %></h4>
+<h4><%= escape_html(documentation_client_label(client)) %></h4>
 <%= erb :"version_page/client_result", locals: {client: client, result: result} %>

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

@@ -19,7 +19,7 @@
 <% 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>
+  <h2><%= escape_html(documentation_t('labels.client_libraries')) %><%= documentation_permalink('client-libraries', documentation_t('labels.client_libraries')) %></h2>
   <ul>
     <% groups.each_value do |group| %>
       <% variants = group.length > 1 || group.first.variant %>
@@ -27,14 +27,16 @@
       <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 %>
+          variant = documentation_client_variant(client)
+          overview_variant = variant == client.variant ? variant&.downcase&.sub(/\Aapi\b/, 'API') : variant&.sub(/\A./) { |letter| letter.downcase }
+          label = variants ? (overview_variant || (client.language == 'ruby' ? documentation_t('client.library') : client.language_label)) : client.language_label
+          separator = index.zero? ? '' : (index == group.length - 1 ? documentation_t('client.and') : ', ')
+        %><%= escape_html(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>
+    <p><% request_formats.each_with_index do |client, index| %><%= escape_html(index.zero? ? '' : documentation_t('client.and')) %><a href="<%= escape_html(documentation_url(page: 'resources')) %>"><%= escape_html(client.label) %></a><% end %> <%= escape_html(documentation_t('client.request_examples')) %></p>
   <% end %>
 </section>

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

@@ -1,6 +1,8 @@
 <% 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 } } %>
+<% selection = documentation_example_selection %>
+<% selected_details = selection[:client] && details_by_client[selection[:client].id] %>
 <% 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| %>
@@ -10,9 +12,10 @@
       <%= 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>
+    <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 selection[:client] == client && detail.to_s == documentation_example_detail(details_by_client[client.id]) %> open<% end %>>
+      <summary><%= escape_html(documentation_client_label(client)) %> · <%= escape_html(documentation_t(detail == :simple ? 'labels.simple' : 'labels.thorough')) %></summary>
       <%= erb :'version_page/client_result', locals: {client: client, result: result} %>
     </details>
   <% end %>
+  <% unless selected_details %><p class="docs-notice" data-example-unavailable><%= escape_html(documentation_t('browser.example_unavailable')) %></p><% end %>
 </div>

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

@@ -20,34 +20,34 @@
         <<%= 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>
+            <dt><%= escape_html(documentation_t('labels.path')) %></dt><dd><%= info[:method] %> <%= info[:path] %></dd>
+            <dt><%= escape_html(documentation_t('labels.description')) %></dt><dd><%= info[:description] %></dd>
+            <dt><%= escape_html(documentation_t('labels.authentication_required')) %></dt><dd><%= escape_html(info[:auth] ? documentation_t('labels.yes') : documentation_t('labels.no')) %></dd>
+            <dt><%= escape_html(documentation_t('labels.scope')) %></dt><dd><%= info[:scope] %></dd>
+            <dt><%= escape_html(documentation_t('labels.aliases')) %></dt><dd><%= info[:aliases].join(', ') %></dd>
+            <dt><%= escape_html(documentation_t('labels.blocking')) %></dt><dd><%= escape_html(info[:blocking] ? documentation_t('labels.yes') : documentation_t('labels.no')) %></dd>
           </dl>
-          <<%= parameter_heading %> id="<%= escape_html(sections[0][:id]) %>">Input parameters<%= documentation_permalink(sections[0][:id], 'Input parameters') %></<%= parameter_heading %>>
+          <<%= parameter_heading %> id="<%= escape_html(sections[0][:id]) %>"><%= escape_html(documentation_t('labels.input_parameters')) %><%= documentation_permalink(sections[0][:id], documentation_t('labels.input_parameters')) %></<%= parameter_heading %>>
           <% if info[:input][:parameters].empty? %>
-            <p>No parameters.</p>
+            <p><%= escape_html(documentation_t('labels.no_parameters')) %></p>
           <% else %>
             <dl class="docs-metadata">
-              <dt>Layout</dt><dd><%= info[:input][:layout] %></dd>
-              <dt>Namespace</dt><dd><%= info[:input][:namespace] %></dd>
+              <dt><%= escape_html(documentation_t('labels.layout')) %></dt><dd><%= info[:input][:layout] %></dd>
+              <dt><%= escape_html(documentation_t('labels.namespace')) %></dt><dd><%= info[:input][:namespace] %></dd>
             </dl>
-            <div class="docs-table-scroll" tabindex="0" role="region" aria-label="Input parameters">
+            <div class="docs-table-scroll" tabindex="0" role="region" aria-label="<%= escape_html(documentation_t('labels.input_parameters')) %>">
               <table class="docs-input-parameters">
-                <thead><tr><th>Parameter</th><th>Type</th><th>Required</th><th>Details</th></tr></thead>
+                <thead><tr><th><%= escape_html(documentation_t('labels.parameter')) %></th><th><%= escape_html(documentation_t('labels.type')) %></th><th><%= escape_html(documentation_t('labels.required')) %></th><th><%= escape_html(documentation_t('labels.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><%= escape_html(parameter[:required] ? documentation_t('labels.yes') : documentation_t('labels.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>
+                          <p><strong><%= escape_html(documentation_t('labels.default')) %></strong> <code><%= escape_html(parameter[:default].nil? ? 'null' : parameter[:default] == '' ? '""' : parameter[:default]) %></code></p>
                         <% end %>
                         <%= format_validators(parameter[:validators], type: parameter[:type]) %>
                       </td>
@@ -57,17 +57,17 @@
               </table>
             </div>
           <% end %>
-          <<%= parameter_heading %> id="<%= escape_html(sections[1][:id]) %>">Output parameters<%= documentation_permalink(sections[1][:id], 'Output parameters') %></<%= parameter_heading %>>
+          <<%= parameter_heading %> id="<%= escape_html(sections[1][:id]) %>"><%= escape_html(documentation_t('labels.output_parameters')) %><%= documentation_permalink(sections[1][:id], documentation_t('labels.output_parameters')) %></<%= parameter_heading %>>
           <% if info[:output][:parameters].empty? && info[:output][:format].nil? %>
-            <p>No parameters.</p>
+            <p><%= escape_html(documentation_t('labels.no_parameters')) %></p>
           <% else %>
             <dl class="docs-metadata">
-              <dt>Layout</dt><dd><%= info[:output][:layout] %></dd>
-              <dt>Namespace</dt><dd><%= info[:output][:namespace] %></dd>
+              <dt><%= escape_html(documentation_t('labels.layout')) %></dt><dd><%= info[:output][:layout] %></dd>
+              <dt><%= escape_html(documentation_t('labels.namespace')) %></dt><dd><%= info[:output][:namespace] %></dd>
             </dl>
-            <div class="docs-table-scroll" tabindex="0" role="region" aria-label="Output parameters">
+            <div class="docs-table-scroll" tabindex="0" role="region" aria-label="<%= escape_html(documentation_t('labels.output_parameters')) %>">
               <table class="docs-output-parameters">
-                <thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead>
+                <thead><tr><th><%= escape_html(documentation_t('labels.parameter')) %></th><th><%= escape_html(documentation_t('labels.type')) %></th><th><%= escape_html(documentation_t('labels.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)) %>">
@@ -81,10 +81,10 @@
             </div>
           <% end %>
           <% 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>
+            <<%= parameter_heading %> id="<%= escape_html(sections[2][:id]) %>"><%= escape_html(documentation_t('labels.examples')) %><%= documentation_permalink(sections[2][:id], documentation_t('labels.examples')) %></<%= parameter_heading %>>
+            <p><%= escape_html(documentation_t('example.initialized')) %> <%= escape_html(documentation_t('example.see')) %> <a href="<%= escape_html(documentation_url(anchor: 'initialization')) %>"><%= escape_html(documentation_t('example.initialization')) %></a> <%= escape_html(documentation_t('example.and')) %> <a href="<%= escape_html(documentation_url(page: 'authentication')) %>"><%= escape_html(documentation_t('example.authentication')) %></a>.</p>
             <% info[:examples].each_with_index do |example, index| %>
-              <% example_title = example[:title].empty? ? "Example ##{index}" : example[:title] %>
+              <% example_title = example[:title].empty? ? documentation_t('example.title', index: 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>
@@ -99,7 +99,7 @@
   </div>
   <% unless info[:resources].empty? %>
     <% 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>
+    <h2 id="<%= escape_html(children_target) %>"><%= escape_html(documentation_t('labels.subresources')) %><%= documentation_permalink(children_target, documentation_t('labels.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} %>

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

@@ -1,7 +1,7 @@
 <section id="resources">
-  <h1>Resources<%= documentation_permalink('resources', 'Resources') %></h1>
+  <h1><%= escape_html(documentation_t('labels.resources')) %><%= documentation_permalink('resources', documentation_t('labels.resources')) %></h1>
   <% if documentation_search_query.empty? %>
-  <nav aria-label="Resources" data-resource-nav>
+  <nav aria-label="<%= escape_html(documentation_t('labels.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: []} %>

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

@@ -1,7 +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>
+  <h2 id="reference-usage"><%= escape_html(documentation_t('labels.usage')) %><%= documentation_permalink('reference-usage', documentation_t('labels.usage')) %></h2>
+  <p><%= escape_html(documentation_t('usage.choose')) %></p>
+  <p><%= escape_html(documentation_t('usage.start')) %> <a href="#initialization"><%= escape_html(documentation_t('labels.initialization')) %></a> <%= escape_html(documentation_t('usage.below')) %> <a href="<%= escape_html(documentation_url(page: 'authentication')) %>"><%= escape_html(documentation_t('labels.authentication')) %></a> <%= escape_html(documentation_t('usage.credentials')) %> <a href="<%= escape_html(documentation_url(page: 'resources')) %>"><%= escape_html(documentation_t('labels.resources')) %></a> <%= escape_html(documentation_t('usage.browse')) %></p>
+  <p><%= escape_html(documentation_t('usage.search')) %></p>
+  <p><%= escape_html(documentation_t('usage.signed_out')) %><% if documentation_account_context&.dig(:controls) %> <%= escape_html(documentation_t('usage.sign_in')) %><% end %></p>
 </section>

data/lib/haveapi/views/version_page.erb

@@ -1,30 +1,30 @@
 <% 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>
+  <p><%= escape_html(documentation_t('overview.api_address')) %> <code><%= escape_html("#{base_url}#{root}") %></code>.</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>
+  <p><%= escape_html(documentation_t('overview.versions', version: @v)) %></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>
+    <h2><%= escape_html(documentation_t('labels.initialization')) %><%= documentation_permalink('initialization', documentation_t('labels.initialization')) %></h2>
+    <p><%= escape_html(documentation_t('overview.initialize_before')) %> <a href="<%= escape_html(documentation_url(page: 'authentication')) %>"><%= escape_html(documentation_t('overview.authentication_link')) %></a> <%= escape_html(documentation_t('overview.initialize_after')) %></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>
+  <p><a href="<%= escape_html(documentation_url(page: 'resources')) %>" data-resource-directory-link><%= escape_html(documentation_t('overview.browse_link')) %></a> <%= escape_html(documentation_t('overview.browse_after')) %></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 %>
+  <nav class="docs-breadcrumb" aria-label="<%= escape_html(documentation_t('accessibility.breadcrumb')) %>"><ol><li><a href="<%= escape_html(documentation_url) %>"><%= escape_html(documentation_t('labels.overview')) %></a></li><li aria-current="page"><%= escape_html(documentation_t('labels.authentication')) %></li></ol></nav>
+  <h1 id="auth"><%= escape_html(documentation_t('labels.authentication')) %><%= documentation_permalink('auth', documentation_t('labels.authentication')) %></h1>
+  <p><%= escape_html(documentation_t('authentication.initialize_before')) %> <a href="<%= escape_html(documentation_url(anchor: 'initialization')) %>"><%= escape_html(documentation_t('authentication.overview_link')) %></a><%= escape_html(documentation_t('authentication.initialize_after')) %></p>
+  <% if @help[:authentication].empty? %><p><%= escape_html(documentation_t('authentication.disabled')) %></p><% end %>
   <% @help[:authentication].each do |name, info| %>
     <%= erb :'version_page/auth_body', locals: {name: name, info: info} %>
   <% end %>
 <% else %>
   <% entry = @documentation_resource %>
-  <nav aria-label="Breadcrumb" data-resource-breadcrumbs>
+  <nav class="docs-breadcrumb" aria-label="<%= escape_html(documentation_t('accessibility.breadcrumb')) %>" data-resource-breadcrumbs>
     <ol>
-      <li><a href="<%= escape_html(documentation_url(page: 'resources')) %>">Resources</a></li>
+      <li><a href="<%= escape_html(documentation_url(page: 'resources')) %>"><%= escape_html(documentation_t('labels.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>

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

@@ -5,11 +5,11 @@
       <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>
+          <li><a data-doc-subsection href="#<%= escape_html(documentation_reference_anchor(authentication: method, section: :resources)) %>"><%= escape_html(documentation_t('labels.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>
+        <li><a data-doc-subsection href="#<%= escape_html(documentation_reference_anchor(authentication: method, section: :examples)) %>"><%= escape_html(documentation_t('labels.examples')) %></a></li>
       </ul>
     </li>
   <% end %>

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

@@ -3,23 +3,23 @@
 <div class="authentication">
   <% if account[:user] && controls[:signed_in] %>
     <div class="docs-account-content">
-      <span class="sr-only">Account </span><span class="docs-identity"><%= escape_html(account[:user].login) %></span>
-      <form method="post" action="<%= escape_html(controls[:logout_url]) %>">
-        <input type="hidden" name="csrf" value="<%= escape_html(controls[:csrf_token]) %>">
-        <button type="submit">Sign out</button>
-      </form>
+      <span class="sr-only"><%= escape_html(documentation_t('labels.account')) %> </span><span class="docs-identity"><%= escape_html(account[:user].login) %></span>
       <% if controls[:switch_user] %>
         <form method="post" action="<%= escape_html(controls[:logout_url]) %>">
           <input type="hidden" name="csrf" value="<%= escape_html(controls[:csrf_token]) %>">
           <input type="hidden" name="switch_user" value="1">
-          <button type="submit">Switch user</button>
+          <button type="submit"><%= escape_html(documentation_t('labels.switch_user')) %></button>
         </form>
       <% end %>
+      <form method="post" action="<%= escape_html(controls[:logout_url]) %>">
+        <input type="hidden" name="csrf" value="<%= escape_html(controls[:csrf_token]) %>">
+        <button type="submit"><%= escape_html(documentation_t('labels.sign_out')) %></button>
+      </form>
     </div>
   <% else %>
-    <a class="docs-sign-in" href="<%= escape_html(controls[:login_url]) %>" data-documentation-login aria-label="Sign in" title="Sign in">
+    <a class="docs-sign-in" href="<%= escape_html(controls[:login_url]) %>" data-documentation-login aria-label="<%= escape_html(documentation_t('labels.sign_in')) %>" title="<%= escape_html(documentation_t('labels.sign_in')) %>">
       <svg viewBox="0 0 24 24" aria-hidden="true" focusable="false" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="8" r="4"></circle><path d="M4 21v-2a8 8 0 0 1 16 0v2"></path></svg>
-      <span>Sign in</span>
+      <span><%= escape_html(documentation_t('labels.sign_in')) %></span>
     </a>
   <% end %>
 </div>

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

@@ -1,3 +1,3 @@
 <% controls = account[:controls] %>
-<p class="docs-visibility-note"><%= account[:user] ? 'Showing resources, actions and parameters available to this account.' : 'Showing all resources, actions and parameters.' %></p>
+<p class="docs-visibility-note"><%= escape_html(documentation_t(account[:user] ? 'visibility.account' : 'visibility.all')) %></p>
 <% if controls && controls[:message] %><p role="status"><%= escape_html(controls[:message]) %></p><% end %>

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

@@ -2,14 +2,25 @@
   <a href="<%= escape_html(url(root, false)) %>"><%= escape_html(documentation_identity_name) %></a>
   <% if @v %><small class="docs-api-version">API v<%= escape_html(@v) %></small><% end %>
   <details data-documentation-menu>
-    <summary aria-label="Documentation settings" title="Documentation settings">
+    <summary aria-label="<%= escape_html(documentation_t('labels.settings')) %>" title="<%= escape_html(documentation_t('labels.settings')) %>">
       <svg viewBox="0 0 24 24" aria-hidden="true" focusable="false" fill="none" stroke="currentColor" stroke-width="2"><path d="m9.5 3-.5 2.1-1.7 1-2.1-.6-2.5 4.3 1.6 1.5v2l-1.6 1.5 2.5 4.3 2.1-.6 1.7 1 .5 2.1h5l.5-2.1 1.7-1 2.1.6 2.5-4.3-1.6-1.5v-2l1.6-1.5-2.5-4.3-2.1.6-1.7-1L14.5 3Z"></path><circle cx="12" cy="12" r="3"></circle></svg>
     </summary>
     <div data-documentation-menu-content>
-      <span id="docs-theme-label" class="docs-theme-label">Theme</span>
+      <form data-documentation-language method="get" action="<%= escape_html(request.path) %>">
+        <% documentation_language_parameters.each do |key, value| %>
+          <input type="hidden" name="<%= escape_html(key) %>" value="<%= escape_html(value) %>">
+        <% end %>
+        <label for="docs-language"><%= escape_html(documentation_t('labels.language')) %></label>
+        <select id="docs-language" name="doc_lang">
+          <option value="en"<% if documentation_locale == 'en' %> selected<% end %>>English</option>
+          <option value="cs"<% if documentation_locale == 'cs' %> selected<% end %>>Česky</option>
+        </select>
+        <button type="submit" data-documentation-language-submit><%= escape_html(documentation_t('labels.apply_language')) %></button>
+      </form>
+      <span id="docs-theme-label" class="docs-theme-label"><%= escape_html(documentation_t('labels.theme')) %></span>
       <div class="docs-theme-choices" role="group" aria-labelledby="docs-theme-label">
-        <% {auto: 'Automatic theme', light: 'Light theme', dark: 'Dark theme'}.each do |choice, label| %>
-          <button type="button" data-theme-choice="<%= choice %>" aria-label="<%= label %>" title="<%= label %>" aria-pressed="<%= choice == :auto %>">
+        <% {auto: 'labels.theme_auto', light: 'labels.theme_light', dark: 'labels.theme_dark'}.each do |choice, label| %>
+          <button type="button" data-theme-choice="<%= choice %>" aria-label="<%= escape_html(documentation_t(label)) %>" title="<%= escape_html(documentation_t(label)) %>" aria-pressed="<%= choice == :auto %>">
             <svg viewBox="0 0 24 24" aria-hidden="true" focusable="false" fill="none" stroke="currentColor" stroke-width="2">
               <% if choice == :auto %><circle cx="12" cy="12" r="8"></circle><path d="M12 4a8 8 0 0 0 0 16Z" fill="currentColor"></path>
               <% elsif choice == :light %><circle cx="12" cy="12" r="4"></circle><path d="M12 2v2m0 16v2M2 12h2m16 0h2M5 5l2 2m10 10 2 2M5 19l2-2M17 7l2-2"></path>
@@ -21,7 +32,7 @@
       <% if account %>
         <%= erb :'version_sidebar/authentication_control', locals: {account: account} %>
       <% elsif (account_url = documentation_neutral_account_url) %>
-        <a class="docs-account-link" href="<%= escape_html(account_url) %>" aria-label="Account" title="Account"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="8" r="4"></circle><path d="M4 21v-2a8 8 0 0 1 16 0v2"></path></svg><span>Account</span></a>
+        <a class="docs-account-link" href="<%= escape_html(account_url) %>" aria-label="<%= escape_html(documentation_t('labels.account')) %>" title="<%= escape_html(documentation_t('labels.account')) %>"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="8" r="4"></circle><path d="M4 21v-2a8 8 0 0 1 16 0v2"></path></svg><span><%= escape_html(documentation_t('labels.account')) %></span></a>
       <% end %>
     </div>
   </details>

data/lib/haveapi/views/version_sidebar.erb

@@ -2,22 +2,22 @@
 <% if (search_options = documentation_search_form_options(id: 'docs-search-sidebar')) %>
   <%= erb :'documentation/search_form', locals: search_options %>
 <% end %>
-<nav aria-label="Documentation pages">
+<nav aria-label="<%= escape_html(documentation_t('accessibility.pages')) %>">
   <ul>
-    <li><a href="<%= escape_html(documentation_url) %>"<% if @documentation_page == 'overview' %> aria-current="page"<% end %>>Overview</a></li>
+    <li><a href="<%= escape_html(documentation_url) %>"<% if @documentation_page == 'overview' %> aria-current="page"<% end %>><%= escape_html(documentation_t('labels.overview')) %></a></li>
     <li>
-      <a href="<%= escape_html(documentation_url(page: 'authentication')) %>"<% if @documentation_page == 'authentication' %> aria-current="page"<% end %>>Authentication</a>
+      <a href="<%= escape_html(documentation_url(page: 'authentication')) %>"<% if @documentation_page == 'authentication' %> aria-current="page"<% end %>><%= escape_html(documentation_t('labels.authentication')) %></a>
       <% if @documentation_page == 'authentication' %>
-        <nav aria-label="Authentication methods" data-action-nav><%= erb :'version_sidebar/auth_nav', locals: {methods: @help[:authentication]} %></nav>
+        <nav aria-label="<%= escape_html(documentation_t('accessibility.authentication_methods')) %>" data-action-nav><%= erb :'version_sidebar/auth_nav', locals: {methods: @help[:authentication]} %></nav>
       <% end %>
     </li>
-    <li><a href="<%= escape_html(documentation_url(page: 'resources')) %>"<% if @documentation_page == 'resources' %> aria-current="page"<% end %> data-resource-directory-link>Resources</a></li>
+    <li><a href="<%= escape_html(documentation_url(page: 'resources')) %>"<% if @documentation_page == 'resources' %> aria-current="page"<% end %> data-resource-directory-link><%= escape_html(documentation_t('labels.resources')) %></a></li>
   </ul>
 </nav>
 <% if @documentation_resource %>
   <p data-current-resource><a href="<%= escape_html(documentation_url(resource: @documentation_resource[:key])) %>"><strong><%= escape_html(@documentation_resource[:key]) %></strong></a></p>
-  <nav aria-label="Actions on this resource" data-action-nav>
-    <h2>Actions</h2>
+  <nav aria-label="<%= escape_html(documentation_t('accessibility.resource_actions')) %>" data-action-nav>
+    <h2><%= escape_html(documentation_t('labels.actions')) %></h2>
     <ul class="docs-action-list">
       <% sort_hash(@documentation_resource[:info][:actions]).each do |action, info| %>
         <% target = documentation_resource_target(resource_path: @documentation_resource[:path], action_name: action) %>
@@ -33,8 +33,8 @@
     </ul>
   </nav>
   <% unless @documentation_resource[:info][:resources].empty? %>
-    <nav aria-label="Subresources">
-      <h2>Subresources</h2>
+    <nav aria-label="<%= escape_html(documentation_t('labels.subresources')) %>">
+      <h2><%= escape_html(documentation_t('labels.subresources')) %></h2>
       <ul>
         <% sort_hash(@documentation_resource[:info][:resources]).each do |child, _child_info| %>
           <% child_path = @documentation_resource[:path] + [child.to_s] %>
@@ -44,17 +44,32 @@
     </nav>
   <% end %>
 <% end %>
-<div class="docs-preferences">
-  <label>Language <select data-language-select>
-    <% documentation_client_metadata.uniq { |client| client[:language] }.each do |client| %>
-      <option value="<%= escape_html(client[:language]) %>"><%= escape_html(client[:language_label]) %></option>
+<% selection = documentation_example_selection %>
+<% if selection[:client] %>
+<% metadata = documentation_client_metadata %>
+<% variants = metadata.select { |entry| entry[:language] == selection[:language] } %>
+<% levels = metadata.find { |entry| entry[:id] == selection[:client].id }.fetch(:details) %>
+<% detail = documentation_example_detail(levels) %>
+<form class="docs-preferences" data-example-preferences method="get" action="<%= escape_html(request.path) %>"<% if selection[:explicit] %> data-example-selection="<%= escape_html(documentation_json(language: selection[:language], client: selection[:client].id, detail:)) %>"<% end %>>
+  <% documentation_example_form_parameters.each do |key, value| %>
+    <input type="hidden" name="<%= escape_html(key) %>" value="<%= escape_html(value) %>">
+  <% end %>
+  <label><%= escape_html(documentation_t('labels.programming_language')) %> <select data-language-select name="example_language">
+    <% metadata.uniq { |entry| entry[:language] }.each do |entry| %>
+      <option value="<%= escape_html(entry[:language]) %>"<% if entry[:language] == selection[:language] %> selected<% end %>><%= escape_html(entry[:language_label]) %></option>
     <% end %>
   </select></label>
-  <label data-variant-control>Client <select data-variant-select>
-    <% documentation_clients.each do |client| %>
-      <option value="<%= escape_html(client.id) %>"><%= escape_html(client.variant || client.language_label) %></option>
+  <label data-variant-control><%= escape_html(documentation_t('labels.client')) %> <select data-variant-select name="example_client"<% if variants.length < 2 %> disabled<% end %>>
+    <% variants.each do |entry| %>
+      <option value="<%= escape_html(entry[:id]) %>"<% if entry[:id] == selection[:client].id %> selected<% end %>><%= escape_html(entry[:variant] || entry[:language_label]) %></option>
     <% end %>
   </select></label>
-  <label data-detail-control>Examples <select data-detail-select><option value="simple">Simple</option><option value="thorough">With error handling</option></select></label>
+  <% if variants.length < 2 %><input type="hidden" name="example_client" value="<%= escape_html(selection[:client].id) %>"><% end %>
+  <label data-detail-control<% if levels.length < 2 %> hidden<% end %>><%= escape_html(documentation_t('labels.examples')) %> <select data-detail-select name="example_detail"<% if levels.length < 2 %> disabled<% end %>>
+    <% levels.each do |level| %><option value="<%= escape_html(level) %>"<% if level == detail %> selected<% end %>><%= escape_html(documentation_t(level == 'thorough' ? 'labels.thorough' : 'labels.simple')) %></option><% end %>
+  </select></label>
+  <% if levels.length < 2 %><input type="hidden" name="example_detail" value="<%= escape_html(detail) %>"><% end %>
+  <button type="submit" data-apply-examples><%= escape_html(documentation_t('labels.apply_examples')) %></button>
   <p data-preference-status role="status"></p>
-</div>
+</form>
+<% end %>