Gitea Actions
574 lines
19 KiB
HTML
574 lines
19 KiB
HTML
<!DOCTYPE html>
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
|
|
<head>
|
|
<meta charset="utf-8" />
|
|
<meta name="generator" content="pandoc" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
|
|
<meta name="author" content="Rootiest" />
|
|
<title>8. FISHER PLUGINS</title>
|
|
<style>
|
|
div.sitenav { display: flex; flex-direction: row; flex-wrap: wrap; }
|
|
span.navlink { flex: 1; }
|
|
span.navlink-label { display: inline-block; min-width: 4em; }
|
|
html {
|
|
color: #1a1a1a;
|
|
background-color: #fdfdfd;
|
|
}
|
|
body {
|
|
margin: 0 auto;
|
|
max-width: 36em;
|
|
padding-left: 50px;
|
|
padding-right: 50px;
|
|
padding-top: 50px;
|
|
padding-bottom: 50px;
|
|
hyphens: auto;
|
|
overflow-wrap: break-word;
|
|
text-rendering: optimizeLegibility;
|
|
font-kerning: normal;
|
|
}
|
|
@media (max-width: 600px) {
|
|
body {
|
|
font-size: 0.9em;
|
|
padding: 12px;
|
|
}
|
|
h1 {
|
|
font-size: 1.8em;
|
|
}
|
|
}
|
|
@media print {
|
|
html {
|
|
background-color: white;
|
|
}
|
|
body {
|
|
background-color: transparent;
|
|
color: black;
|
|
font-size: 12pt;
|
|
}
|
|
p, h2, h3 {
|
|
orphans: 3;
|
|
widows: 3;
|
|
}
|
|
h2, h3, h4 {
|
|
page-break-after: avoid;
|
|
}
|
|
}
|
|
p {
|
|
margin: 1em 0;
|
|
}
|
|
a {
|
|
color: #1a1a1a;
|
|
}
|
|
a:visited {
|
|
color: #1a1a1a;
|
|
}
|
|
img {
|
|
max-width: 100%;
|
|
}
|
|
h1, h2, h3, h4, h5, h6 {
|
|
margin-top: 1.4em;
|
|
}
|
|
h5, h6 {
|
|
font-size: 1em;
|
|
font-style: italic;
|
|
}
|
|
h6 {
|
|
font-weight: normal;
|
|
}
|
|
ol, ul {
|
|
padding-left: 1.7em;
|
|
margin-top: 1em;
|
|
}
|
|
li > ol, li > ul {
|
|
margin-top: 0;
|
|
}
|
|
blockquote {
|
|
margin: 1em 0 1em 1.7em;
|
|
padding-left: 1em;
|
|
border-left: 2px solid #e6e6e6;
|
|
color: #606060;
|
|
}
|
|
code {
|
|
font-family: Menlo, Monaco, Consolas, 'Lucida Console', monospace;
|
|
font-size: 85%;
|
|
margin: 0;
|
|
hyphens: manual;
|
|
}
|
|
pre {
|
|
margin: 1em 0;
|
|
overflow: auto;
|
|
}
|
|
pre code {
|
|
padding: 0;
|
|
overflow: visible;
|
|
overflow-wrap: normal;
|
|
}
|
|
.sourceCode {
|
|
background-color: transparent;
|
|
overflow: visible;
|
|
}
|
|
hr {
|
|
background-color: #1a1a1a;
|
|
border: none;
|
|
height: 1px;
|
|
margin: 1em 0;
|
|
}
|
|
table {
|
|
margin: 1em 0;
|
|
border-collapse: collapse;
|
|
width: 100%;
|
|
overflow-x: auto;
|
|
display: block;
|
|
font-variant-numeric: lining-nums tabular-nums;
|
|
}
|
|
table caption {
|
|
margin-bottom: 0.75em;
|
|
}
|
|
tbody {
|
|
margin-top: 0.5em;
|
|
border-top: 1px solid #1a1a1a;
|
|
border-bottom: 1px solid #1a1a1a;
|
|
}
|
|
th {
|
|
border-top: 1px solid #1a1a1a;
|
|
padding: 0.25em 0.5em 0.25em 0.5em;
|
|
}
|
|
td {
|
|
padding: 0.125em 0.5em 0.25em 0.5em;
|
|
}
|
|
header {
|
|
margin-bottom: 4em;
|
|
text-align: center;
|
|
}
|
|
#TOC li {
|
|
list-style: none;
|
|
}
|
|
#TOC ul {
|
|
padding-left: 1.3em;
|
|
}
|
|
#TOC > ul {
|
|
padding-left: 0;
|
|
}
|
|
#TOC a:not(:hover) {
|
|
text-decoration: none;
|
|
}
|
|
code{white-space: pre-wrap;}
|
|
span.smallcaps{font-variant: small-caps;}
|
|
div.columns{display: flex; gap: min(4vw, 1.5em);}
|
|
div.column{flex: auto; overflow-x: auto;}
|
|
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
|
|
/* The extra [class] is a hack that increases specificity enough to
|
|
override a similar rule in reveal.js */
|
|
ul.task-list[class]{list-style: none;}
|
|
ul.task-list li input[type="checkbox"] {
|
|
font-size: inherit;
|
|
width: 0.8em;
|
|
margin: 0 0.8em 0.2em -1.6em;
|
|
vertical-align: middle;
|
|
}
|
|
.display.math{display: block; text-align: center; margin: 0.5rem auto;}
|
|
</style>
|
|
<style>
|
|
/* ── Catppuccin Latte (light) / Mocha (dark) ─────────────────── */
|
|
:root {
|
|
color-scheme: light dark;
|
|
--bg: #eff1f5;
|
|
--surface: #e6e9ef;
|
|
--overlay: #ccd0da;
|
|
--text: #4c4f69;
|
|
--sub1: #6c6f85;
|
|
--sub0: #8c8fa1;
|
|
--blue: #1e66f5;
|
|
--lavender: #7287fd;
|
|
--sapphire: #209fb5;
|
|
--green: #40a02b;
|
|
--yellow: #df8e1d;
|
|
--peach: #fe640b;
|
|
--mauve: #8839ef;
|
|
--code-bg: #dce0e8;
|
|
--border: #bcc0cc;
|
|
--glow1: rgba(30, 102, 245, 0.05);
|
|
--glow2: rgba(136, 57, 239, 0.04);
|
|
}
|
|
|
|
@media (prefers-color-scheme: dark) {
|
|
:root {
|
|
--bg: #1e1e2e;
|
|
--surface: #313244;
|
|
--overlay: #45475a;
|
|
--text: #cdd6f4;
|
|
--sub1: #bac2de;
|
|
--sub0: #a6adc8;
|
|
--blue: #89b4fa;
|
|
--lavender: #b4befe;
|
|
--sapphire: #74c7ec;
|
|
--green: #a6e3a1;
|
|
--yellow: #f9e2af;
|
|
--peach: #fab387;
|
|
--mauve: #cba6f7;
|
|
--code-bg: #181825;
|
|
--border: #45475a;
|
|
--glow1: rgba(137, 180, 250, 0.06);
|
|
--glow2: rgba(203, 166, 247, 0.05);
|
|
}
|
|
}
|
|
|
|
*, *::before, *::after { box-sizing: border-box; }
|
|
|
|
html {
|
|
background-color: var(--bg);
|
|
background-image:
|
|
radial-gradient(ellipse 55% 40% at 10% 5%, var(--glow1) 0%, transparent 100%),
|
|
radial-gradient(ellipse 45% 45% at 90% 95%, var(--glow2) 0%, transparent 100%);
|
|
min-height: 100%;
|
|
}
|
|
|
|
body {
|
|
color: var(--text);
|
|
font-family: system-ui, -apple-system, "Segoe UI", Helvetica, sans-serif;
|
|
font-size: 16px;
|
|
line-height: 1.75;
|
|
max-width: 880px;
|
|
margin: 0 auto;
|
|
padding: 2rem 2.5rem 5rem;
|
|
min-height: 100vh;
|
|
}
|
|
|
|
/* ── Links ─────────────────────────────────────────────────── */
|
|
a { color: var(--blue); text-decoration: none; }
|
|
a:hover { color: var(--lavender); text-decoration: underline; }
|
|
a:visited { color: var(--lavender); }
|
|
|
|
/* ── Headings ──────────────────────────────────────────────── */
|
|
h1, h2, h3, h4, h5, h6 {
|
|
font-family: "JetBrains Mono", "Fira Code", ui-monospace, monospace;
|
|
color: var(--lavender);
|
|
line-height: 1.3;
|
|
margin-top: 2em;
|
|
margin-bottom: 0.5em;
|
|
}
|
|
h1 {
|
|
font-size: 1.9rem;
|
|
color: var(--text);
|
|
border-bottom: 1px solid var(--border);
|
|
padding-bottom: 0.4em;
|
|
margin-top: 1.2em;
|
|
}
|
|
h2 {
|
|
font-size: 1.35rem;
|
|
border-bottom: 1px solid var(--border);
|
|
padding-bottom: 0.2em;
|
|
}
|
|
h3 { font-size: 1.1rem; color: var(--sapphire); }
|
|
h4 { font-size: 0.95rem; color: var(--sub1); }
|
|
|
|
p { margin: 0.8em 0; }
|
|
|
|
/* ── Title block (pandoc-generated cover) ──────────────────── */
|
|
#title-block-header {
|
|
text-align: center;
|
|
padding: 2.5rem 0 2rem;
|
|
margin-bottom: 1.5rem;
|
|
border-bottom: 1px solid var(--border);
|
|
}
|
|
#title-block-header .title {
|
|
font-family: "JetBrains Mono", "Fira Code", ui-monospace, monospace;
|
|
font-size: 2.6rem;
|
|
letter-spacing: 0.12em;
|
|
color: var(--lavender);
|
|
border: none;
|
|
margin: 0 0 0.75rem;
|
|
}
|
|
#title-block-header .author,
|
|
#title-block-header .date {
|
|
color: var(--sub0);
|
|
font-size: 0.875rem;
|
|
margin: 0.2rem 0;
|
|
}
|
|
|
|
/* ── Inline code ───────────────────────────────────────────── */
|
|
code {
|
|
font-family: "JetBrains Mono", "Fira Code", ui-monospace, monospace;
|
|
background: var(--code-bg);
|
|
color: var(--peach);
|
|
padding: 0.15em 0.4em;
|
|
border-radius: 4px;
|
|
font-size: 0.875em;
|
|
}
|
|
|
|
/* ── Code blocks ───────────────────────────────────────────── */
|
|
pre {
|
|
background: var(--code-bg);
|
|
border: 1px solid var(--border);
|
|
border-left: 3px solid var(--sapphire);
|
|
border-radius: 0 8px 8px 0;
|
|
padding: 1.1em 1.4em;
|
|
overflow-x: auto;
|
|
line-height: 1.55;
|
|
margin: 1.2em 0;
|
|
}
|
|
pre code {
|
|
background: none;
|
|
color: var(--text);
|
|
padding: 0;
|
|
font-size: 0.88em;
|
|
}
|
|
|
|
/* ── Blockquotes ───────────────────────────────────────────── */
|
|
blockquote {
|
|
border-left: 3px solid var(--yellow);
|
|
margin: 1.5em 0;
|
|
padding: 0.75em 1.25em;
|
|
background: var(--surface);
|
|
color: var(--sub1);
|
|
border-radius: 0 6px 6px 0;
|
|
}
|
|
blockquote p { margin: 0.3em 0; }
|
|
|
|
/* ── Tables ────────────────────────────────────────────────── */
|
|
table {
|
|
border-collapse: collapse;
|
|
width: 100%;
|
|
margin: 1.4em 0;
|
|
font-size: 0.93em;
|
|
}
|
|
th, td {
|
|
border: 1px solid var(--border);
|
|
padding: 0.55em 0.9em;
|
|
text-align: left;
|
|
}
|
|
th {
|
|
background: var(--surface);
|
|
color: var(--lavender);
|
|
font-weight: 600;
|
|
font-family: "JetBrains Mono", "Fira Code", ui-monospace, monospace;
|
|
font-size: 0.82em;
|
|
letter-spacing: 0.06em;
|
|
text-transform: uppercase;
|
|
}
|
|
tr:nth-child(even) { background: var(--surface); }
|
|
tr:hover { background: var(--overlay); }
|
|
|
|
/* ── HR ────────────────────────────────────────────────────── */
|
|
hr { border: none; border-top: 1px solid var(--border); margin: 2.5em 0; }
|
|
|
|
/* ── Lists ─────────────────────────────────────────────────── */
|
|
ul, ol { padding-left: 1.6em; }
|
|
li { margin: 0.35em 0; }
|
|
|
|
/* ── Chunk navigation bar (prev / up / next) ───────────────── */
|
|
nav:not(#TOC):not([role="doc-toc"]) {
|
|
background: var(--surface);
|
|
border: 1px solid var(--border);
|
|
border-radius: 8px;
|
|
margin: 1.5em 0;
|
|
font-size: 0.875em;
|
|
overflow: hidden;
|
|
}
|
|
nav:not(#TOC):not([role="doc-toc"]) p {
|
|
margin: 0;
|
|
padding: 0.65em 1.2em;
|
|
display: flex;
|
|
gap: 0.4em 1.75em;
|
|
flex-wrap: wrap;
|
|
align-items: center;
|
|
}
|
|
/* JS wraps each "Label: <a>" pair in .nav-item so they flex as a unit */
|
|
.nav-item {
|
|
display: inline-flex;
|
|
align-items: center;
|
|
gap: 0.3em;
|
|
white-space: nowrap;
|
|
}
|
|
.nav-item a { color: var(--blue); }
|
|
.nav-item a:hover { color: var(--lavender); }
|
|
|
|
/* ── Table of contents panel ───────────────────────────────── */
|
|
nav#TOC, nav[role="doc-toc"] {
|
|
display: block;
|
|
background: var(--surface);
|
|
border: 1px solid var(--border);
|
|
border-left: 3px solid var(--lavender);
|
|
border-radius: 0 8px 8px 0;
|
|
padding: 1.2em 1.5em;
|
|
margin: 1.5em 0;
|
|
}
|
|
nav#TOC > h2,
|
|
nav[role="doc-toc"] > h2 {
|
|
font-size: 0.7rem;
|
|
letter-spacing: 0.14em;
|
|
text-transform: uppercase;
|
|
color: var(--sub0);
|
|
border: none;
|
|
margin: 0 0 0.9em;
|
|
padding: 0;
|
|
}
|
|
nav#TOC ul, nav[role="doc-toc"] ul {
|
|
list-style: none;
|
|
padding-left: 1em;
|
|
margin: 0.25em 0;
|
|
}
|
|
nav#TOC > ul, nav[role="doc-toc"] > ul { padding-left: 0; }
|
|
nav#TOC li, nav[role="doc-toc"] li {
|
|
margin: 0.3em 0;
|
|
padding-left: 0.75em;
|
|
border-left: 1px solid transparent;
|
|
transition: border-color 0.12s;
|
|
}
|
|
nav#TOC li:hover, nav[role="doc-toc"] li:hover {
|
|
border-left-color: var(--lavender);
|
|
}
|
|
nav#TOC a, nav[role="doc-toc"] a {
|
|
color: var(--sub1);
|
|
font-size: 0.9em;
|
|
}
|
|
nav#TOC a:hover, nav[role="doc-toc"] a:hover {
|
|
color: var(--lavender);
|
|
text-decoration: none;
|
|
}
|
|
</style>
|
|
<script>
|
|
document.addEventListener('DOMContentLoaded', function () {
|
|
/* ── Hide ToC on every page except index.html ───────────── */
|
|
var path = location.pathname;
|
|
var onIndex = path === '/' || path === '' || /\/index\.html(\?.*)?$/.test(path);
|
|
if (!onIndex) {
|
|
var toc = document.getElementById('TOC') ||
|
|
document.querySelector('[role="doc-toc"]');
|
|
if (toc) toc.remove();
|
|
}
|
|
|
|
/* ── Wrap each "Label: <a>" pair in a .nav-item span ───────
|
|
Pandoc emits label text nodes and anchors as siblings;
|
|
flex sees them as separate items, causing labels to split
|
|
from their links when wrapping. Grouping them in a span
|
|
keeps each label+link as a single flex unit. */
|
|
document.querySelectorAll('nav:not(#TOC):not([role="doc-toc"])').forEach(function (nav) {
|
|
var p = nav.querySelector('p');
|
|
if (!p) return;
|
|
var children = Array.from(p.childNodes);
|
|
var pairs = [];
|
|
for (var i = 0; i + 1 < children.length; i++) {
|
|
var cur = children[i];
|
|
var nxt = children[i + 1];
|
|
if (cur.nodeType === Node.TEXT_NODE &&
|
|
/[A-Z][a-z]*:\s*/.test(cur.textContent) &&
|
|
nxt.nodeType === Node.ELEMENT_NODE &&
|
|
nxt.tagName === 'A') {
|
|
pairs.push([cur, nxt]);
|
|
i++; // skip the anchor on the next iteration
|
|
}
|
|
}
|
|
pairs.forEach(function (pair) {
|
|
var span = document.createElement('span');
|
|
span.className = 'nav-item';
|
|
p.insertBefore(span, pair[0]);
|
|
span.appendChild(pair[0]);
|
|
span.appendChild(pair[1]);
|
|
});
|
|
});
|
|
});
|
|
</script>
|
|
</head>
|
|
<body>
|
|
<nav id="sitenav">
|
|
<div class="sitenav">
|
|
<span class="navlink">
|
|
<span class="navlink-label">Up:</span> <a href="index.html" accesskey="u" rel="up">FISH-CONFIG</a>
|
|
</span>
|
|
<span class="navlink">
|
|
<span class="navlink-label">Top:</span> <a href="index.html" accesskey="t" rel="top">FISH-CONFIG</a>
|
|
</span>
|
|
</div>
|
|
<div class="sitenav">
|
|
<span class="navlink">
|
|
<span class="navlink-label">Next:</span> <a href="13-9-installation.html" accesskey="n" rel="next">9. INSTALLATION</a>
|
|
</span>
|
|
<span class="navlink">
|
|
<span class="navlink-label">Previous:</span> <a href="11-7-customization.html" accesskey="p" rel="previous">7. CUSTOMIZATION</a>
|
|
</span>
|
|
</div>
|
|
</nav>
|
|
<h1 data-number="12" id="8-fisher-plugins">8. FISHER PLUGINS</h1>
|
|
<p>Fisher is bootstrapped automatically on the <strong>first interactive
|
|
session</strong> via <code>conf.d/first_run.fish</code>. This also
|
|
applies the Catppuccin Mocha theme and prints a one-time welcome message
|
|
(gated by __fish_config_op_greeting; set it to 0 to suppress).
|
|
Subsequent sessions skip all first-run logic with zero overhead.</p>
|
|
<p>To re-trigger first-run initialization (e.g., after a fresh install
|
|
or for testing), run:</p>
|
|
<pre><code>set -Ue __fish_config_first_run_complete</code></pre>
|
|
<p>Then open a new shell.</p>
|
|
<h2 data-number="12.1" id="fisher-managed-plugins">Fisher-Managed
|
|
Plugins</h2>
|
|
<p>The following plugins are fully managed by Fisher. Their files are
|
|
installed into the repo directory by Fisher and are listed in
|
|
<code>.gitignore</code> — do not commit them. Fisher installs and
|
|
updates them automatically.</p>
|
|
<pre><code>jorgebucaran/fisher Plugin manager itself
|
|
meaningful-ooo/sponge Remove failed commands from history</code></pre>
|
|
<h2 data-number="12.2" id="sponge-history-filtering">Sponge History
|
|
Filtering</h2>
|
|
<p>Sponge removes failed commands from history and, via
|
|
conf.d/sponge_privacy.fish, also filters privacy-sensitive commands
|
|
through three layers:</p>
|
|
<p>Layer 1 — Static patterns (universal, persistent across sessions):
|
|
Commands matching any of these structural signatures are never
|
|
recorded:</p>
|
|
<pre><code>--password / --token / --passphrase / --api-key flags with values
|
|
Inline env assignments: GITHUB_TOKEN=xxx, MY_API_KEY=abc
|
|
Fish set with sensitive names: set -gx GITHUB_TOKEN xxx
|
|
URLs with embedded credentials: https://user:pass@host
|
|
HTTP Authorization headers: curl -H "Authorization: ..."
|
|
Basic auth flags: curl -u user:pass
|
|
sshpass, docker login -p, openssl -passin/-passout</code></pre>
|
|
<p>Layer 2 — Dynamic secret values (session globals, refreshed each
|
|
login): On the first prompt, after secrets.fish has loaded, the literal
|
|
values of all exported variables whose names suggest credentials (TOKEN,
|
|
PASSWORD, SECRET, API_KEY, etc.) are collected, regex-escaped, and added
|
|
as a session-scoped overlay. Because globals shadow universals in Fish,
|
|
the combined list is what sponge sees. Rotating a token takes effect on
|
|
the next login automatically.</p>
|
|
<p>Layer 3 — Per-command filter (sponge_filter_secrets): Catches
|
|
credentials in variables exported after login, such as tokens sourced
|
|
from a project .env file mid-session.</p>
|
|
<p>To add your own persistent patterns:</p>
|
|
<pre><code>set -U -a sponge_regex_patterns 'your-regex-here'</code></pre>
|
|
<p>To mark additional variable NAMES as credential-bearing (so Layer 2
|
|
scrubs their values), add name tokens — via <code>config-settings</code>
|
|
→ Sponge, or directly:</p>
|
|
<pre><code>set -U -a __fish_sponge_extra_sensitive ACME_API VAULT_PW</code></pre>
|
|
<p>Tokens are folded into the Layer 2 name match case-insensitively as
|
|
substrings, so ACME_API also covers ACME_API_KEY. (The match uses
|
|
<code>--entire</code> to return the full variable name, so partial-name
|
|
tokens dereference the right value.)</p>
|
|
<p>The <code>config-settings</code> Sponge page also surfaces sponge's
|
|
own tuning variables — sponge_delay, sponge_successful_exit_codes,
|
|
sponge_purge_only_on_exit, and sponge_allow_previously_successful — so
|
|
they can be changed without typing variable names.</p>
|
|
<h2 data-number="12.3" id="bundled-plugin-functionality">Bundled Plugin
|
|
Functionality</h2>
|
|
<p>The remaining plugin functionality is bundled directly with this
|
|
config rather than managed through Fisher. The bundled versions include
|
|
customizations for Fish 4.x compatibility and improved behavior that
|
|
differ from their upstream releases. Installing them through Fisher
|
|
would overwrite these customizations.</p>
|
|
<p>Bundled components and their upstream origins:</p>
|
|
<pre><code>catppuccin/fish → themes/ + conf.d/theme.fish
|
|
PatrickF1/fzf.fish → functions/_fzf_*.fish + conf.d/fzf.fish
|
|
franciscolourenco/done → conf.d/done.fish
|
|
jorgebucaran/autopair.fish → functions/_autopair_*.fish + conf.d/autopair.fish
|
|
nickeb96/puffer-fish → functions/_puffer_fish_*.fish + conf.d/puffer.fish</code></pre>
|
|
<p>Do not run <code>fisher install</code> for these — it will overwrite
|
|
the customized versions. To update their behavior, edit the relevant
|
|
bundled files directly.</p>
|
|
<h2 data-number="12.4" id="fish_plugins-manifest">fish_plugins
|
|
Manifest</h2>
|
|
<p>The <code>fish_plugins</code> file at the config root:</p>
|
|
<pre><code>jorgebucaran/fisher Plugin manager itself
|
|
meaningful-ooo/sponge Remove failed commands from history</code></pre>
|
|
<p>To update all Fisher-managed plugins, run <code>fisher update</code>
|
|
or <code>fish-deps update</code> which calls it as its first step.</p>
|
|
<hr />
|
|
</body>
|
|
</html>
|