576 lines
16 KiB
HTML
576 lines
16 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<title>Editors — M-Archy Dotfiles</title>
|
|
<style>
|
|
/* ── CyberQueer Theme ──────────────────────────────────────────────── */
|
|
:root {
|
|
--bg: #1A1A1A;
|
|
--bg2: #242424;
|
|
--bg3: #2e2e2e;
|
|
--text: #D6ABAB;
|
|
--accent: #E40046;
|
|
--violet: #5018DD;
|
|
--danger: #F50505;
|
|
--border: #5018DD;
|
|
--radius: 10px;
|
|
--radius-sm: 5px;
|
|
}
|
|
|
|
/* ── Reset & Base ──────────────────────────────────────────────────── */
|
|
*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
|
|
|
|
html { scroll-behavior: smooth; }
|
|
|
|
body {
|
|
background-color: var(--bg);
|
|
color: var(--text);
|
|
font-family: 'Agave Nerd Font Mono', 'JetBrains Mono', 'Fira Code',
|
|
'Cascadia Code', 'Source Code Pro', monospace;
|
|
font-size: 15px;
|
|
line-height: 1.75;
|
|
max-width: 960px;
|
|
margin: 0 auto;
|
|
padding: 2.5rem 2rem 5rem;
|
|
}
|
|
|
|
/* ── Typography ────────────────────────────────────────────────────── */
|
|
h1, h2, h3, h4, h5, h6 {
|
|
font-family: 'Agave Nerd Font Mono', monospace;
|
|
font-weight: 700;
|
|
line-height: 1.25;
|
|
margin-top: 2.2rem;
|
|
margin-bottom: 0.6rem;
|
|
}
|
|
|
|
h1 {
|
|
color: var(--accent);
|
|
font-size: 2.2rem;
|
|
border-bottom: 3px solid var(--accent);
|
|
padding-bottom: 0.4rem;
|
|
margin-top: 0;
|
|
}
|
|
|
|
h2 {
|
|
color: var(--accent);
|
|
font-size: 1.55rem;
|
|
border-bottom: 2px solid var(--violet);
|
|
padding-bottom: 0.3rem;
|
|
}
|
|
|
|
h3 {
|
|
color: var(--violet);
|
|
font-size: 1.2rem;
|
|
}
|
|
|
|
h4, h5, h6 {
|
|
color: var(--text);
|
|
font-size: 1rem;
|
|
}
|
|
|
|
p {
|
|
margin: 0.9rem 0;
|
|
}
|
|
|
|
strong { color: var(--accent); font-weight: 700; }
|
|
em { color: var(--violet); font-style: italic; }
|
|
|
|
/* ── Links ─────────────────────────────────────────────────────────── */
|
|
a {
|
|
color: var(--violet);
|
|
text-decoration: none;
|
|
border-bottom: 1px solid transparent;
|
|
transition: color 0.15s, border-color 0.15s;
|
|
}
|
|
|
|
a:hover {
|
|
color: var(--accent);
|
|
border-bottom-color: var(--accent);
|
|
}
|
|
|
|
/* ── Code ──────────────────────────────────────────────────────────── */
|
|
code {
|
|
font-family: inherit;
|
|
background: var(--bg2);
|
|
color: var(--violet);
|
|
border: 1px solid var(--violet);
|
|
border-radius: var(--radius-sm);
|
|
padding: 0.1em 0.42em;
|
|
font-size: 0.9em;
|
|
}
|
|
|
|
pre {
|
|
background: var(--bg2);
|
|
border: 2px solid var(--violet);
|
|
border-radius: var(--radius);
|
|
padding: 1.2rem 1.4rem;
|
|
overflow-x: auto;
|
|
margin: 1.2rem 0;
|
|
position: relative;
|
|
}
|
|
|
|
pre code {
|
|
background: transparent;
|
|
border: none;
|
|
padding: 0;
|
|
color: var(--text);
|
|
font-size: 0.875em;
|
|
line-height: 1.6;
|
|
}
|
|
|
|
/* Syntax-like token colouring (no JS required — structural only) */
|
|
pre code .kw { color: var(--accent); }
|
|
pre code .str { color: var(--violet); }
|
|
pre code .cm { color: #666; font-style: italic; }
|
|
|
|
/* ── Horizontal Rule ───────────────────────────────────────────────── */
|
|
hr {
|
|
border: none;
|
|
border-top: 2px solid var(--violet);
|
|
margin: 2rem 0;
|
|
opacity: 0.45;
|
|
}
|
|
|
|
/* ── Blockquote ────────────────────────────────────────────────────── */
|
|
blockquote {
|
|
border-left: 4px solid var(--accent);
|
|
background: var(--bg2);
|
|
margin: 1.2rem 0;
|
|
padding: 0.8rem 1.2rem;
|
|
border-radius: 0 var(--radius) var(--radius) 0;
|
|
color: var(--text);
|
|
opacity: 0.9;
|
|
}
|
|
|
|
blockquote p { margin: 0; }
|
|
|
|
/* ── Tables ────────────────────────────────────────────────────────── */
|
|
table {
|
|
width: 100%;
|
|
border-collapse: collapse;
|
|
border: 2px solid var(--border);
|
|
border-radius: var(--radius);
|
|
overflow: hidden;
|
|
margin: 1.2rem 0;
|
|
font-size: 0.9em;
|
|
}
|
|
|
|
th {
|
|
background: var(--violet);
|
|
color: var(--bg);
|
|
text-align: left;
|
|
padding: 0.55rem 0.9rem;
|
|
font-weight: 700;
|
|
letter-spacing: 0.03em;
|
|
}
|
|
|
|
td {
|
|
padding: 0.5rem 0.9rem;
|
|
border-top: 1px solid var(--bg3);
|
|
vertical-align: top;
|
|
}
|
|
|
|
tr:nth-child(even) td { background: var(--bg2); }
|
|
tr:hover td { background: var(--bg3); }
|
|
|
|
/* ── Lists ─────────────────────────────────────────────────────────── */
|
|
ul, ol {
|
|
padding-left: 1.6rem;
|
|
margin: 0.7rem 0;
|
|
}
|
|
|
|
li { margin: 0.25rem 0; }
|
|
|
|
ul li::marker { color: var(--accent); }
|
|
ol li::marker { color: var(--violet); font-weight: 700; }
|
|
|
|
/* ── Nav sidebar (index page) ──────────────────────────────────────── */
|
|
nav ul {
|
|
list-style: none;
|
|
padding: 0;
|
|
}
|
|
|
|
nav li { margin: 0.3rem 0; }
|
|
|
|
/* ── Page Header Bar ───────────────────────────────────────────────── */
|
|
.page-header {
|
|
border-bottom: 3px solid var(--accent);
|
|
padding-bottom: 0.6rem;
|
|
margin-bottom: 2rem;
|
|
display: flex;
|
|
align-items: baseline;
|
|
gap: 1rem;
|
|
}
|
|
|
|
.page-header .site-title {
|
|
color: var(--accent);
|
|
font-size: 0.85rem;
|
|
opacity: 0.75;
|
|
white-space: nowrap;
|
|
}
|
|
|
|
/* ── Back link ─────────────────────────────────────────────────────── */
|
|
.back-link {
|
|
display: inline-block;
|
|
color: var(--violet);
|
|
font-size: 0.85rem;
|
|
margin-bottom: 1.5rem;
|
|
padding: 0.25rem 0.75rem;
|
|
border: 1px solid var(--violet);
|
|
border-radius: 30px;
|
|
transition: background 0.15s, color 0.15s;
|
|
}
|
|
|
|
.back-link:hover {
|
|
background: var(--violet);
|
|
color: var(--bg);
|
|
border-bottom-color: transparent;
|
|
}
|
|
|
|
/* ── Footer ────────────────────────────────────────────────────────── */
|
|
footer {
|
|
margin-top: 4rem;
|
|
padding-top: 1rem;
|
|
border-top: 1px solid var(--bg3);
|
|
color: var(--text);
|
|
opacity: 0.4;
|
|
font-size: 0.8rem;
|
|
text-align: center;
|
|
}
|
|
|
|
/* ── Responsive ────────────────────────────────────────────────────── */
|
|
@media (max-width: 680px) {
|
|
body { padding: 1.2rem 1rem 3rem; font-size: 14px; }
|
|
h1 { font-size: 1.7rem; }
|
|
h2 { font-size: 1.3rem; }
|
|
table { display: block; overflow-x: auto; }
|
|
}
|
|
|
|
/* ── Selection ─────────────────────────────────────────────────────── */
|
|
::selection {
|
|
background: var(--accent);
|
|
color: var(--bg);
|
|
}
|
|
|
|
/* ── Scrollbar ─────────────────────────────────────────────────────── */
|
|
::-webkit-scrollbar { width: 8px; height: 8px; }
|
|
::-webkit-scrollbar-track { background: var(--bg2); }
|
|
::-webkit-scrollbar-thumb { background: var(--violet); border-radius: 4px; }
|
|
::-webkit-scrollbar-thumb:hover { background: var(--accent); }
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<header class="page-header">
|
|
<span class="site-title">M-Archy Dotfiles</span>
|
|
</header>
|
|
<a class="back-link" href="index.html">← Index</a>
|
|
<main>
|
|
<h1 id="editors">Editors<a class="toc-anchor" href="#editors" title="Permanent link">¶</a></h1>
|
|
<p>Three editors are configured and deployed by the <code>shell</code> component: Neovim (primary), Micro (lightweight), and Yazi (terminal file manager).</p>
|
|
<hr />
|
|
<h2 id="neovim">Neovim<a class="toc-anchor" href="#neovim" title="Permanent link">¶</a></h2>
|
|
<p>Config lives in <code>nvim/</code>. Deployed to <code>~/.config/nvim/</code> during <code>shell</code> module install.</p>
|
|
<h3 id="plugin-manager">Plugin Manager<a class="toc-anchor" href="#plugin-manager" title="Permanent link">¶</a></h3>
|
|
<p><a href="https://github.com/junegunn/vim-plug">vim-plug</a> is auto-installed on first launch. Run <code>:PlugInstall</code> after the first start to fetch all plugins.</p>
|
|
<h3 id="plugins">Plugins<a class="toc-anchor" href="#plugins" title="Permanent link">¶</a></h3>
|
|
<h4 id="language-completion">Language & Completion<a class="toc-anchor" href="#language-completion" title="Permanent link">¶</a></h4>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Plugin</th>
|
|
<th>Purpose</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><code>neoclide/coc.nvim</code></td>
|
|
<td>LSP client, auto-completion, diagnostics</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>rust-lang/rust.vim</code></td>
|
|
<td>Rust filetype support</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>nvim-telescope/telescope.nvim</code></td>
|
|
<td>Fuzzy finder (files, grep, LSP symbols)</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<h4 id="ui">UI<a class="toc-anchor" href="#ui" title="Permanent link">¶</a></h4>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Plugin</th>
|
|
<th>Purpose</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><code>vim-airline/vim-airline</code></td>
|
|
<td>Status bar</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>vim-airline/vim-airline-themes</code></td>
|
|
<td>Airline theme collection</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>junegunn/goyo.vim</code></td>
|
|
<td>Distraction-free writing mode</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>voldikss/vim-floaterm</code></td>
|
|
<td>Floating terminal windows</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>norcalli/nvim-colorizer.lua</code></td>
|
|
<td>Inline colour preview</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<h4 id="navigation">Navigation<a class="toc-anchor" href="#navigation" title="Permanent link">¶</a></h4>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Plugin</th>
|
|
<th>Purpose</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><code>preservim/nerdtree</code></td>
|
|
<td>File tree sidebar</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>junegunn/fzf</code> + <code>fzf.vim</code></td>
|
|
<td>Fuzzy file/buffer search</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>elihunter173/dirbuf.nvim</code></td>
|
|
<td>Editable directory buffer</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<h4 id="snippets">Snippets<a class="toc-anchor" href="#snippets" title="Permanent link">¶</a></h4>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Plugin</th>
|
|
<th>Purpose</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><code>SirVer/ultisnips</code></td>
|
|
<td>Snippet engine</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>honza/vim-snippets</code></td>
|
|
<td>Snippet collection</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<h4 id="database">Database<a class="toc-anchor" href="#database" title="Permanent link">¶</a></h4>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Plugin</th>
|
|
<th>Purpose</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><code>tpope/vim-dadbod</code></td>
|
|
<td>Database query runner</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>kristijanhusak/vim-dadbod-ui</code></td>
|
|
<td>GUI for vim-dadbod</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<h4 id="markdown">Markdown<a class="toc-anchor" href="#markdown" title="Permanent link">¶</a></h4>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Plugin</th>
|
|
<th>Purpose</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><code>tadmccorkle/markdown.nvim</code></td>
|
|
<td>Enhanced Markdown support</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>ellisonleao/glow.nvim</code></td>
|
|
<td>Markdown preview in terminal</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<h4 id="theme">Theme<a class="toc-anchor" href="#theme" title="Permanent link">¶</a></h4>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Plugin</th>
|
|
<th>Purpose</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><code>the_miro/cyberqueer.nvim</code></td>
|
|
<td>CyberQueer colour scheme (local)</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<h3 id="coc-lsp-settings">CoC LSP Settings<a class="toc-anchor" href="#coc-lsp-settings" title="Permanent link">¶</a></h3>
|
|
<p><code>nvim/coc-settings.json</code> configures language servers for:
|
|
- Python (pyright)
|
|
- Lua (lua-language-server)
|
|
- Rust (rust-analyzer via rust.vim)</p>
|
|
<h3 id="cyberqueer-airline-theme">CyberQueer Airline Theme<a class="toc-anchor" href="#cyberqueer-airline-theme" title="Permanent link">¶</a></h3>
|
|
<p><code>nvim/cyberqueer-airline.vim</code> — a custom vim-airline theme using the CyberQueer palette, providing hot-pink/violet segments in the status bar.</p>
|
|
<hr />
|
|
<h2 id="micro">Micro<a class="toc-anchor" href="#micro" title="Permanent link">¶</a></h2>
|
|
<p>A modern, keyboard-friendly terminal editor. Config in <code>micro/</code>. Deployed to <code>~/.config/micro/</code>.</p>
|
|
<h3 id="settings-settingsjson">Settings (<code>settings.json</code>)<a class="toc-anchor" href="#settings-settingsjson" title="Permanent link">¶</a></h3>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Setting</th>
|
|
<th>Value</th>
|
|
<th>Effect</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><code>colorscheme</code></td>
|
|
<td><code>miro-darcula</code></td>
|
|
<td>Custom dark colour scheme</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Various</td>
|
|
<td>—</td>
|
|
<td>File-type-specific settings</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<h3 id="keybindings-bindingsjson">Keybindings (<code>bindings.json</code>)<a class="toc-anchor" href="#keybindings-bindingsjson" title="Permanent link">¶</a></h3>
|
|
<p>Custom keybindings extending Micro's defaults. See <code>micro/bindings.json</code> for the full list.</p>
|
|
<h3 id="colour-schemes">Colour Schemes<a class="toc-anchor" href="#colour-schemes" title="Permanent link">¶</a></h3>
|
|
<p><code>micro/colorschemes/</code> contains additional colour scheme definitions including the custom <code>miro-darcula</code> scheme.</p>
|
|
<h3 id="plugins-microplug">Plugins (<code>micro/plug/</code>)<a class="toc-anchor" href="#plugins-microplug" title="Permanent link">¶</a></h3>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Plugin</th>
|
|
<th>Purpose</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><code>filemanager</code></td>
|
|
<td>Sidebar file browser</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>mlsp</code></td>
|
|
<td>Language Server Protocol integration</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<hr />
|
|
<h2 id="yazi">Yazi<a class="toc-anchor" href="#yazi" title="Permanent link">¶</a></h2>
|
|
<p>A fast, feature-rich terminal file manager written in Rust.<br />
|
|
Config in <code>yazi/</code>. Deployed to <code>~/.config/yazi/</code>.</p>
|
|
<h3 id="configuration-files">Configuration Files<a class="toc-anchor" href="#configuration-files" title="Permanent link">¶</a></h3>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>File</th>
|
|
<th>Purpose</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><code>yazi.toml</code></td>
|
|
<td>Core settings (openers, file rules, display)</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>theme.toml</code></td>
|
|
<td>CyberQueer colour palette</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>keymap.toml</code></td>
|
|
<td>Keybindings (17 KB, extensively customised)</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<h3 id="theme_1">Theme<a class="toc-anchor" href="#theme_1" title="Permanent link">¶</a></h3>
|
|
<p><code>yazi/theme.toml</code> maps the CyberQueer colours to Yazi's theme variables. It is a colour-substitution target in <code>apply-theme.sh</code>, so it updates automatically when you change the palette.</p>
|
|
<h3 id="file-openers">File Openers<a class="toc-anchor" href="#file-openers" title="Permanent link">¶</a></h3>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>File type</th>
|
|
<th>Opens with</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><code>*.svg</code></td>
|
|
<td>Inkscape</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Text files</td>
|
|
<td>Neovim</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Everything else</td>
|
|
<td><code>xdg-open</code> (system default)</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<h3 id="display-options">Display Options<a class="toc-anchor" href="#display-options" title="Permanent link">¶</a></h3>
|
|
<ul>
|
|
<li>Hidden files visible by default</li>
|
|
<li>Symlinks shown and followed</li>
|
|
<li>Three-pane layout (parent, current, preview)</li>
|
|
</ul>
|
|
<hr />
|
|
<h2 id="launching-editors">Launching Editors<a class="toc-anchor" href="#launching-editors" title="Permanent link">¶</a></h2>
|
|
<p>From the Hyprland desktop:</p>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Shortcut</th>
|
|
<th>Action</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><code>Super + M</code></td>
|
|
<td>Open Micro in Kitty</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>Super + E</code></td>
|
|
<td>Open Yazi in Kitty</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>Super + T</code> then <code>nvim</code></td>
|
|
<td>Neovim in terminal</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p>From the shell:</p>
|
|
<pre><code class="language-bash">nvim file.rs # Neovim
|
|
micro config.yaml # Micro
|
|
yazi # Yazi file manager
|
|
</code></pre>
|
|
</main>
|
|
<footer>
|
|
Generated by md-to-html.sh · CyberQueer theme · 2026-05-18
|
|
</footer>
|
|
</body>
|
|
</html>
|