iobroker.autodoc 0.9.35

package/admin/i18n/uk.json

@@ -0,0 +1,229 @@
+{
+	"autodoc adapter settings": "Налаштування адаптера для autodoc",
+	"Project name": "Project name",
+	"Name of the ioBroker project or installation": "Name of the ioBroker project or installation",
+	"Target system": "Target system",
+	"Usually ioBroker": "Usually ioBroker",
+	"Documentation profile": "Documentation profile",
+	"Target audience for the generated documentation": "Target audience for the generated documentation",
+	"Documentation language": "Documentation language",
+	"Language for the generated documentation": "Language for the generated documentation",
+	"English": "English",
+	"German": "German",
+	"Target audience for Markdown export and default focus. HTML always includes all three profiles (admin, user, onboarding). AI text for User/Onboarding HTML runs whenever a KI provider is set, regardless of this selection.": "Target audience for Markdown export and default focus. HTML always includes all three profiles (admin, user, onboarding). AI text for User/Onboarding HTML runs whenever a KI provider is set, regardless of this selection.",
+	"Project description": "Project description",
+	"Short description of what should be documented": "Short description of what should be documented",
+	"Additional notes": "Additional notes",
+	"Optional notes, devices, adapters or special requirements": "Optional notes, devices, adapters or special requirements",
+	"Generate documentation on adapter start": "Generate documentation on adapter start",
+	"If enabled, documentation is queued each time the adapter starts (runs in the background; the instance can show green before it finishes). If disabled, a run still happens once after an update when the built-in HTML renderer version no longer matches info.templateVersion. Check the log for \"Documentation generated via startup\" and state info.lastTrigger.": "If enabled, documentation is queued each time the adapter starts (runs in the background; the instance can show green before it finishes). If disabled, a run still happens once after an update when the built-in HTML renderer version no longer matches info.templateVersion. Check the log for \"Documentation generated via startup\" and state info.lastTrigger.",
+	"Generate documentation on adapter changes": "Generate documentation on adapter changes",
+	"If enabled, documentation is regenerated automatically when adapters are installed, removed, or enabled/disabled (30 second debounce)": "If enabled, documentation is regenerated automatically when adapters are installed, removed, or enabled/disabled (30 second debounce)",
+	"Read live state values (opt-in)": "Read live state values (opt-in)",
+	"If enabled, current values for selected state roles are read and shown in User/Onboarding room cards and the Admin device table (badges next to device names). Includes e.g. temperature, blinds (level.blind), dimmers, lights (switch.light), outlets (switch/plug), humidity, power metrics, locks, door/window/contact, motion, alarm. Room members may be channels or devices — matching child states are found automatically. Very custom or empty roles are skipped.": "If enabled, current values for selected state roles are read and shown in User/Onboarding room cards and the Admin device table (badges next to device names). Includes e.g. temperature, blinds (level.blind), dimmers, lights (switch.light), outlets (switch/plug), humidity, power metrics, locks, door/window/contact, motion, alarm. Room members may be channels or devices — matching child states are found automatically. Very custom or empty roles are skipped.",
+	"Scheduled interval (hours)": "Scheduled interval (hours)",
+	"Optional timer: regenerate every X hours, independent of start and adapter-change options above. 0 = no scheduled runs (events and start still work).": "Optional timer: regenerate every X hours, independent of start and adapter-change options above. 0 = no scheduled runs (events and start still work).",
+	"Only document enabled instances": "Only document enabled instances",
+	"If enabled, only active adapter instances are included in the documentation": "If enabled, only active adapter instances are included in the documentation",
+	"Hide instance details in markdown": "Hide instance details in markdown",
+	"If enabled, the markdown output contains only summary information without the full instance list": "If enabled, the markdown output contains only summary information without the full instance list",
+	"Maximum documented instances": "Maximum documented instances",
+	"Limits how many adapter instances are included in the generated documentation, 0 means unlimited": "Limits how many adapter instances are included in the generated documentation, 0 means unlimited",
+	"ioBroker base URL (optional)": "ioBroker base URL (optional)",
+	"Used for the info.htmlUrl state. Include port, e.g. 192.168.1.100:8081 or http://myserver:8082. Protocol is optional. Leave empty for auto-detection (may fail in Docker).": "Used for the info.htmlUrl state. Include port, e.g. 192.168.1.100:8081 or http://myserver:8082. Protocol is optional. Leave empty for auto-detection (may fail in Docker).",
+	"Maximum stored documentation files": "Maximum stored documentation files",
+	"How many timestamped file sets to keep (per type: .md, .html, .json). Oldest are deleted automatically. 0 = use default (3).": "How many timestamped file sets to keep (per type: .md, .html, .json). Oldest are deleted automatically. 0 = use default (3).",
+	"Documentation states storage": "Documentation states storage",
+	"Documentation states storage help": "Full: duplicate markdown, HTML, and JSON in adapter states (legacy, larger object DB / Redis). Metadata only: keep full exports only under Files (autodoc-latest.*); states hold a short placeholder — reduces database size. Scripts that read documentation.* for full text must use /files/ or HTTP URLs instead. Download actions still write autodoc.md / .json / .html from the latest files. In both modes **`documentation.exportHashes`** stores **SHA-256 (hex)** digests of the latest MD / Admin HTML / JSON exports for change detection. **After a successful PDF export** (optional `puppeteer`), the same state also includes **`autodoc-admin.pdf`**, **`autodoc-user.pdf`**, and **`autodoc-onboarding.pdf`** digests when those files are written.",
+	"Doc states mode full": "Full (in states — larger DB)",
+	"Doc states mode metadata": "Metadata only (content in /files only)",
+	"Manual context (JSON)": "Manual context (JSON)",
+	"Additional manual information to include in documentation (description, contact, notes)": "Additional manual information to include in documentation (description, contact, notes)",
+	"Basic settings": "Basic settings",
+	"Documentation & layout": "Documentation & layout",
+	"Admin tab orientation AI": "Optional: connect an AI provider to add short explanations in exports. Leave the provider on Disabled unless you want this. Local Ollama keeps data on your network; cloud providers send metadata and text to external servers — see the privacy note below.",
+	"Admin tab orientation basic": "You are on Basic settings: language, when documentation regenerates, optional live values in room cards, Generate now / last run / forum card. The tabs My documentation, Advanced, and HTML export & extra sections hold readable content and filters. Notifications and AI documentation at the end are optional.",
+	"Admin tab orientation documentation": "This tab holds reader-facing texts. Tab Advanced is for filters, Markdown detail limits, ioBroker base URL for links/QR codes, documentation storage mode, optional file copy, and the documentation setup score. Tab HTML export & extra sections controls colors/theme, chapter visibility and order, and custom Markdown. AI-only context hints for prompts (never in exports) live on AI documentation once a provider is enabled.",
+	"Admin tab orientation notify": "Optional: send a message (e.g. Telegram, email) after each documentation run. Skip this tab if you do not need alerts.",
+	"Basic section profile": "Profile & language",
+	"Basic section triggers": "When to regenerate",
+	"Basic section discovery": "Live values in the documentation",
+	"Basic section manual": "Run now & status",
+	"Manual section project": "Project, contact & notes",
+	"Doc section appearance": "Look, theme & logo",
+	"Doc section expert styling": "Optional: custom font & CSS",
+	"Advanced styling open hint": "Optional expert settings: change the font or add CSS on top of the **theme preset** and **color scheme** above. Leave empty to keep the default look. A syntax error in CSS can break the layout. **Chapter visibility and custom Markdown sections** are in the blocks **above** on this tab — not part of this section.",
+	"Doc section chapters": "Which chapters to show (per profile)",
+	"Notify section": "After each documentation run",
+	"AI section provider": "Provider, model & connection",
+	"AI section tuning": "Sampling temperature (optional)",
+	"AI section scripts": "JavaScript scripts (optional AI pass)",
+	"My documentation": "My documentation",
+	"Advanced": "Advanced",
+	"Advanced section content": "What to include & limits",
+	"Advanced section states": "State storage & public URL",
+	"Advanced section filesystem": "Optional: extra copy to disk",
+	"Advanced setup score intro": "The **documentation setup score** (below) appears in generated Admin documentation. One optional row checks that the **ioBroker base URL** above is not empty — useful for QR codes and bookmark links. Turn individual rows off or change thresholds if they do not fit your installation.",
+	"Advanced section maintenance score": "Documentation setup score",
+	"Maintenance score include description check": "Include project description length",
+	"Maintenance score description check help": "When enabled, the Admin export **documentation setup score** counts this row: “My documentation” — project description must reach at least the minimum length below. Turn off if you deliberately keep a short description.",
+	"Maintenance score include base URL check": "Include ioBroker base URL",
+	"Maintenance score base URL check help": "When enabled, the setup score requires a non-empty **ioBroker base URL** above (QR codes, bookmark links, troubleshooting bookmarks).",
+	"Maintenance score include unassigned check": "Include unassigned instances check",
+	"Maintenance score unassigned check help": "When enabled, the setup score fails when the number of enabled adapter instances not assigned to any room is **≥** the threshold below. Many setups skip rooms on purpose — raise the threshold or disable this check.",
+	"Maintenance score min description length": "Minimum project description length (characters)",
+	"Maintenance score min description length help": "Trimmed character count. Default 40; the adapter clamps to **5–2000**.",
+	"Maintenance score unassigned warn at": "Unassigned instances — warn from (count)",
+	"Maintenance score unassigned warn at help": "The check fails when the unassigned count is **≥** this value. Default **10**; the adapter clamps to **1–500**. Lower values are stricter.",
+	"Admin export scripts hint": "In the generated Admin HTML/Markdown, JavaScript scripts are listed by ioBroker folder (Global first, with a short reminder). This matches the Script Engine tree — not a separate AutoDoc setting.",
+	"AI documentation": "AI documentation",
+	"Manual documentation hint": "These fields are shown in all documentation profiles. Use “Help & emergencies”, “Routines (your words)”, and “How we run this home (your playbook)” for guests and family in plain language — nothing is invented automatically. Adapter and room notes make the documentation more readable for non-technical users. In the Admin HTML/Markdown export, JavaScript scripts are grouped by ioBroker folder; see the short note under “Global scripts” about execution order and sensible use.",
+	"Guest & family (plain language)": "Guest & family (plain language)",
+	"Help & emergencies (guests/family)": "Help & emergencies (guests/family)",
+	"Who to call, what to try if something fails, where the fuse box is — your words only; nothing is invented automatically.": "Who to call, what to try if something fails, where the fuse box is — your words only; nothing is invented automatically.",
+	"Routines & automations (your words)": "Routines & automations (your words)",
+	"Describe in everyday language what often runs by itself (lights, heating, blinds). Shown near the script list; complements technical script names.": "Describe in everyday language what often runs by itself (lights, heating, blinds). Shown near the script list; complements technical script names.",
+	"Troubleshooting — quick lines (optional)": "Troubleshooting — quick lines (optional)",
+	"Troubleshooting quick lines hint": "Short one-liners for guests and family (Wi‑Fi, power, water, other). They appear in the **Help & emergencies** block together with **bookmark links** to this documentation (same URLs as QR codes — requires **Base URL** under Advanced). All optional; nothing is invented automatically.",
+	"Quick: Wi-Fi / network": "Quick: Wi-Fi / network",
+	"One line, e.g. guest Wi-Fi name or where a repeater is — optional.": "One line, e.g. guest Wi-Fi name or where a repeater is — optional.",
+	"Quick: power / fuses": "Quick: power / fuses",
+	"One line, e.g. where the electrical panel is — optional.": "One line, e.g. where the electrical panel is — optional.",
+	"Quick: water shutoff": "Quick: water shutoff",
+	"One line, e.g. where to turn off main water — optional.": "One line, e.g. where to turn off main water — optional.",
+	"Quick: other": "Quick: other",
+	"One more short line (alarm code location, key box, etc.) — optional.": "One more short line (alarm code location, key box, etc.) — optional.",
+	"Contact person": "Contact person",
+	"Who manages this system? e.g. 'Max Mustermann, Telegram @max' - shown so guests and family know who to ask": "Who manages this system? e.g. 'Max Mustermann, Telegram @max' - shown so guests and family know who to ask",
+	"General notes": "General notes",
+	"General notes about this installation (e.g. special setups, known issues)": "General notes about this installation (e.g. special setups, known issues)",
+	"Per-adapter notes": "Per-adapter notes",
+	"Adapter notes": "Adapter notes",
+	"Add a human-readable note for specific adapters (shown in all profiles)": "Add a human-readable note for specific adapters (shown in all profiles)",
+	"Adapter (e.g. telegram)": "Adapter (e.g. telegram)",
+	"Note": "Note",
+	"Per-room notes": "Per-room notes",
+	"Room notes": "Room notes",
+	"Add a human-readable note for specific rooms (shown in User and Onboarding profiles)": "Add a human-readable note for specific rooms (shown in User and Onboarding profiles)",
+	"Room name": "Room name",
+	"Generate now hint": "Click the button below to generate the documentation immediately without restarting the adapter. All three profiles (Admin, User, Onboarding) are generated simultaneously.",
+	"Generate documentation now": "Generate documentation now",
+	"Generate documentation": "Generate documentation",
+	"Start documentation generation now? This may take a few seconds.": "Start documentation generation now? This may take a few seconds.",
+	"Generate": "Generate",
+	"Cancel": "Cancel",
+	"Last generated": "Last generated",
+	"Forum system card (plaintext)": "Forum system card (plaintext)",
+	"AI explain JavaScript scripts (opt-in)": "AI explain JavaScript scripts (opt-in)",
+	"Sends sanitized script source to the same AI provider to add short plain-language explanations in User/Onboarding docs. Lines matching common secret patterns are redacted first; still review before enabling on production systems.": "Sends sanitized script source to the same AI provider to add short plain-language explanations in User/Onboarding docs. Lines matching common secret patterns are redacted first; still review before enabling on production systems.",
+	"Max characters of script source per KI call": "Max characters of script source per KI call",
+	"How many characters of each script (after redaction) are sent to the model; longer sources are truncated. Default 12000. Lower to speed up or fit small context; raise only if your model and timeout allow. Range 2000–100000. State info.aiScriptSourceProgress shows e.g. 5/12 while processing.": "How many characters of each script (after redaction) are sent to the model; longer sources are truncated. Default 12000. Lower to speed up or fit small context; raise only if your model and timeout allow. Range 2000–100000. State info.aiScriptSourceProgress shows e.g. 5/12 while processing.",
+	"Cancel script KI hint": "Use this if a long script-AI run must be stopped: set action.cancelScriptSourceAi, use the button, or sendTo command cancelScriptSourceAi. The current KI request may still finish; further scripts are skipped. info.aiScriptSourceProgress shows cancelled when the phase ends.",
+	"Cancel script KI (running generation)": "Cancel script KI (running generation)",
+	"Cancel script KI": "Cancel script KI",
+	"Stop the optional per-script KI pass? The request that is already running may still finish; further scripts will not be started. (The main user/onboarding KI calls run before this phase.)": "Stop the optional per-script KI pass? The request that is already running may still finish; further scripts will not be started. (The main user/onboarding KI calls run before this phase.)",
+	"User/Family - hide from family": "User/Family - hide from family",
+	"User hide hint": "Rooms and adapters listed here are not shown in the User/Family profile.",
+	"Hidden rooms (User/Family)": "Hidden rooms (User/Family)",
+	"User hidden rooms help": "Enter the exact room name as it appears in ioBroker",
+	"Hidden adapters (User/Family)": "Hidden adapters (User/Family)",
+	"User hidden adapters help": "Enter the adapter name without instance number (e.g. backitup)",
+	"Onboarding - hide from guests": "Onboarding - hide from guests",
+	"Onboarding hide hint": "Rooms and adapters listed here are not shown in the Onboarding profile - useful for technical rooms (server, backup) that guests do not need to see.",
+	"Hidden rooms (Onboarding)": "Hidden rooms (Onboarding)",
+	"Onboarding hidden rooms help": "Enter the exact room name as it appears in ioBroker (e.g. Server room, Backup)",
+	"Room name (exact)": "Room name (exact)",
+	"Hidden adapters (Onboarding)": "Hidden adapters (Onboarding)",
+	"Onboarding hidden adapters help": "Enter the adapter name without instance number (e.g. backitup, simple-api)",
+	"Onboarding guest view — list internal JavaScript file names": "Onboarding guest view — list internal JavaScript file names",
+	"onboarding guest script names help": "Off (default): guest Onboarding shows only how many JavaScript automations are active — no internal script file names, and no per-script lines in Quick Start (ioBroker **common.desc** is not a reliable guest-facing “description”). On: legacy — up to five script names in “What runs automatically?” plus a short “more running” line; Quick Start may still list scripts with name + **common.desc** as today. Full detail stays in the Admin profile.",
+	"Adapter name (e.g. backitup)": "Adapter name (e.g. backitup)",
+	"Manual context (JSON, legacy)": "Manual context (JSON, legacy)",
+	"Legacy JSON field. Use the 'My documentation' tab instead. Only needed for migration.": "Legacy JSON field. Use the 'My documentation' tab instead. Only needed for migration.",
+	"French": "French",
+	"User/Family": "User/Family",
+	"Notifications": "Notifications",
+	"Send notification after documentation generation": "Send notification after documentation generation",
+	"If enabled, a message is sent via the configured adapter after each generation": "If enabled, a message is sent via the configured adapter after each generation",
+	"Messaging adapter instance": "Messaging adapter instance",
+	"Instance to send the notification through, e.g. telegram.0, pushover.0, email.0": "Instance to send the notification through, e.g. telegram.0, pushover.0, email.0",
+	"Recipient (optional)": "Recipient (optional)",
+	"Telegram username, Pushover device, or email address — leave empty for adapter default": "Telegram username, Pushover device, or email address — leave empty for adapter default",
+	"Custom message template (optional)": "Custom message template (optional)",
+	"Use {project}, {summary}, {version}, {trigger} as placeholders. Leave empty for default message.": "Use {project}, {summary}, {version}, {trigger} as placeholders. Leave empty for default message.",
+	"AI-Enhanced Documentation": "AI-Enhanced Documentation",
+	"AI provider": "AI provider",
+	"Select an AI provider for narrative summaries. Disabled for admin profile (all data is already factual). Not used for admin profile.": "Select an AI provider for narrative summaries. Not used for admin profile (all data is already factual).",
+	"Disabled": "Disabled",
+	"AI privacy warning": "⚠️ Privacy note: Cloud providers (Mistral, Groq, Anthropic) receive adapter names, room names, JavaScript script titles, and optional script purpose text (common.desc) when present. No passwords or IP addresses are sent, but your smart home structure is visible to the provider. Ollama runs locally — nothing leaves your network.",
+	"AI hardware hint": "ℹ️ Low-power hosts (e.g. Raspberry Pi) or CPU-only Ollama: small models run faster but summaries may be rougher or less reliable — that is expected. You can disable AI here; Markdown/HTML docs still generate from your real ioBroker data. For better text: run Ollama on a faster PC/NAS and set the Ollama base URL to that host, or use a cloud provider if the privacy trade-off is acceptable.",
+	"Ollama — local, private, free (recommended)": "Ollama — local, private, free (recommended)",
+	"Mistral AI — EU/GDPR, free tier": "Mistral AI — EU/GDPR, free tier",
+	"Groq — US, free tier (data may be used for training)": "Groq — US, free tier (data may be used for training)",
+	"Anthropic Claude — paid, no training on data": "Anthropic Claude — paid, no training on data",
+	"Ollama recommended: runs locally, no data leaves your network. Cloud providers send adapter/room/script names to external servers.": "Ollama recommended: runs locally, no data leaves your network. Cloud providers send adapter and room identifiers, script titles, and any optional common.desc text to external servers.",
+	"AI model (optional)": "AI model (optional)",
+	"Leave empty for default. Ollama: llama3.2 / gemma3. Mistral: mistral-small-latest. Groq: llama-3.3-70b-versatile. Anthropic: claude-haiku-4-5-20251001": "Leave empty for default. Ollama: llama3.2 / gemma3. Mistral: mistral-small-latest. Groq: llama-3.3-70b-versatile. Anthropic: claude-haiku-4-5-20251001",
+	"API key": "API key",
+	"Mistral: console.mistral.ai | Groq: starts with gsk_... | Anthropic: starts with sk-ant-... | Ollama: leave empty": "Mistral: console.mistral.ai | Groq: starts with gsk_... | Anthropic: starts with sk-ant-... | Ollama: leave empty",
+	"Ollama base URL": "Ollama base URL",
+	"Only for Ollama. Default: http://localhost:11434": "Only for Ollama. Default: http://localhost:11434",
+	"AI request timeout seconds (optional)": "AI request timeout seconds (optional)",
+	"Maximum wait for one LLM HTTP request. Default 300. Each generation uses several calls (user, onboarding, sometimes a German polish pass). Increase for slow local models on CPU (e.g. 480 or 600 for llama3.1:8b on NAS). Range 30–900.": "Maximum wait for one LLM HTTP request. Default 300. Each generation uses several calls (user, onboarding, sometimes a German polish pass). Increase for slow local models on CPU (e.g. 480 or 600 for llama3.1:8b on NAS). Range 30–900.",
+	"AI temperature — user profile (optional)": "AI temperature — user profile (optional)",
+	"Sampling temperature for resident-facing AI text. Leave empty for the provider default. Typical range 0–2 (Ollama, Groq, Mistral); Anthropic accepts 0–1 (values above 1 are clamped). Lower ≈ steadier wording; higher ≈ more variation — tune after testing.": "Sampling temperature for resident-facing AI text. Leave empty for the provider default. Typical range 0–2 (Ollama, Groq, Mistral); Anthropic accepts 0–1 (values above 1 are clamped). Lower ≈ steadier wording; higher ≈ more variation — tune after testing.",
+	"AI temperature — onboarding (optional)": "AI temperature — onboarding (optional)",
+	"Sampling temperature for guest/onboarding AI text. Same rules as user profile. The German Sie polish pass uses a fixed low temperature and ignores this field.": "Sampling temperature for guest/onboarding AI text. Same rules as user profile. The German Sie polish pass uses a fixed low temperature and ignores this field.",
+	"Filesystem export path (optional)": "Filesystem export path (optional)",
+	"Export path hint": "Optional: additional export to a real filesystem path outside ioBroker's database. Leave empty to disable. Examples: /mnt/nas/autodoc, D:\\Docs\\smarthome. All three profiles (admin/user/onboarding) are written as HTML files. When PDF export is enabled and **puppeteer** is installed in this adapter folder, matching **autodoc-*.pdf** files are mirrored here too. Useful for accessing the documentation when ioBroker is down, or for serving via a web server.",
+	"Advanced section pdf export": "PDF export (optional Puppeteer / Chromium)",
+	"Pdf export after generation label": "Generate PDF after each documentation run",
+	"Pdf export after generation help": "**Optional:** after each successful generation, create **autodoc-admin.pdf**, **autodoc-user.pdf**, **autodoc-onboarding.pdf** via headless Chromium (**npm package `puppeteer`** must be installed in **this adapter directory**, e.g. clone/tarball → `npm install puppeteer` or enable optional dependencies during install). Uses the same sandbox flags as Mermaid CLI (Docker/LXC-friendly). **Embedded Mermaid SVG** (optional @mermaid-js/mermaid-cli) prints offline; **jsDelivr** client Mermaid needs internet during the PDF step. Large documents can take minutes and use noticeable RAM/CPU. You can also trigger PDFs manually with the adapter state **action.exportPdf** (no full regeneration).",
+	"multihostDistribution": "Host Distribution",
+	"AI context hints": "AI context hints",
+	"AI context hints (owner notes)": "AI context hints (owner notes)",
+	"AI context hints hint": "Optional bullet-point facts about your home for the AI — used only in the AI prompt, never shown in the documentation. Example: '- Lights in living room auto-off at 22:00', '- Guests can control temperature via voice'. The more specific, the better the AI text quality. — **Guest onboarding:** Prefer everyday wording (e.g. \"we are still setting things up\", \"docs will be expanded\"). If you pack in IT/project jargon (\"adapter\", \"repository\", \"not in the repo\", …), the model may repeat it in guest-facing text. A **safety filter** then replaces the guest AI block with a neutral default so visitors do not read admin-style jargon. That behaviour is intentional; relaxing it would weaken guest-safe output. The **resident / family profile** is not subject to this rule.",
+	"AI context hints help": "Short points only the AI sees — not shown in exported documentation. Privacy: sent to the configured AI provider. — **Guest profile:** See the longer hint above: technical wording in context hints can cause the guest AI text to be discarded and replaced with neutral copy.",
+	"HTML export & extra sections": "HTML export & extra sections",
+	"Doc layout intro": "Tune generated **HTML** (all three profiles): optional forced light/dark mode, a **color preset** (no raw CSS), logo, and your own Markdown chapters. **Font** and **extra CSS** are optional expert settings at the **bottom** of this tab (after chapter visibility and custom sections). Admin **chapter order** and **hide list** apply to Admin HTML and Admin-profile Markdown. **Hide lists** for **User/Family** and **Onboarding** (e.g. `ownerPlaybook`) are **below** on this tab and affect those HTML exports and Markdown when that documentation profile is selected. Markdown also uses your custom sections.",
+	"Doc layout pdf hint": "**PDF export:** settings are on the **Advanced** tab (below filesystem export path): optional **PDF after each generation**, or use the **`action.exportPdf`** button state any time. Requires optional **`puppeteer`** in the adapter directory. Writes **`autodoc-{admin,user,onboarding}.pdf`** under adapter **Files** and mirrors them when a filesystem export path is set.",
+	"Advanced HTML styling (optional)": "Advanced HTML styling (optional)",
+	"Advanced HTML styling hint": "**Expert / optional:** Custom font and CSS change how exported HTML looks. Syntax mistakes or future AutoDoc updates can make the layout look wrong — leave these fields empty if you are unsure.",
+	"HTML color scheme": "HTML color scheme",
+	"Auto (viewer toggle + saved preference)": "Auto (viewer toggle + saved preference)",
+	"Light only": "Light only",
+	"Dark only": "Dark only",
+	"HTML color scheme help": "**Auto:** visitors can toggle light/dark; preference is stored in the browser. **Light / Dark:** fixed look; the toggle is hidden. Does not affect Markdown files.",
+	"HTML theme preset": "HTML color preset",
+	"HTML theme preset help": "Adjusts the built-in **CSS variable** palette (background, text, links, table headers, …) for **exported HTML** only. Lighter on writing custom CSS: change the preset first, use **Extra CSS** only for fine-tuning. Works with the **color scheme** above (light and dark each get a matching palette).",
+	"HTML theme preset default": "Default",
+	"HTML theme preset high contrast": "High contrast",
+	"HTML theme preset warm": "Warm",
+	"HTML theme preset slate": "Slate",
+	"Sidebar logo URL": "Sidebar logo URL",
+	"Sidebar logo URL help": "Optional image above the search box in exported HTML. Use **https://…** or a same-site path starting with **/** (e.g. a file under ioBroker `/files/…`). Other schemes are ignored.",
+	"Font stack (CSS)": "Font stack (CSS)",
+	"Font stack help": "Optional `font-family` value for body text, e.g. `Georgia, serif` or `system-ui, sans-serif`. Characters `< > { }` are stripped for safety.",
+	"Extra CSS": "Extra CSS",
+	"Extra CSS help": "Appended to the HTML `<style>` block. For branding (accent colours, spacing). You control this CSS — avoid pasting untrusted content. Do not close `</style>` inside this field. Prefer small rules; overly broad selectors can break the page after updates.",
+	"Admin HTML — hide chapters": "Admin HTML — hide chapters",
+	"Admin chapter order hint": "Optional: reorder **Admin** HTML and **Admin** Markdown. Enter **chapter ids** in the JSON field below (`[]` = built-in order). Ids you omit are appended in the default product order at the end. The **full list of valid English ids** appears **only** in that field’s help (click the `?` tooltip) — it is not repeated here.",
+	"Admin chapter order (JSON array)": "Admin chapter order (JSON array)",
+	"Admin chapter order JSON help": "JSON array of strings, e.g. `[\"system\",\"adapters\",\"manual\"]`. **Valid chapter ids (exact English):** `manual`, `system`, `adapters`, `rooms`, `scripts`, `schedule`, `userdata`, `aliases`, `maintenance`, `diagnosis`, `troubleshooting`, `custom`, `changelog`, `appendices`. Unknown ids are skipped; ids you do not name are added at the end in default order. Empty `[]` = built-in order.",
+	"Admin hidden chapters hint": "Chapter **ids** to omit from **Admin** HTML and from **Markdown** when the profile is Admin — e.g. `[\"diagnosis\",\"changelog\",\"custom\"]`. **Same valid English ids** as for **chapter order**; the full list is **only** in the help for **Admin chapter order** (that JSON field is **below** on this page). Invalid ids are ignored.",
+	"Hidden chapter IDs (JSON array)": "Hidden chapter IDs (JSON array)",
+	"Admin hidden chapters JSON help": "JSON array of strings, e.g. `[\"userdata\",\"aliases\"]`. **Same valid ids** as **Admin chapter order** (see that field’s help for the full list). Empty `[]` = show all chapters.",
+	"Custom Markdown sections": "Custom Markdown sections",
+	"Custom sections JSON hint": "JSON array of objects: `{ \"title\": \"Wi-Fi\", \"body\": \"**Guest** …\", \"profiles\": [\"user\",\"onboarding\"] }`. **body** is Markdown (no raw HTML). **profiles** optional — omit to show in all three HTML profiles. Max 12 sections; long text is truncated. Example uses: emergency contacts, Wi-Fi, router model.",
+	"Custom sections (JSON)": "Custom sections (JSON)",
+	"Custom sections JSON help": "See the hint above. After editing, run **Generate documentation** again. **Walkthrough** (German, fictional demo home): https://github.com/crunchip77/ioBroker.autodoc/blob/main/docs/user-guide/README.de.md",
+	"User/Family HTML — hide chapters": "User/Family HTML — hide chapters",
+	"User hidden chapters hint": "JSON array of chapter ids to hide in **User/Family** HTML and in **Markdown** when the documentation profile is User. Example: `[\"scripts\",\"adapters\"]`. Valid ids: `manual` (project description/contact/notes only), `ai`, `guestHelp`, `atAGlance` (Quick overview from discovery; User HTML + User Markdown), `rooms`, `scripts`, `routines`, `ownerPlaybook`, `adapters`, `custom`, `system`, `troubleshooting`.",
+	"User profile — hidden chapter IDs (JSON)": "User profile — hidden chapter IDs (JSON)",
+	"User hidden chapters JSON help": "JSON array of strings. Empty `[]` shows all.",
+	"Onboarding HTML — hide chapters": "Onboarding HTML — hide chapters",
+	"Onboarding hidden chapters hint": "Hide blocks in **Onboarding** HTML and matching parts of **Markdown** (profile Onboarding). Valid ids: `welcome`, `tips`, `guestHelp`, `stats`, `ai`, `capabilities`, `rooms`, `routines`, `ownerPlaybook`, `automations`, `adapters`, `custom`, `hint`, plus for Markdown also `quickstart`, `system`, `manual` (project description/contact in welcome + manual chapter subsections).",
+	"Onboarding profile — hidden chapter IDs (JSON)": "Onboarding profile — hidden chapter IDs (JSON)",
+	"Onboarding hidden chapters JSON help": "JSON array of strings. Empty `[]` shows all.",
+	"copyForForum": "Copy for Forum"
+}

