Skip to content

Commit fa22fac

Browse files
voltsparxvoltsparx
committed
Modifications
1 parent a529aa9 commit fa22fac

4 files changed

Lines changed: 253 additions & 4 deletions

File tree

‎docs/website/app.js‎

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@ const DocsData = (() => {
22
const pages = {
33
"index.html": { title: "Overview", short: "Home" },
44
"getting-started.html": { title: "Getting Started", short: "Start" },
5+
"download.html": { title: "Download Center", short: "DL" },
56
"workflow.html": { title: "Workflow", short: "Flow" },
67
"cli-reference.html": { title: "CLI Reference", short: "CLI" },
78
"modes.html": { title: "Modes & Examples", short: "Modes" },
@@ -12,8 +13,12 @@ const DocsData = (() => {
1213
const entries = [
1314
{ id: "home", title: "Overview", page: "index.html", hint: "Landing page, capabilities, release status, and site map.", group: "Start Here" },
1415
{ id: "install", title: "Installation", page: "getting-started.html", hint: "Bundler setup, installers, aliases, and prerequisites.", group: "Start Here" },
15-
{ id: "web-installers", title: "Website Installers", page: "getting-started.html", hint: "Direct downloadable installers for Linux, macOS, and Windows.", group: "Start Here" },
16+
{ id: "web-installers", title: "Website Installers", page: "download.html", hint: "Direct downloadable installers for Linux, macOS, and Windows.", group: "Start Here" },
1617
{ id: "quickstart", title: "Quick Start", page: "getting-started.html", hint: "First safe run, common commands, and early operator flow.", group: "Start Here" },
18+
{ id: "download-home", title: "Download Hub", page: "download.html", hint: "Central page for direct installer downloads and safe usage.", group: "Downloads" },
19+
{ id: "download-scripts", title: "Installer Scripts", page: "download.html", hint: "Download links for Linux, macOS, and Windows installer scripts.", group: "Downloads" },
20+
{ id: "download-usage", title: "Installer Usage", page: "download.html", hint: "Install, test, update, and uninstall lifecycle commands.", group: "Downloads" },
21+
{ id: "download-paths", title: "Install Paths", page: "download.html", hint: "Where the framework and persistent data are stored.", group: "Downloads" },
1722
{ id: "how", title: "How It Works", page: "workflow.html", hint: "Mental model for the framework and how stages feed each other.", group: "Pipeline" },
1823
{ id: "pipeline", title: "Scan Pipeline", page: "workflow.html", hint: "Stage-by-stage execution order and expected outputs.", group: "Pipeline" },
1924
{ id: "passive", title: "Passive Sources", page: "workflow.html", hint: "External passive sources, their role, and what they return.", group: "Pipeline" },
@@ -33,7 +38,7 @@ const DocsData = (() => {
3338
{ id: "author", title: "Project & License", page: "project.html", hint: "Author, repository, license, and publishing context.", group: "Project" }
3439
];
3540

36-
const groups = ["Start Here", "Pipeline", "Operators", "Modes", "Reports", "Project"];
41+
const groups = ["Start Here", "Downloads", "Pipeline", "Operators", "Modes", "Reports", "Project"];
3742

3843
return { pages, entries, groups };
3944
})();

‎docs/website/download.html‎

Lines changed: 240 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,240 @@
1+
<!DOCTYPE html>
2+
<html lang="en">
3+
<head>
4+
<meta charset="UTF-8">
5+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
6+
<title>Download Center | ASRFacet-Rb</title>
7+
<meta name="description" content="Download ASRFacet-Rb installer scripts for Linux, macOS, and Windows, then install with guided lifecycle modes.">
8+
<link rel="canonical" href="https://voltsparx.github.io/ASRFacet-Rb/download.html">
9+
<meta property="og:type" content="website">
10+
<meta property="og:site_name" content="ASRFacet-Rb">
11+
<meta property="og:title" content="Download Center | ASRFacet-Rb">
12+
<meta property="og:description" content="Download ASRFacet-Rb installer scripts for Linux, macOS, and Windows, then install with guided lifecycle modes.">
13+
<meta property="og:url" content="https://voltsparx.github.io/ASRFacet-Rb/download.html">
14+
<meta property="og:image" content="https://raw.githubusercontent.com/voltsparx/ASRFacet-Rb/main/docs/website/web_assets/media/asrfacet-rb-site-preview.png">
15+
<meta property="og:image:type" content="image/png">
16+
<meta name="twitter:card" content="summary_large_image">
17+
<meta name="twitter:title" content="Download Center | ASRFacet-Rb">
18+
<meta name="twitter:description" content="Download ASRFacet-Rb installer scripts for Linux, macOS, and Windows, then install with guided lifecycle modes.">
19+
<meta name="twitter:image" content="https://raw.githubusercontent.com/voltsparx/ASRFacet-Rb/main/docs/website/web_assets/media/asrfacet-rb-site-preview.png">
20+
<link rel="preconnect" href="https://fonts.googleapis.com">
21+
<link href="https://fonts.googleapis.com/css2?family=Share+Tech+Mono&family=Rajdhani:wght@300;400;500;600;700&family=Orbitron:wght@400;600;700;900&display=swap" rel="stylesheet">
22+
<link rel="stylesheet" href="styles.css?v=1.0.0">
23+
<link rel="icon" href="web_assets/media/favicon.ico" sizes="any">
24+
<link rel="shortcut icon" href="web_assets/media/favicon.ico" type="image/x-icon">
25+
</head>
26+
<body data-page="download.html" data-default-section="download-home">
27+
<header id="topbar">
28+
<div id="topbar-logo-wrap"><img id="topbar-logo" src="web_assets/media/asrfacet-rb-web.png" alt="ASRFacet-Rb"><span id="topbar-name">ASRFacet-Rb</span></div>
29+
<span id="topbar-version">v1.0.0 | Download Center</span>
30+
<div id="topbar-links">
31+
<a href="index.html">Home</a>
32+
<a href="getting-started.html#install">Getting Started</a>
33+
<div class="topbar-contact">
34+
<button class="topbar-contact-toggle" type="button" aria-expanded="false">Contact</button>
35+
<div class="topbar-contact-popover" hidden>
36+
<span>voltsparx@gmail.com</span>
37+
<span>voltsparx@proton.me</span>
38+
</div>
39+
</div>
40+
</div>
41+
<div id="topbar-search" class="topbar-search">
42+
<input id="docs-search-input" type="search" placeholder="Quick jump docs..." autocomplete="off">
43+
<div id="docs-search-results" class="topbar-search-results" aria-live="polite"></div>
44+
</div>
45+
<div id="topbar-actions">
46+
<button id="menu-toggle" class="topbar-action topbar-action-menu" type="button">Menu</button>
47+
</div>
48+
</header>
49+
<div id="mobile-shortcuts" aria-label="Mobile shortcuts">
50+
<a href="index.html">Home</a>
51+
<a href="project.html#author">Author &amp; License</a>
52+
<a href="https://raw.githubusercontent.com/voltsparx/ASRFacet-Rb/main/LICENSE" target="_blank">License</a>
53+
</div>
54+
<nav id="sidebar" aria-label="Documentation navigation">
55+
<div class="sidebar-panel-head">
56+
<div class="sidebar-kicker">Download Center</div>
57+
<p class="sidebar-note">One dedicated place to download installer scripts and run the framework lifecycle safely.</p>
58+
</div>
59+
<div id="sidebar-tabs" class="sidebar-tabs" role="tablist" aria-label="Documentation groups"></div>
60+
<div id="sidebar-nav"></div>
61+
</nav>
62+
<button id="sidebar-backdrop" type="button" aria-label="Close navigation"></button>
63+
<main id="main">
64+
<section id="download-home" class="page-section active">
65+
<div class="page-hero">
66+
<div class="page-eyebrow">Download</div>
67+
<div class="page-title">ASRFacet-Rb Download Center</div>
68+
<div class="page-desc">Download platform-specific installers, run guided lifecycle commands, and install ASRFacet-Rb like a real system tool.</div>
69+
</div>
70+
71+
<div class="callout callout-info">
72+
<div class="callout-title">What You Get</div>
73+
Website installers fetch required files from the main repository, then execute the maintained platform installer under <code>install/</code> so behavior stays consistent.
74+
</div>
75+
76+
<div class="callout callout-warn">
77+
<div class="callout-title">Authorized Use Only</div>
78+
Use ASRFacet-Rb only on systems you own or have explicit written permission to test.
79+
</div>
80+
81+
<div class="sec-head">Download Workflow</div>
82+
<div class="install-grid">
83+
<article class="install-card">
84+
<div class="install-card-title">1. Download Script</div>
85+
<p>Pick your OS and download the installer script directly from this page.</p>
86+
<a class="install-card-link" href="#download-scripts">Open script downloads</a>
87+
</article>
88+
<article class="install-card">
89+
<div class="install-card-title">2. Run Install Mode</div>
90+
<p>Run <code>install</code> to place the framework in a managed application folder with launchers.</p>
91+
<a class="install-card-link" href="#download-usage">View usage commands</a>
92+
</article>
93+
<article class="install-card">
94+
<div class="install-card-title">3. Maintain Lifecycle</div>
95+
<p>Use the same script for <code>test</code>, <code>update</code>, and <code>uninstall</code> later.</p>
96+
<a class="install-card-link" href="#download-paths">Check install paths</a>
97+
</article>
98+
</div>
99+
</section>
100+
101+
<section id="download-scripts" class="page-section active">
102+
<div class="sec-head">Installer Scripts</div>
103+
<div class="prose">
104+
<p>These scripts are hosted in <code>docs/website/web_assets/installers/</code> and can be downloaded directly.</p>
105+
<p><a href="web_assets/installers/README.md" target="_blank">Open installer usage guide</a></p>
106+
</div>
107+
108+
<div class="tbl-wrap">
109+
<table>
110+
<thead><tr><th>Platform</th><th>Script</th><th>Download</th></tr></thead>
111+
<tbody>
112+
<tr>
113+
<td>Linux</td>
114+
<td><code>asrfacet-rb-installer-linux.sh</code></td>
115+
<td><a href="web_assets/installers/asrfacet-rb-installer-linux.sh" download>Download</a></td>
116+
</tr>
117+
<tr>
118+
<td>macOS</td>
119+
<td><code>asrfacet-rb-installer-macos.sh</code></td>
120+
<td><a href="web_assets/installers/asrfacet-rb-installer-macos.sh" download>Download</a></td>
121+
</tr>
122+
<tr>
123+
<td>Windows (PowerShell)</td>
124+
<td><code>asrfacet-rb-installer-windows.ps1</code></td>
125+
<td><a href="web_assets/installers/asrfacet-rb-installer-windows.ps1" download>Download</a></td>
126+
</tr>
127+
<tr>
128+
<td>Windows (CMD launcher)</td>
129+
<td><code>asrfacet-rb-installer-windows.cmd</code></td>
130+
<td><a href="web_assets/installers/asrfacet-rb-installer-windows.cmd" download>Download</a></td>
131+
</tr>
132+
</tbody>
133+
</table>
134+
</div>
135+
136+
<div class="code-wrap">
137+
<div class="code-header"><div class="code-dot"></div><div class="code-dot"></div><div class="code-dot"></div><span class="code-lang">run after download</span></div>
138+
<div class="code-body">
139+
<span class="cm"># Linux</span>
140+
<span class="pn">$</span> bash asrfacet-rb-installer-linux.sh <span class="kw">install</span>
141+
142+
<span class="cm"># macOS</span>
143+
<span class="pn">$</span> bash asrfacet-rb-installer-macos.sh <span class="kw">install</span>
144+
145+
<span class="cm"># Windows PowerShell</span>
146+
<span class="pn">PS&gt;</span> .\asrfacet-rb-installer-windows.ps1 <span class="kw">install</span>
147+
</div>
148+
</div>
149+
</section>
150+
151+
<section id="download-usage" class="page-section active">
152+
<div class="sec-head">Install and Lifecycle Modes</div>
153+
<div class="tbl-wrap">
154+
<table>
155+
<thead><tr><th>Mode</th><th>Purpose</th><th>Example</th></tr></thead>
156+
<tbody>
157+
<tr>
158+
<td><code>install</code></td>
159+
<td>Install ASRFacet-Rb as a managed application with PATH launchers.</td>
160+
<td><code>bash asrfacet-rb-installer-linux.sh install</code></td>
161+
</tr>
162+
<tr>
163+
<td><code>test</code></td>
164+
<td>Create a repository-local test install for smoke verification.</td>
165+
<td><code>bash asrfacet-rb-installer-macos.sh test</code></td>
166+
</tr>
167+
<tr>
168+
<td><code>update</code></td>
169+
<td>Refresh an existing managed installation from the repository.</td>
170+
<td><code>.\asrfacet-rb-installer-windows.ps1 update</code></td>
171+
</tr>
172+
<tr>
173+
<td><code>uninstall</code></td>
174+
<td>Remove installed launchers and the managed application directory.</td>
175+
<td><code>bash asrfacet-rb-installer-linux.sh uninstall</code></td>
176+
</tr>
177+
</tbody>
178+
</table>
179+
</div>
180+
181+
<div class="code-wrap">
182+
<div class="code-header"><div class="code-dot"></div><div class="code-dot"></div><div class="code-dot"></div><span class="code-lang">optional flags</span></div>
183+
<div class="code-body">
184+
<span class="cm"># non-interactive where possible</span>
185+
<span class="pn">$</span> bash asrfacet-rb-installer-linux.sh <span class="kw">install</span> <span class="fl">--yes</span>
186+
187+
<span class="cm"># verbose progress</span>
188+
<span class="pn">$</span> bash asrfacet-rb-installer-macos.sh <span class="kw">update</span> <span class="fl">--verbose</span>
189+
190+
<span class="cm"># keep temporary clone for troubleshooting</span>
191+
<span class="pn">PS&gt;</span> .\asrfacet-rb-installer-windows.ps1 <span class="kw">install</span> <span class="fl">-KeepTemp</span>
192+
</div>
193+
</div>
194+
</section>
195+
196+
<section id="download-paths" class="page-section active">
197+
<div class="sec-head">Install Paths and Data Storage</div>
198+
<div class="tbl-wrap">
199+
<table>
200+
<thead><tr><th>Platform</th><th>Application Root</th><th>Launchers / Alias</th><th>Data Root</th></tr></thead>
201+
<tbody>
202+
<tr>
203+
<td>Linux</td>
204+
<td><code>~/.local/share/asrfacet-rb</code></td>
205+
<td><code>~/.local/bin/asrfacet-rb</code>, <code>~/.local/bin/asrfrb</code></td>
206+
<td><code>~/.asrfacet_rb</code></td>
207+
</tr>
208+
<tr>
209+
<td>macOS</td>
210+
<td><code>~/Library/Application Support/asrfacet-rb</code></td>
211+
<td><code>~/.local/bin/asrfacet-rb</code>, <code>~/.local/bin/asrfrb</code></td>
212+
<td><code>~/.asrfacet_rb</code></td>
213+
</tr>
214+
<tr>
215+
<td>Windows</td>
216+
<td><code>%LOCALAPPDATA%\Programs\asrfacet-rb</code></td>
217+
<td><code>%USERPROFILE%\.local\bin\asrfacet-rb.cmd</code>, <code>...asrfrb.cmd</code></td>
218+
<td><code>%USERPROFILE%\.asrfacet_rb</code></td>
219+
</tr>
220+
</tbody>
221+
</table>
222+
</div>
223+
224+
<div class="callout callout-info">
225+
<div class="callout-title">Repo Install Is Still Available</div>
226+
You can always install from repository root with <code>bundle install</code> and run with <code>bundle exec ruby bin/asrfacet-rb</code> for development workflows.
227+
</div>
228+
</section>
229+
</main>
230+
231+
<footer id="site-footer">
232+
<div><div class="footer-col-title">Download Center</div><span class="footer-copy">Installers and lifecycle commands</span></div>
233+
<div><div class="footer-col-title">Install</div><a class="footer-link" href="#download-scripts">Scripts</a><a class="footer-link" href="#download-usage">Usage</a></div>
234+
<div><div class="footer-col-title">Docs</div><a class="footer-link" href="getting-started.html#install">Getting Started</a><a class="footer-link" href="workflow.html#pipeline">Workflow</a></div>
235+
<div><div class="footer-col-title">Project</div><a class="footer-link" href="project.html#author">Author &amp; License</a><a class="footer-link" href="https://github.com/voltsparx/ASRFacet-Rb" target="_blank">Repository</a></div>
236+
</footer>
237+
238+
<script src="app.js?v=1.0.0"></script>
239+
</body>
240+
</html>

‎docs/website/getting-started.html‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -88,7 +88,7 @@
8888
<article class="install-card">
8989
<div class="install-card-title">Website Download Installers</div>
9090
<p>Download standalone installers from the website that fetch required files and run lifecycle mode.</p>
91-
<a class="install-card-link" href="#web-installers">View website installer downloads</a>
91+
<a class="install-card-link" href="download.html#download-home">Open dedicated download center</a>
9292
</article>
9393
</div>
9494

@@ -142,6 +142,7 @@
142142

143143
<div id="web-installers" class="sec-head">Website Download Installers</div>
144144
<div class="prose">
145+
<p>Prefer using the dedicated <a href="download.html#download-home">Download Center</a> for the cleanest installer flow.</p>
145146
<p>If you are starting from the docs website directly, download one installer below. Each installer fetches only required framework files into a temporary folder (sparse checkout), keeps root <code>README.md</code> and <code>LICENSE</code>, includes only <code>docs/images</code> from docs, then runs the same maintained lifecycle scripts used by repository installs.</p>
146147
<p><a href="web_assets/installers/README.md" target="_blank">Open installer usage guide</a> for modes, flags, and troubleshooting notes.</p>
147148
</div>

‎docs/website/index.html‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -86,6 +86,7 @@
8686
</div>
8787
<div class="hero-cta-row">
8888
<a class="btn btn-primary" href="getting-started.html#install">▸ Start Here</a>
89+
<a class="btn btn-outline" href="download.html#download-home">Download Center</a>
8990
<a class="btn btn-outline" href="cli-reference.html#commands">$ CLI Reference</a>
9091
<a class="btn btn-outline" href="modes.html#web">Web Session</a>
9192
</div>
@@ -110,7 +111,7 @@
110111
<span class="stat-label">Output Formats</span>
111112
</div>
112113
<div class="stat-item">
113-
<span class="stat-num">7</span>
114+
<span class="stat-num">8</span>
114115
<span class="stat-label">Docs Pages</span>
115116
</div>
116117
</div>
@@ -128,6 +129,7 @@
128129
<a class="ov-card" href="cli-reference.html#commands"><div class="ov-icon">⌨️</div><div class="ov-name">CLI Reference</div><div class="ov-desc">See the main commands, global flags, syntax rules, and practical command layout.</div></a>
129130
<a class="ov-card" href="modes.html#web"><div class="ov-icon">🖥️</div><div class="ov-name">Modes</div><div class="ov-desc">Compare console mode, web session mode, wizard mode, lab mode, and example workflows.</div></a>
130131
<a class="ov-card" href="reporting.html#outputs"><div class="ov-icon">📊</div><div class="ov-name">Reporting</div><div class="ov-desc">Review output formats, storage layout, config overrides, and verification habits.</div></a>
132+
<a class="ov-card" href="download.html#download-home"><div class="ov-icon">⬇️</div><div class="ov-name">Download Center</div><div class="ov-desc">Download Linux, macOS, and Windows installers and run lifecycle modes from one page.</div></a>
131133
<a class="ov-card" href="project.html#author"><div class="ov-icon">📦</div><div class="ov-name">Project</div><div class="ov-desc">Check the repository links, licensing context, and maintainer details.</div></a>
132134
</div>
133135

@@ -153,6 +155,7 @@
153155
<div>
154156
<div class="footer-col-title">Start</div>
155157
<a class="footer-link" href="getting-started.html#install">Installation</a>
158+
<a class="footer-link" href="download.html#download-home">Download Center</a>
156159
<a class="footer-link" href="getting-started.html#quickstart">Quick Start</a>
157160
<a class="footer-link" href="workflow.html#pipeline">Pipeline</a>
158161
</div>

0 commit comments

Comments
 (0)