feat: integrate user manual into help section

2026-07-28 12:15:38 +02:00
parent 41dbb6297c
commit 8903452e96
8 changed files with 409 additions and 4 deletions
@@ -0,0 +1,73 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <meta name="description" content="RollCalc Help">
+  <title>RollCalc Help</title>
+  <style>
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body { font-family: 'Segoe UI', Arial, sans-serif; background: #f4f6f9; color: #2f3437; min-height: 100vh; }
+    .help-header { background: linear-gradient(135deg, #1F5438 0%, #2BAC70 100%); color: #fff; padding: 20px 32px; box-shadow: 0 2px 8px rgba(0,0,0,0.2); }
+    .help-header-inner { max-width: 980px; margin: 0 auto; display: flex; align-items: center; justify-content: space-between; gap: 18px; }
+    .help-header h1 { font-size: 24px; margin-bottom: 5px; }
+    .help-header p { font-size: 13px; opacity: 0.9; }
+    .help-nav { display: flex; gap: 10px; flex-wrap: wrap; }
+    .help-nav a { color: #fff; border: 1px solid rgba(255,255,255,0.58); border-radius: 5px; padding: 7px 13px; text-decoration: none; font-size: 13px; font-weight: 700; background: rgba(255,255,255,0.08); }
+    .help-nav a:hover { background: rgba(255,255,255,0.18); }
+    .help-container { max-width: 980px; margin: 30px auto; padding: 0 16px 60px; }
+    .help-intro { margin-bottom: 22px; line-height: 1.55; color: #4b555a; }
+    .help-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 18px; }
+    .help-card { background: #fff; border: 1px solid #dfe7e2; border-radius: 8px; padding: 20px; box-shadow: 0 2px 12px rgba(0,0,0,0.06); }
+    .help-card h2 { color: #1F5438; font-size: 18px; margin-bottom: 10px; }
+    .help-card p { color: #4f5b60; font-size: 14px; line-height: 1.55; margin-bottom: 18px; }
+    .help-card a { display: inline-block; background: #2BAC70; color: #fff; text-decoration: none; border-radius: 6px; padding: 10px 16px; font-size: 14px; font-weight: 700; }
+    .help-card a:hover { background: #1F5438; }
+    .footer { text-align: center; font-size: 11px; color: #aaa; padding: 18px; }
+    .footer-build-info { margin-top: 6px; color: #bbb; }
+    @media (max-width: 640px) {
+      .help-header { padding: 18px 16px; }
+      .help-header-inner { align-items: flex-start; flex-direction: column; }
+    }
+  </style>
+</head>
+<body>
+  <header class="help-header">
+    <div class="help-header-inner">
+      <div>
+        <h1>RollCalc Help</h1>
+        <p>Documentation for roll calculation and transport capacity analysis</p>
+      </div>
+      <nav class="help-nav" aria-label="Help navigation">
+        <a href="{{ url_for('index') }}">Calculator</a>
+      </nav>
+    </div>
+  </header>
+
+  <main class="help-container">
+    <p class="help-intro">
+      This area provides internal technical documentation for RollCalc. The documents are rendered from the maintained Markdown sources.
+    </p>
+
+    <section class="help-grid" aria-label="Available help documents">
+      <article class="help-card">
+        <h2>User Manual</h2>
+        <p>
+          Workflow-oriented manual for roll calculation, handling evaluation, Load Optimizer usage, and interpretation of Capacity Summary and Capacity Analysis.
+        </p>
+        <a href="{{ url_for('user_manual') }}">Open User Manual</a>
+      </article>
+    </section>
+  </main>
+
+  <footer class="footer">
+    RollCalc Beta &copy; Naue
+    <div class="footer-build-info">
+      Version {{ build_info.version }} |
+      Branch {{ build_info.branch }} |
+      Commit {{ build_info.commit }} |
+      Built {{ build_info.timestamp }}
+    </div>
+  </footer>
+</body>
+</html>
@@ -9,8 +9,11 @@
    * { box-sizing: border-box; margin: 0; padding: 0; }
    body { font-family: 'Segoe UI', Arial, sans-serif; background: #f4f6f9; color: #333; min-height: 100vh; }
    .header { background: linear-gradient(135deg, #1F5438 0%, #2BAC70 100%); color: #fff; padding: 20px 32px; box-shadow: 0 2px 8px rgba(0,0,0,0.2); }
+    .header-inner { max-width: 900px; margin: 0 auto; display: flex; align-items: center; justify-content: space-between; gap: 18px; }
    .header h1 { font-size: 24px; margin-bottom: 5px; }
    .header p { font-size: 13px; opacity: 0.9; }
+    .header-help-link { color: #fff; border: 1px solid rgba(255,255,255,0.58); border-radius: 5px; padding: 7px 13px; text-decoration: none; font-size: 13px; font-weight: 700; background: rgba(255,255,255,0.08); }
+    .header-help-link:hover { background: rgba(255,255,255,0.18); }
    .container { max-width: 900px; margin: 30px auto; padding: 0 16px 60px; }
    .card { background: #fff; border-radius: 10px; box-shadow: 0 2px 12px rgba(0,0,0,0.07); margin-bottom: 24px; overflow: hidden; }
    .card-header { background: #f0f4fa; padding: 16px 22px; border-bottom: 1px solid #e0e8f0; }
@@ -448,6 +451,8 @@
    .margin-color    { background: repeating-linear-gradient(45deg,#fff7e0,#fff7e0 3px,#ffe8a0 3px,#ffe8a0 6px); border-color:#f0b429; }

    @media (max-width: 768px) {
+      .header { padding: 18px 16px; }
+      .header-inner { align-items: flex-start; }
      .lo-accordion-header h3 { font-size: 14px; }
      .lo-preset-buttons { flex-direction: column; }
      .lo-preset-btn { width: 100%; }
@@ -492,8 +497,13 @@
 </div>

 <div class="header">
-  <h1>Naue Roll Diameter Calculator</h1>
-  <p>Roll Diameter • Product Length • Roll Weight • Load Optimizer</p>
+  <div class="header-inner">
+    <div>
+      <h1>Naue Roll Diameter Calculator</h1>
+      <p>Roll Diameter • Product Length • Roll Weight • Load Optimizer</p>
+    </div>
+    <a class="header-help-link" href="{{ url_for('help_index') }}">Help</a>
+  </div>
 </div>

 <div class="container">
@@ -0,0 +1,110 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <meta name="description" content="RollCalc User Manual">
+  <title>RollCalc User Manual</title>
+  <style>
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    html { scroll-behavior: smooth; }
+    body { font-family: 'Segoe UI', Arial, sans-serif; background: #f4f6f9; color: #2f3437; min-height: 100vh; }
+    .help-header { background: linear-gradient(135deg, #1F5438 0%, #2BAC70 100%); color: #fff; padding: 20px 32px; box-shadow: 0 2px 8px rgba(0,0,0,0.2); }
+    .help-header-inner { max-width: 1180px; margin: 0 auto; display: flex; align-items: center; justify-content: space-between; gap: 18px; }
+    .help-header h1 { font-size: 24px; margin-bottom: 5px; }
+    .help-header p { font-size: 13px; opacity: 0.9; }
+    .help-nav { display: flex; gap: 10px; flex-wrap: wrap; }
+    .help-nav a { color: #fff; border: 1px solid rgba(255,255,255,0.58); border-radius: 5px; padding: 7px 13px; text-decoration: none; font-size: 13px; font-weight: 700; background: rgba(255,255,255,0.08); }
+    .help-nav a:hover { background: rgba(255,255,255,0.18); }
+    .manual-shell { max-width: 1180px; margin: 28px auto; padding: 0 16px 60px; }
+    .manual-layout { display: grid; grid-template-columns: 260px minmax(0, 1fr); gap: 24px; align-items: start; }
+    .manual-toc { position: sticky; top: 18px; background: #fff; border: 1px solid #dfe7e2; border-radius: 8px; padding: 16px; box-shadow: 0 2px 12px rgba(0,0,0,0.05); max-height: calc(100vh - 36px); overflow: auto; }
+    .manual-toc h2 { color: #1F5438; font-size: 14px; margin-bottom: 12px; text-transform: uppercase; letter-spacing: 0; }
+    .manual-toc ul { list-style: none; }
+    .manual-toc li { margin: 0 0 8px; }
+    .manual-toc a { color: #34443b; text-decoration: none; font-size: 13px; line-height: 1.35; }
+    .manual-toc a:hover { color: #1F5438; text-decoration: underline; }
+    .manual-toc .toc-level-2 { padding-left: 14px; }
+    .manual-content { background: #fff; border: 1px solid #dfe7e2; border-radius: 8px; padding: 34px 42px; box-shadow: 0 2px 12px rgba(0,0,0,0.05); line-height: 1.62; font-size: 15px; }
+    .manual-content h1, .manual-content h2, .manual-content h3, .manual-content h4 { color: #1F5438; line-height: 1.25; scroll-margin-top: 18px; }
+    .manual-content h1 { font-size: 30px; margin: 0 0 24px; padding-bottom: 14px; border-bottom: 2px solid #dfe7e2; }
+    .manual-content h2 { font-size: 22px; margin: 34px 0 14px; padding-top: 4px; }
+    .manual-content h3 { font-size: 17px; margin: 26px 0 10px; color: #244b39; }
+    .manual-content h4 { font-size: 15px; margin: 20px 0 8px; color: #244b39; }
+    .manual-content p { margin: 0 0 14px; }
+    .manual-content ul, .manual-content ol { margin: 0 0 16px 24px; }
+    .manual-content li { margin: 5px 0; }
+    .manual-content a { color: #1F5438; font-weight: 600; }
+    .manual-content code { background: #eef4f1; border: 1px solid #d7e4de; border-radius: 4px; padding: 1px 4px; font-family: Consolas, 'Courier New', monospace; font-size: 0.92em; }
+    .manual-content pre { background: #f5f7f6; border: 1px solid #dfe7e2; border-radius: 6px; padding: 14px; margin: 16px 0; overflow-x: auto; }
+    .manual-content pre code { background: transparent; border: 0; padding: 0; }
+    .manual-content blockquote { margin: 18px 0; padding: 14px 18px; border-left: 4px solid #2BAC70; background: #f1f8f5; color: #34443b; }
+    .manual-content blockquote p:last-child, .manual-content blockquote ul:last-child { margin-bottom: 0; }
+    .manual-content table { width: 100%; border-collapse: collapse; margin: 18px 0; display: block; overflow-x: auto; }
+    .manual-content th, .manual-content td { border: 1px solid #d7e4de; padding: 9px 11px; text-align: left; vertical-align: top; }
+    .manual-content th { background: #eef4f1; color: #1F5438; }
+    .manual-content img { max-width: 100%; height: auto; border: 1px solid #dfe7e2; border-radius: 6px; background: #f8fafa; display: block; margin: 18px 0 8px; }
+    .manual-error { background: #fff; border: 1px solid #e6c7c7; border-left: 4px solid #b84a4a; border-radius: 8px; padding: 20px; color: #5a2d2d; box-shadow: 0 2px 12px rgba(0,0,0,0.05); }
+    .footer { text-align: center; font-size: 11px; color: #aaa; padding: 18px; }
+    .footer-build-info { margin-top: 6px; color: #bbb; }
+    @media (max-width: 840px) {
+      .help-header { padding: 18px 16px; }
+      .help-header-inner { align-items: flex-start; flex-direction: column; }
+      .manual-layout { grid-template-columns: 1fr; }
+      .manual-toc { position: static; max-height: none; }
+      .manual-content { padding: 24px 20px; }
+      .manual-content h1 { font-size: 25px; }
+      .manual-content h2 { font-size: 20px; }
+    }
+  </style>
+</head>
+<body>
+  <header class="help-header">
+    <div class="help-header-inner">
+      <div>
+        <h1>User Manual</h1>
+        <p>RollCalc technical user documentation</p>
+      </div>
+      <nav class="help-nav" aria-label="Help navigation">
+        <a href="{{ url_for('index') }}">Calculator</a>
+        <a href="{{ url_for('help_index') }}">Help</a>
+      </nav>
+    </div>
+  </header>
+
+  <main class="manual-shell">
+    {% if render_error %}
+      <section class="manual-error" role="alert">
+        <strong>User Manual unavailable</strong>
+        <p>{{ render_error }}</p>
+      </section>
+    {% else %}
+      <div class="manual-layout">
+        <nav class="manual-toc" aria-label="Table of contents">
+          <h2>Contents</h2>
+          <ul>
+            {% for entry in toc %}
+              <li class="toc-level-{{ entry.level }}">
+                <a href="#{{ entry.id }}">{{ entry.title }}</a>
+              </li>
+            {% endfor %}
+          </ul>
+        </nav>
+        <article class="manual-content">
+          {{ manual_html }}
+        </article>
+      </div>
+    {% endif %}
+  </main>
+
+  <footer class="footer">
+    RollCalc Beta &copy; Naue
+    <div class="footer-build-info">
+      Version {{ build_info.version }} |
+      Branch {{ build_info.branch }} |
+      Commit {{ build_info.commit }} |
+      Built {{ build_info.timestamp }}
+    </div>
+  </footer>
+</body>
+</html>