diff --git a/docs.html b/docs.html index 4c7b4c0..000493d 100644 --- a/docs.html +++ b/docs.html @@ -3,7 +3,7 @@ - man ssh — keshavanand.net + Documentation - Terminal Portfolio @@ -15,8 +15,8 @@ $ cd ..
-

man ssh

-

portfolio(1)·keshavanand.net·v1

+

Documentation

+

The who, what, when, where, why

@@ -31,79 +31,71 @@
-

# name

+

# What is it?

- A keystroke-driven portfolio. The command above opens a real SSH session into a restricted, passwordless - account on a homeserver and drops you into a custom C++/FTXUI interface. No web app, no JS, no installer — just the shell you already have. + When executed in your terminal, this command renders a fully interactive shell portfolio experience. + Much like a digital resume or personal site, it allows you to explore my work and background through + a safe, secure, and purely text-based interface. + It is completely harmless to your system.

-

# synopsis

- 
$ ssh portfolio@keshavanand.net
-
- -
-

# arguments

+

# Command Breakdown

-
ssh
-
secure shell — the standard remote-login protocol. ubiquitous on macOS, linux, and modern windows.
+
ssh →
+
Secure Shell: The standard terminal protocol for logging into and controlling remote computers safely.
-
portfolio
-
a passwordless, restricted user account. the only thing it can do is launch the portfolio binary.
+
portfolio →
+
User: A passwordless, restricted user on my homeserver meant for public access.
-
keshavanand.net
-
resolves to my homeserver's public IP. the gateway forwards port 22 to the box.
+
keshavanand.net →
+
Domain: Points to a web record that directs your request to my server's public IP (gateway).
-

# usage

+

# How to Run

    -
  1. 01 copy the command above (click the box, or the icon).
    2. -
  2. 02 open your terminal — Terminal, iTerm, Alacritty, Windows Terminal, anything.
    3. -
  3. 03 paste, hit return. accept the host fingerprint with yes on first connect.
    4. -
  4. 04 navigate with arrow keys + return. quit any time with Ctrl+C.
    5. +
  5. 01 Copy the command above using the clipboard tool.
    6. +
  6. 02 Open your native terminal (Terminal on Mac/Linux, PowerShell on Windows).
    7. +
  7. 03 Paste the command and accept the host identity by typing 'yes' if prompted.
    8. +
  8. 04 Press Enter to launch the interactive environment.
    9. +
  9. 05 Terminate the process at any time by pressing Ctrl+C.
-

# implementation

+

# Code Logic

- The portfolio user's login shell isn't bash — it's a custom C++ binary that uses - FTXUI - for layout, focus management, and rendering. Input is captured raw, output is repainted on a frame loop. - It is sandboxed, read-only, and harmless to your machine. + This command gives authenticated access to the 'portfolio' user account on my private home server. +

+

+ Instead of a standard bash or zsh shell, the user session triggers a custom-coded C++ executable. + This binary utilizes FTXUI—a sophisticated functional terminal user interface library—to handle + real-time rendering and input.

-

# see also

+

# Resources

- -
// vibe coded to present human code
diff --git a/src/docs.css b/src/docs.css index fac1c8b..3466813 100644 --- a/src/docs.css +++ b/src/docs.css @@ -73,24 +73,17 @@ body.docs { } h1 { - font-size: 1.65rem; - font-weight: 500; - letter-spacing: 0.01em; + font-size: 2.2rem; + font-weight: 600; + letter-spacing: 0.005em; color: var(--fg); } -h1 .accent { color: var(--accent); } - .sub { - margin-top: 0.45rem; + margin-top: 0.5rem; color: var(--dim); - font-size: 0.78rem; - letter-spacing: 0.04em; -} - -.sub .dot { - margin: 0 0.55rem; - color: var(--dimmer); + font-size: 0.95rem; + letter-spacing: 0.01em; } .rule { @@ -166,12 +159,11 @@ h1 .accent { color: var(--accent); } } h2 { - font-size: 0.85rem; + font-size: 1.05rem; font-weight: 500; color: var(--fg); - letter-spacing: 0.04em; - text-transform: lowercase; - margin-bottom: 0.85rem; + letter-spacing: 0.005em; + margin-bottom: 1rem; } h2 .hash { @@ -225,14 +217,19 @@ h2 .hash { } .def:last-child { border-bottom: none; } .def dt { - font-size: 0.85rem; + font-size: 0.92rem; font-weight: 500; + display: inline-flex; + align-items: baseline; + gap: 0.5rem; } +.def dt .arrow { color: var(--dim); } .def dd { color: var(--dim); - font-size: 0.85rem; + font-size: 0.9rem; line-height: 1.7; } +.def dd .fg { color: var(--fg); font-weight: 500; } /* steps — numbered, monospace numerals */ .steps { @@ -287,19 +284,6 @@ kbd { } .links .arrow { color: var(--accent); } -/* footer — quiet, like a man-page footer */ -.foot { - margin-top: 4rem; - padding-top: 1.2rem; - border-top: 1px solid var(--line); - color: var(--dimmer); - font-size: 0.7rem; - letter-spacing: 0.04em; -} -.foot .dot { - margin: 0 0.5rem; -} - /* whisper-quiet byline, identical to home */ .byline { position: fixed;