package/admin/i18n/zh-cn.json

@@ -0,0 +1,229 @@
+{
+	"autodoc adapter settings": "autodoc的适配器设置",
+	"Project name": "Project name",
+	"Name of the ioBroker project or installation": "Name of the ioBroker project or installation",
+	"Target system": "Target system",
+	"Usually ioBroker": "Usually ioBroker",
+	"Documentation profile": "Documentation profile",
+	"Target audience for the generated documentation": "Target audience for the generated documentation",
+	"Documentation language": "Documentation language",
+	"Language for the generated documentation": "Language for the generated documentation",
+	"English": "English",
+	"German": "German",
+	"Target audience for Markdown export and default focus. HTML always includes all three profiles (admin, user, onboarding). AI text for User/Onboarding HTML runs whenever a KI provider is set, regardless of this selection.": "Target audience for Markdown export and default focus. HTML always includes all three profiles (admin, user, onboarding). AI text for User/Onboarding HTML runs whenever a KI provider is set, regardless of this selection.",
+	"Project description": "Project description",
+	"Short description of what should be documented": "Short description of what should be documented",
+	"Additional notes": "Additional notes",
+	"Optional notes, devices, adapters or special requirements": "Optional notes, devices, adapters or special requirements",
+	"Generate documentation on adapter start": "Generate documentation on adapter start",
+	"If enabled, documentation is queued each time the adapter starts (runs in the background; the instance can show green before it finishes). If disabled, a run still happens once after an update when the built-in HTML renderer version no longer matches info.templateVersion. Check the log for \"Documentation generated via startup\" and state info.lastTrigger.": "If enabled, documentation is queued each time the adapter starts (runs in the background; the instance can show green before it finishes). If disabled, a run still happens once after an update when the built-in HTML renderer version no longer matches info.templateVersion. Check the log for \"Documentation generated via startup\" and state info.lastTrigger.",
+	"Generate documentation on adapter changes": "Generate documentation on adapter changes",
+	"If enabled, documentation is regenerated automatically when adapters are installed, removed, or enabled/disabled (30 second debounce)": "If enabled, documentation is regenerated automatically when adapters are installed, removed, or enabled/disabled (30 second debounce)",
+	"Read live state values (opt-in)": "Read live state values (opt-in)",
+	"If enabled, current values for selected state roles are read and shown in User/Onboarding room cards and the Admin device table (badges next to device names). Includes e.g. temperature, blinds (level.blind), dimmers, lights (switch.light), outlets (switch/plug), humidity, power metrics, locks, door/window/contact, motion, alarm. Room members may be channels or devices — matching child states are found automatically. Very custom or empty roles are skipped.": "If enabled, current values for selected state roles are read and shown in User/Onboarding room cards and the Admin device table (badges next to device names). Includes e.g. temperature, blinds (level.blind), dimmers, lights (switch.light), outlets (switch/plug), humidity, power metrics, locks, door/window/contact, motion, alarm. Room members may be channels or devices — matching child states are found automatically. Very custom or empty roles are skipped.",
+	"Scheduled interval (hours)": "Scheduled interval (hours)",
+	"Optional timer: regenerate every X hours, independent of start and adapter-change options above. 0 = no scheduled runs (events and start still work).": "Optional timer: regenerate every X hours, independent of start and adapter-change options above. 0 = no scheduled runs (events and start still work).",
+	"Only document enabled instances": "Only document enabled instances",
+	"If enabled, only active adapter instances are included in the documentation": "If enabled, only active adapter instances are included in the documentation",
+	"Hide instance details in markdown": "Hide instance details in markdown",
+	"If enabled, the markdown output contains only summary information without the full instance list": "If enabled, the markdown output contains only summary information without the full instance list",
+	"Maximum documented instances": "Maximum documented instances",
+	"Limits how many adapter instances are included in the generated documentation, 0 means unlimited": "Limits how many adapter instances are included in the generated documentation, 0 means unlimited",
+	"ioBroker base URL (optional)": "ioBroker base URL (optional)",
+	"Used for the info.htmlUrl state. Include port, e.g. 192.168.1.100:8081 or http://myserver:8082. Protocol is optional. Leave empty for auto-detection (may fail in Docker).": "Used for the info.htmlUrl state. Include port, e.g. 192.168.1.100:8081 or http://myserver:8082. Protocol is optional. Leave empty for auto-detection (may fail in Docker).",
+	"Maximum stored documentation files": "Maximum stored documentation files",
+	"How many timestamped file sets to keep (per type: .md, .html, .json). Oldest are deleted automatically. 0 = use default (3).": "How many timestamped file sets to keep (per type: .md, .html, .json). Oldest are deleted automatically. 0 = use default (3).",
+	"Documentation states storage": "Documentation states storage",
+	"Documentation states storage help": "Full: duplicate markdown, HTML, and JSON in adapter states (legacy, larger object DB / Redis). Metadata only: keep full exports only under Files (autodoc-latest.*); states hold a short placeholder — reduces database size. Scripts that read documentation.* for full text must use /files/ or HTTP URLs instead. Download actions still write autodoc.md / .json / .html from the latest files. In both modes **`documentation.exportHashes`** stores **SHA-256 (hex)** digests of the latest MD / Admin HTML / JSON exports for change detection. **After a successful PDF export** (optional `puppeteer`), the same state also includes **`autodoc-admin.pdf`**, **`autodoc-user.pdf`**, and **`autodoc-onboarding.pdf`** digests when those files are written.",
+	"Doc states mode full": "Full (in states — larger DB)",
+	"Doc states mode metadata": "Metadata only (content in /files only)",
+	"Manual context (JSON)": "Manual context (JSON)",
+	"Additional manual information to include in documentation (description, contact, notes)": "Additional manual information to include in documentation (description, contact, notes)",
+	"Basic settings": "Basic settings",
+	"Documentation & layout": "Documentation & layout",
+	"Admin tab orientation AI": "Optional: connect an AI provider to add short explanations in exports. Leave the provider on Disabled unless you want this. Local Ollama keeps data on your network; cloud providers send metadata and text to external servers — see the privacy note below.",
+	"Admin tab orientation basic": "You are on Basic settings: language, when documentation regenerates, optional live values in room cards, Generate now / last run / forum card. The tabs My documentation, Advanced, and HTML export & extra sections hold readable content and filters. Notifications and AI documentation at the end are optional.",
+	"Admin tab orientation documentation": "This tab holds reader-facing texts. Tab Advanced is for filters, Markdown detail limits, ioBroker base URL for links/QR codes, documentation storage mode, optional file copy, and the documentation setup score. Tab HTML export & extra sections controls colors/theme, chapter visibility and order, and custom Markdown. AI-only context hints for prompts (never in exports) live on AI documentation once a provider is enabled.",
+	"Admin tab orientation notify": "Optional: send a message (e.g. Telegram, email) after each documentation run. Skip this tab if you do not need alerts.",
+	"Basic section profile": "Profile & language",
+	"Basic section triggers": "When to regenerate",
+	"Basic section discovery": "Live values in the documentation",
+	"Basic section manual": "Run now & status",
+	"Manual section project": "Project, contact & notes",
+	"Doc section appearance": "Look, theme & logo",
+	"Doc section expert styling": "Optional: custom font & CSS",
+	"Advanced styling open hint": "Optional expert settings: change the font or add CSS on top of the **theme preset** and **color scheme** above. Leave empty to keep the default look. A syntax error in CSS can break the layout. **Chapter visibility and custom Markdown sections** are in the blocks **above** on this tab — not part of this section.",
+	"Doc section chapters": "Which chapters to show (per profile)",
+	"Notify section": "After each documentation run",
+	"AI section provider": "Provider, model & connection",
+	"AI section tuning": "Sampling temperature (optional)",
+	"AI section scripts": "JavaScript scripts (optional AI pass)",
+	"My documentation": "My documentation",
+	"Advanced": "Advanced",
+	"Advanced section content": "What to include & limits",
+	"Advanced section states": "State storage & public URL",
+	"Advanced section filesystem": "Optional: extra copy to disk",
+	"Advanced setup score intro": "The **documentation setup score** (below) appears in generated Admin documentation. One optional row checks that the **ioBroker base URL** above is not empty — useful for QR codes and bookmark links. Turn individual rows off or change thresholds if they do not fit your installation.",
+	"Advanced section maintenance score": "Documentation setup score",
+	"Maintenance score include description check": "Include project description length",
+	"Maintenance score description check help": "When enabled, the Admin export **documentation setup score** counts this row: “My documentation” — project description must reach at least the minimum length below. Turn off if you deliberately keep a short description.",
+	"Maintenance score include base URL check": "Include ioBroker base URL",
+	"Maintenance score base URL check help": "When enabled, the setup score requires a non-empty **ioBroker base URL** above (QR codes, bookmark links, troubleshooting bookmarks).",
+	"Maintenance score include unassigned check": "Include unassigned instances check",
+	"Maintenance score unassigned check help": "When enabled, the setup score fails when the number of enabled adapter instances not assigned to any room is **≥** the threshold below. Many setups skip rooms on purpose — raise the threshold or disable this check.",
+	"Maintenance score min description length": "Minimum project description length (characters)",
+	"Maintenance score min description length help": "Trimmed character count. Default 40; the adapter clamps to **5–2000**.",
+	"Maintenance score unassigned warn at": "Unassigned instances — warn from (count)",
+	"Maintenance score unassigned warn at help": "The check fails when the unassigned count is **≥** this value. Default **10**; the adapter clamps to **1–500**. Lower values are stricter.",
+	"Admin export scripts hint": "In the generated Admin HTML/Markdown, JavaScript scripts are listed by ioBroker folder (Global first, with a short reminder). This matches the Script Engine tree — not a separate AutoDoc setting.",
+	"AI documentation": "AI documentation",
+	"Manual documentation hint": "These fields are shown in all documentation profiles. Use “Help & emergencies”, “Routines (your words)”, and “How we run this home (your playbook)” for guests and family in plain language — nothing is invented automatically. Adapter and room notes make the documentation more readable for non-technical users. In the Admin HTML/Markdown export, JavaScript scripts are grouped by ioBroker folder; see the short note under “Global scripts” about execution order and sensible use.",
+	"Guest & family (plain language)": "Guest & family (plain language)",
+	"Help & emergencies (guests/family)": "Help & emergencies (guests/family)",
+	"Who to call, what to try if something fails, where the fuse box is — your words only; nothing is invented automatically.": "Who to call, what to try if something fails, where the fuse box is — your words only; nothing is invented automatically.",
+	"Routines & automations (your words)": "Routines & automations (your words)",
+	"Describe in everyday language what often runs by itself (lights, heating, blinds). Shown near the script list; complements technical script names.": "Describe in everyday language what often runs by itself (lights, heating, blinds). Shown near the script list; complements technical script names.",
+	"Troubleshooting — quick lines (optional)": "Troubleshooting — quick lines (optional)",
+	"Troubleshooting quick lines hint": "Short one-liners for guests and family (Wi‑Fi, power, water, other). They appear in the **Help & emergencies** block together with **bookmark links** to this documentation (same URLs as QR codes — requires **Base URL** under Advanced). All optional; nothing is invented automatically.",
+	"Quick: Wi-Fi / network": "Quick: Wi-Fi / network",
+	"One line, e.g. guest Wi-Fi name or where a repeater is — optional.": "One line, e.g. guest Wi-Fi name or where a repeater is — optional.",
+	"Quick: power / fuses": "Quick: power / fuses",
+	"One line, e.g. where the electrical panel is — optional.": "One line, e.g. where the electrical panel is — optional.",
+	"Quick: water shutoff": "Quick: water shutoff",
+	"One line, e.g. where to turn off main water — optional.": "One line, e.g. where to turn off main water — optional.",
+	"Quick: other": "Quick: other",
+	"One more short line (alarm code location, key box, etc.) — optional.": "One more short line (alarm code location, key box, etc.) — optional.",
+	"Contact person": "Contact person",
+	"Who manages this system? e.g. 'Max Mustermann, Telegram @max' - shown so guests and family know who to ask": "Who manages this system? e.g. 'Max Mustermann, Telegram @max' - shown so guests and family know who to ask",
+	"General notes": "General notes",
+	"General notes about this installation (e.g. special setups, known issues)": "General notes about this installation (e.g. special setups, known issues)",
+	"Per-adapter notes": "Per-adapter notes",
+	"Adapter notes": "Adapter notes",
+	"Add a human-readable note for specific adapters (shown in all profiles)": "Add a human-readable note for specific adapters (shown in all profiles)",
+	"Adapter (e.g. telegram)": "Adapter (e.g. telegram)",
+	"Note": "Note",
+	"Per-room notes": "Per-room notes",
+	"Room notes": "Room notes",
+	"Add a human-readable note for specific rooms (shown in User and Onboarding profiles)": "Add a human-readable note for specific rooms (shown in User and Onboarding profiles)",
+	"Room name": "Room name",
+	"Generate now hint": "Click the button below to generate the documentation immediately without restarting the adapter. All three profiles (Admin, User, Onboarding) are generated simultaneously.",
+	"Generate documentation now": "Generate documentation now",
+	"Generate documentation": "Generate documentation",
+	"Start documentation generation now? This may take a few seconds.": "Start documentation generation now? This may take a few seconds.",
+	"Generate": "Generate",
+	"Cancel": "Cancel",
+	"Last generated": "Last generated",
+	"Forum system card (plaintext)": "Forum system card (plaintext)",
+	"AI explain JavaScript scripts (opt-in)": "AI explain JavaScript scripts (opt-in)",
+	"Sends sanitized script source to the same AI provider to add short plain-language explanations in User/Onboarding docs. Lines matching common secret patterns are redacted first; still review before enabling on production systems.": "Sends sanitized script source to the same AI provider to add short plain-language explanations in User/Onboarding docs. Lines matching common secret patterns are redacted first; still review before enabling on production systems.",
+	"Max characters of script source per KI call": "Max characters of script source per KI call",
+	"How many characters of each script (after redaction) are sent to the model; longer sources are truncated. Default 12000. Lower to speed up or fit small context; raise only if your model and timeout allow. Range 2000–100000. State info.aiScriptSourceProgress shows e.g. 5/12 while processing.": "How many characters of each script (after redaction) are sent to the model; longer sources are truncated. Default 12000. Lower to speed up or fit small context; raise only if your model and timeout allow. Range 2000–100000. State info.aiScriptSourceProgress shows e.g. 5/12 while processing.",
+	"Cancel script KI hint": "Use this if a long script-AI run must be stopped: set action.cancelScriptSourceAi, use the button, or sendTo command cancelScriptSourceAi. The current KI request may still finish; further scripts are skipped. info.aiScriptSourceProgress shows cancelled when the phase ends.",
+	"Cancel script KI (running generation)": "Cancel script KI (running generation)",
+	"Cancel script KI": "Cancel script KI",
+	"Stop the optional per-script KI pass? The request that is already running may still finish; further scripts will not be started. (The main user/onboarding KI calls run before this phase.)": "Stop the optional per-script KI pass? The request that is already running may still finish; further scripts will not be started. (The main user/onboarding KI calls run before this phase.)",
+	"User/Family - hide from family": "User/Family - hide from family",
+	"User hide hint": "Rooms and adapters listed here are not shown in the User/Family profile.",
+	"Hidden rooms (User/Family)": "Hidden rooms (User/Family)",
+	"User hidden rooms help": "Enter the exact room name as it appears in ioBroker",
+	"Hidden adapters (User/Family)": "Hidden adapters (User/Family)",
+	"User hidden adapters help": "Enter the adapter name without instance number (e.g. backitup)",
+	"Onboarding - hide from guests": "Onboarding - hide from guests",
+	"Onboarding hide hint": "Rooms and adapters listed here are not shown in the Onboarding profile - useful for technical rooms (server, backup) that guests do not need to see.",
+	"Hidden rooms (Onboarding)": "Hidden rooms (Onboarding)",
+	"Onboarding hidden rooms help": "Enter the exact room name as it appears in ioBroker (e.g. Server room, Backup)",
+	"Room name (exact)": "Room name (exact)",
+	"Hidden adapters (Onboarding)": "Hidden adapters (Onboarding)",
+	"Onboarding hidden adapters help": "Enter the adapter name without instance number (e.g. backitup, simple-api)",
+	"Onboarding guest view — list internal JavaScript file names": "Onboarding guest view — list internal JavaScript file names",
+	"onboarding guest script names help": "Off (default): guest Onboarding shows only how many JavaScript automations are active — no internal script file names, and no per-script lines in Quick Start (ioBroker **common.desc** is not a reliable guest-facing “description”). On: legacy — up to five script names in “What runs automatically?” plus a short “more running” line; Quick Start may still list scripts with name + **common.desc** as today. Full detail stays in the Admin profile.",
+	"Adapter name (e.g. backitup)": "Adapter name (e.g. backitup)",
+	"Manual context (JSON, legacy)": "Manual context (JSON, legacy)",
+	"Legacy JSON field. Use the 'My documentation' tab instead. Only needed for migration.": "Legacy JSON field. Use the 'My documentation' tab instead. Only needed for migration.",
+	"French": "French",
+	"User/Family": "User/Family",
+	"Notifications": "Notifications",
+	"Send notification after documentation generation": "Send notification after documentation generation",
+	"If enabled, a message is sent via the configured adapter after each generation": "If enabled, a message is sent via the configured adapter after each generation",
+	"Messaging adapter instance": "Messaging adapter instance",
+	"Instance to send the notification through, e.g. telegram.0, pushover.0, email.0": "Instance to send the notification through, e.g. telegram.0, pushover.0, email.0",
+	"Recipient (optional)": "Recipient (optional)",
+	"Telegram username, Pushover device, or email address — leave empty for adapter default": "Telegram username, Pushover device, or email address — leave empty for adapter default",
+	"Custom message template (optional)": "Custom message template (optional)",
+	"Use {project}, {summary}, {version}, {trigger} as placeholders. Leave empty for default message.": "Use {project}, {summary}, {version}, {trigger} as placeholders. Leave empty for default message.",
+	"AI-Enhanced Documentation": "AI-Enhanced Documentation",
+	"AI provider": "AI provider",
+	"Select an AI provider for narrative summaries. Disabled for admin profile (all data is already factual). Not used for admin profile.": "Select an AI provider for narrative summaries. Not used for admin profile (all data is already factual).",
+	"Disabled": "Disabled",
+	"AI privacy warning": "⚠️ Privacy note: Cloud providers (Mistral, Groq, Anthropic) receive adapter names, room names, JavaScript script titles, and optional script purpose text (common.desc) when present. No passwords or IP addresses are sent, but your smart home structure is visible to the provider. Ollama runs locally — nothing leaves your network.",
+	"AI hardware hint": "ℹ️ Low-power hosts (e.g. Raspberry Pi) or CPU-only Ollama: small models run faster but summaries may be rougher or less reliable — that is expected. You can disable AI here; Markdown/HTML docs still generate from your real ioBroker data. For better text: run Ollama on a faster PC/NAS and set the Ollama base URL to that host, or use a cloud provider if the privacy trade-off is acceptable.",
+	"Ollama — local, private, free (recommended)": "Ollama — local, private, free (recommended)",
+	"Mistral AI — EU/GDPR, free tier": "Mistral AI — EU/GDPR, free tier",
+	"Groq — US, free tier (data may be used for training)": "Groq — US, free tier (data may be used for training)",
+	"Anthropic Claude — paid, no training on data": "Anthropic Claude — paid, no training on data",
+	"Ollama recommended: runs locally, no data leaves your network. Cloud providers send adapter/room/script names to external servers.": "Ollama recommended: runs locally, no data leaves your network. Cloud providers send adapter and room identifiers, script titles, and any optional common.desc text to external servers.",
+	"AI model (optional)": "AI model (optional)",
+	"Leave empty for default. Ollama: llama3.2 / gemma3. Mistral: mistral-small-latest. Groq: llama-3.3-70b-versatile. Anthropic: claude-haiku-4-5-20251001": "Leave empty for default. Ollama: llama3.2 / gemma3. Mistral: mistral-small-latest. Groq: llama-3.3-70b-versatile. Anthropic: claude-haiku-4-5-20251001",
+	"API key": "API key",
+	"Mistral: console.mistral.ai | Groq: starts with gsk_... | Anthropic: starts with sk-ant-... | Ollama: leave empty": "Mistral: console.mistral.ai | Groq: starts with gsk_... | Anthropic: starts with sk-ant-... | Ollama: leave empty",
+	"Ollama base URL": "Ollama base URL",
+	"Only for Ollama. Default: http://localhost:11434": "Only for Ollama. Default: http://localhost:11434",
+	"AI request timeout seconds (optional)": "AI request timeout seconds (optional)",
+	"Maximum wait for one LLM HTTP request. Default 300. Each generation uses several calls (user, onboarding, sometimes a German polish pass). Increase for slow local models on CPU (e.g. 480 or 600 for llama3.1:8b on NAS). Range 30–900.": "Maximum wait for one LLM HTTP request. Default 300. Each generation uses several calls (user, onboarding, sometimes a German polish pass). Increase for slow local models on CPU (e.g. 480 or 600 for llama3.1:8b on NAS). Range 30–900.",
+	"AI temperature — user profile (optional)": "AI temperature — user profile (optional)",
+	"Sampling temperature for resident-facing AI text. Leave empty for the provider default. Typical range 0–2 (Ollama, Groq, Mistral); Anthropic accepts 0–1 (values above 1 are clamped). Lower ≈ steadier wording; higher ≈ more variation — tune after testing.": "Sampling temperature for resident-facing AI text. Leave empty for the provider default. Typical range 0–2 (Ollama, Groq, Mistral); Anthropic accepts 0–1 (values above 1 are clamped). Lower ≈ steadier wording; higher ≈ more variation — tune after testing.",
+	"AI temperature — onboarding (optional)": "AI temperature — onboarding (optional)",
+	"Sampling temperature for guest/onboarding AI text. Same rules as user profile. The German Sie polish pass uses a fixed low temperature and ignores this field.": "Sampling temperature for guest/onboarding AI text. Same rules as user profile. The German Sie polish pass uses a fixed low temperature and ignores this field.",
+	"Filesystem export path (optional)": "Filesystem export path (optional)",
+	"Export path hint": "Optional: additional export to a real filesystem path outside ioBroker's database. Leave empty to disable. Examples: /mnt/nas/autodoc, D:\\Docs\\smarthome. All three profiles (admin/user/onboarding) are written as HTML files. When PDF export is enabled and **puppeteer** is installed in this adapter folder, matching **autodoc-*.pdf** files are mirrored here too. Useful for accessing the documentation when ioBroker is down, or for serving via a web server.",
+	"Advanced section pdf export": "PDF export (optional Puppeteer / Chromium)",
+	"Pdf export after generation label": "Generate PDF after each documentation run",
+	"Pdf export after generation help": "**Optional:** after each successful generation, create **autodoc-admin.pdf**, **autodoc-user.pdf**, **autodoc-onboarding.pdf** via headless Chromium (**npm package `puppeteer`** must be installed in **this adapter directory**, e.g. clone/tarball → `npm install puppeteer` or enable optional dependencies during install). Uses the same sandbox flags as Mermaid CLI (Docker/LXC-friendly). **Embedded Mermaid SVG** (optional @mermaid-js/mermaid-cli) prints offline; **jsDelivr** client Mermaid needs internet during the PDF step. Large documents can take minutes and use noticeable RAM/CPU. You can also trigger PDFs manually with the adapter state **action.exportPdf** (no full regeneration).",
+	"multihostDistribution": "Host Distribution",
+	"AI context hints": "AI context hints",
+	"AI context hints (owner notes)": "AI context hints (owner notes)",
+	"AI context hints hint": "Optional bullet-point facts about your home for the AI — used only in the AI prompt, never shown in the documentation. Example: '- Lights in living room auto-off at 22:00', '- Guests can control temperature via voice'. The more specific, the better the AI text quality. — **Guest onboarding:** Prefer everyday wording (e.g. \"we are still setting things up\", \"docs will be expanded\"). If you pack in IT/project jargon (\"adapter\", \"repository\", \"not in the repo\", …), the model may repeat it in guest-facing text. A **safety filter** then replaces the guest AI block with a neutral default so visitors do not read admin-style jargon. That behaviour is intentional; relaxing it would weaken guest-safe output. The **resident / family profile** is not subject to this rule.",
+	"AI context hints help": "Short points only the AI sees — not shown in exported documentation. Privacy: sent to the configured AI provider. — **Guest profile:** See the longer hint above: technical wording in context hints can cause the guest AI text to be discarded and replaced with neutral copy.",
+	"HTML export & extra sections": "HTML export & extra sections",
+	"Doc layout intro": "Tune generated **HTML** (all three profiles): optional forced light/dark mode, a **color preset** (no raw CSS), logo, and your own Markdown chapters. **Font** and **extra CSS** are optional expert settings at the **bottom** of this tab (after chapter visibility and custom sections). Admin **chapter order** and **hide list** apply to Admin HTML and Admin-profile Markdown. **Hide lists** for **User/Family** and **Onboarding** (e.g. `ownerPlaybook`) are **below** on this tab and affect those HTML exports and Markdown when that documentation profile is selected. Markdown also uses your custom sections.",
+	"Doc layout pdf hint": "**PDF export:** settings are on the **Advanced** tab (below filesystem export path): optional **PDF after each generation**, or use the **`action.exportPdf`** button state any time. Requires optional **`puppeteer`** in the adapter directory. Writes **`autodoc-{admin,user,onboarding}.pdf`** under adapter **Files** and mirrors them when a filesystem export path is set.",
+	"Advanced HTML styling (optional)": "Advanced HTML styling (optional)",
+	"Advanced HTML styling hint": "**Expert / optional:** Custom font and CSS change how exported HTML looks. Syntax mistakes or future AutoDoc updates can make the layout look wrong — leave these fields empty if you are unsure.",
+	"HTML color scheme": "HTML color scheme",
+	"Auto (viewer toggle + saved preference)": "Auto (viewer toggle + saved preference)",
+	"Light only": "Light only",
+	"Dark only": "Dark only",
+	"HTML color scheme help": "**Auto:** visitors can toggle light/dark; preference is stored in the browser. **Light / Dark:** fixed look; the toggle is hidden. Does not affect Markdown files.",
+	"HTML theme preset": "HTML color preset",
+	"HTML theme preset help": "Adjusts the built-in **CSS variable** palette (background, text, links, table headers, …) for **exported HTML** only. Lighter on writing custom CSS: change the preset first, use **Extra CSS** only for fine-tuning. Works with the **color scheme** above (light and dark each get a matching palette).",
+	"HTML theme preset default": "Default",
+	"HTML theme preset high contrast": "High contrast",
+	"HTML theme preset warm": "Warm",
+	"HTML theme preset slate": "Slate",
+	"Sidebar logo URL": "Sidebar logo URL",
+	"Sidebar logo URL help": "Optional image above the search box in exported HTML. Use **https://…** or a same-site path starting with **/** (e.g. a file under ioBroker `/files/…`). Other schemes are ignored.",
+	"Font stack (CSS)": "Font stack (CSS)",
+	"Font stack help": "Optional `font-family` value for body text, e.g. `Georgia, serif` or `system-ui, sans-serif`. Characters `< > { }` are stripped for safety.",
+	"Extra CSS": "Extra CSS",
+	"Extra CSS help": "Appended to the HTML `<style>` block. For branding (accent colours, spacing). You control this CSS — avoid pasting untrusted content. Do not close `</style>` inside this field. Prefer small rules; overly broad selectors can break the page after updates.",
+	"Admin HTML — hide chapters": "Admin HTML — hide chapters",
+	"Admin chapter order hint": "Optional: reorder **Admin** HTML and **Admin** Markdown. Enter **chapter ids** in the JSON field below (`[]` = built-in order). Ids you omit are appended in the default product order at the end. The **full list of valid English ids** appears **only** in that field’s help (click the `?` tooltip) — it is not repeated here.",
+	"Admin chapter order (JSON array)": "Admin chapter order (JSON array)",
+	"Admin chapter order JSON help": "JSON array of strings, e.g. `[\"system\",\"adapters\",\"manual\"]`. **Valid chapter ids (exact English):** `manual`, `system`, `adapters`, `rooms`, `scripts`, `schedule`, `userdata`, `aliases`, `maintenance`, `diagnosis`, `troubleshooting`, `custom`, `changelog`, `appendices`. Unknown ids are skipped; ids you do not name are added at the end in default order. Empty `[]` = built-in order.",
+	"Admin hidden chapters hint": "Chapter **ids** to omit from **Admin** HTML and from **Markdown** when the profile is Admin — e.g. `[\"diagnosis\",\"changelog\",\"custom\"]`. **Same valid English ids** as for **chapter order**; the full list is **only** in the help for **Admin chapter order** (that JSON field is **below** on this page). Invalid ids are ignored.",
+	"Hidden chapter IDs (JSON array)": "Hidden chapter IDs (JSON array)",
+	"Admin hidden chapters JSON help": "JSON array of strings, e.g. `[\"userdata\",\"aliases\"]`. **Same valid ids** as **Admin chapter order** (see that field’s help for the full list). Empty `[]` = show all chapters.",
+	"Custom Markdown sections": "Custom Markdown sections",
+	"Custom sections JSON hint": "JSON array of objects: `{ \"title\": \"Wi-Fi\", \"body\": \"**Guest** …\", \"profiles\": [\"user\",\"onboarding\"] }`. **body** is Markdown (no raw HTML). **profiles** optional — omit to show in all three HTML profiles. Max 12 sections; long text is truncated. Example uses: emergency contacts, Wi-Fi, router model.",
+	"Custom sections (JSON)": "Custom sections (JSON)",
+	"Custom sections JSON help": "See the hint above. After editing, run **Generate documentation** again. **Walkthrough** (German, fictional demo home): https://github.com/crunchip77/ioBroker.autodoc/blob/main/docs/user-guide/README.de.md",
+	"User/Family HTML — hide chapters": "User/Family HTML — hide chapters",
+	"User hidden chapters hint": "JSON array of chapter ids to hide in **User/Family** HTML and in **Markdown** when the documentation profile is User. Example: `[\"scripts\",\"adapters\"]`. Valid ids: `manual` (project description/contact/notes only), `ai`, `guestHelp`, `atAGlance` (Quick overview from discovery; User HTML + User Markdown), `rooms`, `scripts`, `routines`, `ownerPlaybook`, `adapters`, `custom`, `system`, `troubleshooting`.",
+	"User profile — hidden chapter IDs (JSON)": "User profile — hidden chapter IDs (JSON)",
+	"User hidden chapters JSON help": "JSON array of strings. Empty `[]` shows all.",
+	"Onboarding HTML — hide chapters": "Onboarding HTML — hide chapters",
+	"Onboarding hidden chapters hint": "Hide blocks in **Onboarding** HTML and matching parts of **Markdown** (profile Onboarding). Valid ids: `welcome`, `tips`, `guestHelp`, `stats`, `ai`, `capabilities`, `rooms`, `routines`, `ownerPlaybook`, `automations`, `adapters`, `custom`, `hint`, plus for Markdown also `quickstart`, `system`, `manual` (project description/contact in welcome + manual chapter subsections).",
+	"Onboarding profile — hidden chapter IDs (JSON)": "Onboarding profile — hidden chapter IDs (JSON)",
+	"Onboarding hidden chapters JSON help": "JSON array of strings. Empty `[]` shows all.",
+	"copyForForum": "Copy for Forum"
+}