Skip to content

Commit 8140ca2

Browse files
voltsparxvoltsparx
committed
Fixations
1 parent 687222a commit 8140ca2

7 files changed

Lines changed: 90 additions & 7 deletions

File tree

‎docs/website/getting-started.html‎

Lines changed: 22 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,26 @@
7373
Ruby 3.2 or newer is required. Check with <code>ruby --version</code> and <code>bundle --version</code> before installing.
7474
</div>
7575

76-
<div class="sec-head">Development Install</div>
76+
<div class="sec-head">Installation Paths</div>
77+
<div class="install-grid">
78+
<article class="install-card">
79+
<div class="install-card-title">Repo Development</div>
80+
<p>Use this when developing ASRFacet-Rb locally and running full validation from source.</p>
81+
<a class="install-card-link" href="#install-dev">View development steps</a>
82+
</article>
83+
<article class="install-card">
84+
<div class="install-card-title">System Install Scripts</div>
85+
<p>Use platform scripts from the repo to install the framework as a real system tool with launchers.</p>
86+
<a class="install-card-link" href="#install-system">View system install commands</a>
87+
</article>
88+
<article class="install-card">
89+
<div class="install-card-title">Website Download Installers</div>
90+
<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>
92+
</article>
93+
</div>
94+
95+
<div id="install-dev" class="sec-head">Development Install</div>
7796
<div class="code-wrap">
7897
<div class="code-header"><div class="code-dot"></div><div class="code-dot"></div><div class="code-dot"></div><span class="code-lang">shell</span></div>
7998
<div class="code-body">
@@ -92,7 +111,7 @@
92111
</div>
93112
</div>
94113

95-
<div class="sec-head">System Installers</div>
114+
<div id="install-system" class="sec-head">System Installers</div>
96115
<div class="prose">
97116
<p>The installers build a real application folder, create launchers on your user PATH, and keep user data outside the app folder so reinstalling does not wipe reports or saved session state.</p>
98117
</div>
@@ -123,7 +142,7 @@
123142

124143
<div id="web-installers" class="sec-head">Website Download Installers</div>
125144
<div class="prose">
126-
<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), then runs the same maintained lifecycle scripts used by repository installs.</p>
145+
<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>
127146
<p><a href="web_assets/installers/README.md" target="_blank">Open installer usage guide</a> for modes, flags, and troubleshooting notes.</p>
128147
</div>
129148

‎docs/website/styles.css‎

Lines changed: 60 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -682,6 +682,58 @@ code {
682682
.prose ul li { margin-bottom: 6px; color: var(--txt2); }
683683
.prose ul li::marker { color: var(--r1); }
684684

685+
/* INSTALLATION MODULES */
686+
.install-grid {
687+
display: grid;
688+
grid-template-columns: repeat(3, minmax(0, 1fr));
689+
gap: 14px;
690+
margin-bottom: 26px;
691+
}
692+
.install-card {
693+
background: var(--bg2);
694+
border: 1px solid var(--border2);
695+
border-top: 2px solid var(--r2);
696+
padding: 18px 16px;
697+
transition: border-color 0.15s, transform 0.15s;
698+
}
699+
.install-card:hover {
700+
border-top-color: var(--r0);
701+
border-color: var(--border);
702+
transform: translateY(-2px);
703+
}
704+
.install-card-title {
705+
font-family: var(--display);
706+
font-size: 0.68rem;
707+
letter-spacing: 0.08em;
708+
text-transform: uppercase;
709+
color: var(--r0);
710+
margin-bottom: 8px;
711+
}
712+
.install-card p {
713+
color: var(--txt2);
714+
font-size: 13.5px;
715+
line-height: 1.6;
716+
margin-bottom: 12px;
717+
font-weight: 500;
718+
}
719+
.install-card-link {
720+
font-family: var(--mono);
721+
font-size: 0.66rem;
722+
color: var(--txt3);
723+
border: 1px solid var(--border2);
724+
padding: 4px 8px;
725+
display: inline-flex;
726+
align-items: center;
727+
letter-spacing: 0.06em;
728+
text-transform: uppercase;
729+
}
730+
.install-card-link:hover {
731+
color: var(--r0);
732+
border-color: var(--r1);
733+
background: rgba(255, 26, 26, 0.10);
734+
text-decoration: none;
735+
}
736+
685737
/* CALLOUT BOXES */
686738
.callout {
687739
padding: 16px 20px;
@@ -744,7 +796,13 @@ code {
744796
.code-body .fl { color: #ff6666; } /* flag */
745797
.code-body .ar { color: #ffb0b0; } /* arg */
746798
.code-body .st { color: #ffcc99; } /* string */
747-
.code-body .pn { color: var(--txt3); } /* prompt */
799+
.code-body .pn {
800+
color: var(--txt3);
801+
display: inline-block;
802+
width: 4ch;
803+
text-align: right;
804+
margin-right: 1ch;
805+
} /* prompt */
748806
.code-body .sc { color: #ff9090; } /* section */
749807
.code-body .hl { color: #ffffff; } /* highlight */
750808

@@ -1270,5 +1328,6 @@ tbody td code { white-space: nowrap; }
12701328
.src-grid,
12711329
.fmt-grid,
12721330
.stat-strip { grid-template-columns: 1fr; }
1331+
.install-grid { grid-template-columns: 1fr; }
12731332
#site-footer { grid-template-columns: 1fr; }
12741333
}

‎docs/website/web_assets/installers/README.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,9 @@ delegate to the maintained lifecycle scripts under `install/`:
1313

1414
To reduce bloat, website installers use sparse checkout and download only
1515
required runtime paths for the selected mode. `README.md` and `LICENSE` are
16-
included with the installed framework bundle.
16+
included with the installed framework bundle, and only `docs/images` is kept
17+
from the docs tree. During installation, nested `README.md` files are removed
18+
from subdirectories so only the root `README.md` remains.
1719

1820
## Files
1921

‎docs/website/web_assets/installers/asrfacet-rb-installer-linux.sh‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,7 @@ required_paths_for_mode() {
5656
"lib"
5757
"man"
5858
"wordlists"
59+
"docs/images"
5960
"Gemfile"
6061
"Gemfile.lock"
6162
"asrfacet-rb.gemspec"

‎docs/website/web_assets/installers/asrfacet-rb-installer-macos.sh‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,7 @@ required_paths_for_mode() {
5656
"lib"
5757
"man"
5858
"wordlists"
59+
"docs/images"
5960
"Gemfile"
6061
"Gemfile.lock"
6162
"asrfacet-rb.gemspec"

‎docs/website/web_assets/installers/asrfacet-rb-installer-windows.ps1‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -76,6 +76,7 @@ function Get-RequiredPaths {
7676
"lib",
7777
"man",
7878
"wordlists",
79+
"docs/images",
7980
"Gemfile",
8081
"Gemfile.lock",
8182
"asrfacet-rb.gemspec",

‎lib/asrfacet_rb/ui/console.rb‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -310,11 +310,11 @@ def console_explanation(topic)
310310
end
311311

312312
def prompt
313-
base = PROMPT_NAME.colorize(ASRFacet::Colors.terminal(:primary))
313+
base = "asrfrb".colorize(ASRFacet::Colors.terminal(:primary))
314314
arrow = ">".colorize(ASRFacet::Colors.terminal(:warning))
315315
"#{base} #{arrow} "
316316
rescue StandardError
317-
"asrfacet-rb > "
317+
"asrfrb > "
318318
end
319319

320320
def clear_screen

0 commit comments

Comments
 (0)