File not found.
'; if (!is_file($path)) return 'File not found.
'; - return vv_docs_markdown(file_get_contents($path), $vars); + return vv_docs_markdown(file_get_contents($path), $vars, $keep); } // Markdown → HTML for the subset these docs actually use: headings, paragraphs, bullet and @@ -102,7 +106,7 @@ function vv_docs_render(string $rel, array $vars): string { // here, after escaping. Injecting into the markdown before rendering, as this file used to
// do, meant both Parsedown's safe mode and the fallback escaped the tags and printed them
// as literal text. The feature never worked; nothing called it, so nothing reported it.
-function vv_docs_markdown(string $md, array $vars): string {
+function vv_docs_markdown(string $md, array $vars, ?callable $keep = null): string {
if (file_exists(PARSEDOWN_PATH)) {
require_once PARSEDOWN_PATH;
$pd = new Parsedown();
@@ -161,17 +165,39 @@ function vv_docs_markdown(string $md, array $vars): string {
if ($inTable) { $out .= "\n"; $inTable = false; }
};
+ // Content before the first heading belongs to the same null-headed group as the title.
+ $skip = $keep !== null && !$keep(null);
+
foreach (explode("\n", str_replace("\r\n", "\n", $md)) as $line) {
+ // Fence state is tracked even inside a skipped section, or a ``` that is being dropped
+ // would leave the parser convinced every following line is code.
if (preg_match('/^```/', $line)) {
- $flushPara(); $closeList(); $closeTable();
- $out .= $inCode ? "\n" : '';
+ if (!$skip) {
+ $flushPara(); $closeList(); $closeTable();
+ $out .= $inCode ? "';
+ }
$inCode = !$inCode;
continue;
}
- if ($inCode) { $out .= htmlspecialchars($line, ENT_QUOTES, 'UTF-8') . "\n"; continue; }
+ if ($inCode) {
+ if (!$skip) $out .= htmlspecialchars($line, ENT_QUOTES, 'UTF-8') . "\n";
+ continue;
+ }
$t = trim($line);
+ // Headings are resolved before the skip test, because a heading is what changes it.
+ if (preg_match('/^(#{1,6})\s+(.*)$/', $t, $m)) {
+ $flushQuote(); $flushPara(); $closeList(); $closeTable();
+ $n = strlen($m[1]);
+ // A level-1 heading is the document title, not a section — it and the preamble that
+ // follows are offered to $keep as null so a caller can take or leave them as a unit.
+ $skip = $keep !== null && !$keep($n === 1 ? null : $m[2]);
+ if (!$skip) $out .= "" . $inline($m[2]) . " \n";
+ continue;
+ }
+ if ($skip) continue;
+
// One guard rather than a flush in every branch: the quote ends the moment a line is
// not a quote line, whatever that next line turns out to be.
if ($quote && !str_starts_with($t, '>')) $flushQuote();
@@ -179,13 +205,6 @@ function vv_docs_markdown(string $md, array $vars): string {
if ($t === '') { $flushPara(); $closeList(); $closeTable(); continue; }
if (preg_match('/^(---+|\*\*\*+)$/', $t)) { $flushPara(); $closeList(); $closeTable(); $out .= "
\n"; continue; }
- if (preg_match('/^(#{1,6})\s+(.*)$/', $t, $m)) {
- $flushPara(); $closeList(); $closeTable();
- $n = strlen($m[1]);
- $out .= "" . $inline($m[2]) . " \n";
- continue;
- }
-
// Consecutive > lines are one quote, not one per line — same wrapping convention as
// paragraphs, which is how they are written.
if (preg_match('/^>\s?(.*)$/', $t, $m)) {
diff --git a/Plugin/unraid/pages/scheduler.php b/Plugin/unraid/pages/scheduler.php
index 216e3e9..38866dc 100644
--- a/Plugin/unraid/pages/scheduler.php
+++ b/Plugin/unraid/pages/scheduler.php
@@ -507,12 +507,24 @@ $runningScripts = array_unique($runningScripts);
+ makes this page parse script PURPOSE blocks instead of restating them.
+ Two tiers, one file. Collapsed leaves the reference tables visible: that is the
+ terse per-control lookup this panel has always been, and it is what you want
+ open while actually working. Expanding adds the task guide above it — the
+ walkthroughs you need once and then stop reading. The split is taken from the
+ section titles, so neither tier is a second copy of anything.
+ vvToggleSug() toggles the header's immediate next sibling, so the guide must
+ stay directly after the header and the quick tier must sit outside it. -->
-
+ !is_string($h) || !str_starts_with($h, 'Reference —')) ?>
+
+ is_string($h) && str_starts_with($h, 'Reference —')) ?>
+