Compare commits

...

2 commits

Author SHA1 Message Date
43c2e25c78 release: 2026-03-30-233129 2026-03-30 23:31:29 +02:00
6dfc7ce473 css: shuffle style blocks 2026-03-29 21:41:07 +02:00
76 changed files with 6412 additions and 15 deletions

1
docs/CNAME Normal file
View file

@ -0,0 +1 @@
oddsquat.org

113
docs/about/index.html Normal file
View file

@ -0,0 +1,113 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta
name="viewport"
content="width=device-width, initial-scale=1.0">
<link rel="icon" href="/favicon.ico" sizes="32x32">
<link rel="icon" href="/icon.svg" type="image/svg+xml">
<title>
about | oddsquat
</title>
<meta name="description" content="General info about this website and the author">
<link rel="preload" href="/fonts/open_sans_condensed-32.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans_condensed-27.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-25.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-24.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-17.woff2" as="font" type="font/woff2" crossorigin>
<link rel="stylesheet" type="text/css" href="/css/fonts.css">
<link rel="stylesheet" type="text/css" href="/css/typography.css">
<link rel="stylesheet" type="text/css" href="/css/main.css">
</head>
<body>
<div class="stripesContainer">
<div class="stripes">
</div>
</div>
<header>
<nav>
<ul>
<li><a href="/">oddsquat</a></li>
<li>about</li>
</ul>
</nav>
</header>
<main>
<article>
<div style='margin-bottom: 1.5rem;'>
<details>
<summary style='cursor: pointer; display: inline;'>
Hello,
my&nbsp;name is&nbsp;<strong>He4eT</strong>.
</summary>
<p style='margin-left: 0.5rem;'>
Its a&nbsp;Latin transliteration and
is&nbsp;read as&nbsp;“Nechet” [ˈnʲet͡ɕet].<br>
The name comes from the Russian word “нечет”,
a&nbsp;short form of&nbsp;“нечётный”,
a&nbsp;mathematical term meaning “odd”.
</p>
</details>
</div>
<p>
I'm a&nbsp;front-end developer and a&nbsp;big fan of&nbsp;open-source,
customization, and minimalist software.<br>
Member of&nbsp;the
<a href='https://t.me/barbadbar' target='_blank'>BadBar</a> crew,
part of&nbsp;the
<a href='https://decentrala.org' target='_blank'>Decentrala</a>
and <a href='https://xecut.me' target='_blank'>Xecut</a> communities.
</p>
<p>
<strong>Oddsquat</strong> is&nbsp;my&nbsp;own private fanzine
about experiments, code, and other cyberpunk stuff.<br>
<a href='/rss.xml'>RSS feed</a> available.
</p>
<hr>
<section>
<ul>
<li>Email: <a href='mailto:He4eT@oddsquat.org' target='_blank'>He4eT@oddsquat.org</a></li>
<li>Telegram: <a href='https://t.me/He4eT' target='_blank'>@He4eT</a></li>
<li>XMPP: <a href='xmpp:He4eT@dmz.rs' target='_blank'>He4eT@dmz.rs</a></li>
<li>Fediverse:
<ul>
<li><a href='https://techhub.social/@He4eT' target='_blank'>@He4eT@techhub.social</a></li>
<li><a href='https://c.im/@He4eT' target='_blank'>@He4eT@c.im</a></li>
</ul>
</li>
<li>Code: <a href='https://github.com/He4eT' target='_blank'>github.com/He4eT</a></li>
</ul>
</section>
</article>
</main>
<footer>
</footer>
<script async
data-goatcounter="https://he4et.goatcounter.com/count"
src="https://gc.zgo.at/count.js"></script>
</body>
</html>

464
docs/css/fonts.css Normal file
View file

@ -0,0 +1,464 @@
/* cyrillic-ext */
@font-face {
font-family: 'Fira Code';
font-style: normal;
font-weight: 400;
src: url('/fonts/fira_code-0.woff2') format('woff2');
unicode-range: U+0460-052F, U+1C80-1C88, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;
}
/* cyrillic */
@font-face {
font-family: 'Fira Code';
font-style: normal;
font-weight: 400;
src: url('/fonts/fira_code-1.woff2') format('woff2');
unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;
}
/* greek-ext */
@font-face {
font-family: 'Fira Code';
font-style: normal;
font-weight: 400;
src: url('/fonts/fira_code-2.woff2') format('woff2');
unicode-range: U+1F00-1FFF;
}
/* greek */
@font-face {
font-family: 'Fira Code';
font-style: normal;
font-weight: 400;
src: url('/fonts/fira_code-3.woff2') format('woff2');
unicode-range: U+0370-03FF;
}
/* latin-ext */
@font-face {
font-family: 'Fira Code';
font-style: normal;
font-weight: 400;
src: url('/fonts/fira_code-4.woff2') format('woff2');
unicode-range: U+0100-02AF, U+0304, U+0308, U+0329, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20CF, U+2113, U+2C60-2C7F, U+A720-A7FF;
}
/* latin */
@font-face {
font-family: 'Fira Code';
font-style: normal;
font-weight: 400;
src: url('/fonts/fira_code-5.woff2') format('woff2');
unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
}
/* cyrillic-ext */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-6.woff2') format('woff2');
unicode-range: U+0460-052F, U+1C80-1C88, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;
}
/* cyrillic */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-7.woff2') format('woff2');
unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;
}
/* greek-ext */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-8.woff2') format('woff2');
unicode-range: U+1F00-1FFF;
}
/* greek */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-9.woff2') format('woff2');
unicode-range: U+0370-03FF;
}
/* hebrew */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-10.woff2') format('woff2');
unicode-range: U+0590-05FF, U+200C-2010, U+20AA, U+25CC, U+FB1D-FB4F;
}
/* math */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-11.woff2') format('woff2');
unicode-range: U+0302-0303, U+0305, U+0307-0308, U+0330, U+0391-03A1, U+03A3-03A9, U+03B1-03C9, U+03D1, U+03D5-03D6, U+03F0-03F1, U+03F4-03F5, U+2034-2037, U+2057, U+20D0-20DC, U+20E1, U+20E5-20EF, U+2102, U+210A-210E, U+2110-2112, U+2115, U+2119-211D, U+2124, U+2128, U+212C-212D, U+212F-2131, U+2133-2138, U+213C-2140, U+2145-2149, U+2190, U+2192, U+2194-21AE, U+21B0-21E5, U+21F1-21F2, U+21F4-2211, U+2213-2214, U+2216-22FF, U+2308-230B, U+2310, U+2319, U+231C-2321, U+2336-237A, U+237C, U+2395, U+239B-23B6, U+23D0, U+23DC-23E1, U+2474-2475, U+25AF, U+25B3, U+25B7, U+25BD, U+25C1, U+25CA, U+25CC, U+25FB, U+266D-266F, U+27C0-27FF, U+2900-2AFF, U+2B0E-2B11, U+2B30-2B4C, U+2BFE, U+FF5B, U+FF5D, U+1D400-1D7FF, U+1EE00-1EEFF;
}
/* symbols */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-12.woff2') format('woff2');
unicode-range: U+0001-000C, U+000E-001F, U+007F-009F, U+20DD-20E0, U+20E2-20E4, U+2150-218F, U+2190, U+2192, U+2194-2199, U+21AF, U+21E6-21F0, U+21F3, U+2218-2219, U+2299, U+22C4-22C6, U+2300-243F, U+2440-244A, U+2460-24FF, U+25A0-27BF, U+2800-28FF, U+2921-2922, U+2981, U+29BF, U+29EB, U+2B00-2BFF, U+4DC0-4DFF, U+FFF9-FFFB, U+10140-1018E, U+10190-1019C, U+101A0, U+101D0-101FD, U+102E0-102FB, U+10E60-10E7E, U+1D2E0-1D37F, U+1F000-1F0FF, U+1F100-1F10C, U+1F110-1F16C, U+1F170-1F190, U+1F19B-1F1AC, U+1F30D-1F30F, U+1F315, U+1F31C, U+1F31E, U+1F320-1F32C, U+1F336, U+1F378, U+1F37D, U+1F382, U+1F393-1F39F, U+1F3A7-1F3A8, U+1F3AC-1F3AF, U+1F3C2, U+1F3C4-1F3C6, U+1F3CA-1F3CE, U+1F3D4-1F3E0, U+1F3ED, U+1F3F1-1F3F3, U+1F3F5-1F3F7, U+1F408, U+1F415, U+1F41F, U+1F426, U+1F43F, U+1F441-1F442, U+1F444, U+1F446-1F449, U+1F44C-1F44E, U+1F453, U+1F46A, U+1F47D, U+1F4A3, U+1F4B0, U+1F4B3, U+1F4B9, U+1F4BB, U+1F4BF, U+1F4C8-1F4CB, U+1F4D6, U+1F4DA, U+1F4DF, U+1F4E3-1F4E6, U+1F4EA-1F4ED, U+1F4F7, U+1F4F9-1F4FB, U+1F4FD-1F4FE, U+1F503, U+1F507-1F50B, U+1F50D, U+1F512-1F513, U+1F53E-1F54A, U+1F54F-1F579, U+1F57B-1F594, U+1F597-1F5A3, U+1F5A5-1F5FA, U+1F610, U+1F650-1F67F, U+1F687, U+1F68D, U+1F691, U+1F694, U+1F698, U+1F6AD, U+1F6B2, U+1F6B9-1F6BA, U+1F6BC, U+1F6C6-1F6CB, U+1F6CD-1F6CF, U+1F6D3-1F6D7, U+1F6E0-1F6EA, U+1F6F0-1F6F3, U+1F6F7-1F6FC, U+1F700-1F7FF, U+1F800-1F80B, U+1F810-1F847, U+1F850-1F859, U+1F860-1F887, U+1F890-1F8AD, U+1F8B0-1F8B1, U+1F93B, U+1F946, U+1F984, U+1F996, U+1F9E9, U+1FA00-1FA6F, U+1FA70-1FA74, U+1FA78-1FA7A, U+1FA80-1FA86, U+1FA90-1FAA8, U+1FAB0-1FAB6, U+1FAC0-1FAC2, U+1FAD0-1FAD6, U+1FB00-1FBFF;
}
/* vietnamese */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-13.woff2') format('woff2');
unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;
}
/* latin-ext */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-14.woff2') format('woff2');
unicode-range: U+0100-02AF, U+0304, U+0308, U+0329, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20CF, U+2113, U+2C60-2C7F, U+A720-A7FF;
}
/* latin */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-15.woff2') format('woff2');
unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
}
/* cyrillic-ext */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-6.woff2') format('woff2');
unicode-range: U+0460-052F, U+1C80-1C88, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;
}
/* cyrillic */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-7.woff2') format('woff2');
unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;
}
/* greek-ext */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-8.woff2') format('woff2');
unicode-range: U+1F00-1FFF;
}
/* greek */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-9.woff2') format('woff2');
unicode-range: U+0370-03FF;
}
/* hebrew */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-10.woff2') format('woff2');
unicode-range: U+0590-05FF, U+200C-2010, U+20AA, U+25CC, U+FB1D-FB4F;
}
/* math */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-11.woff2') format('woff2');
unicode-range: U+0302-0303, U+0305, U+0307-0308, U+0330, U+0391-03A1, U+03A3-03A9, U+03B1-03C9, U+03D1, U+03D5-03D6, U+03F0-03F1, U+03F4-03F5, U+2034-2037, U+2057, U+20D0-20DC, U+20E1, U+20E5-20EF, U+2102, U+210A-210E, U+2110-2112, U+2115, U+2119-211D, U+2124, U+2128, U+212C-212D, U+212F-2131, U+2133-2138, U+213C-2140, U+2145-2149, U+2190, U+2192, U+2194-21AE, U+21B0-21E5, U+21F1-21F2, U+21F4-2211, U+2213-2214, U+2216-22FF, U+2308-230B, U+2310, U+2319, U+231C-2321, U+2336-237A, U+237C, U+2395, U+239B-23B6, U+23D0, U+23DC-23E1, U+2474-2475, U+25AF, U+25B3, U+25B7, U+25BD, U+25C1, U+25CA, U+25CC, U+25FB, U+266D-266F, U+27C0-27FF, U+2900-2AFF, U+2B0E-2B11, U+2B30-2B4C, U+2BFE, U+FF5B, U+FF5D, U+1D400-1D7FF, U+1EE00-1EEFF;
}
/* symbols */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-12.woff2') format('woff2');
unicode-range: U+0001-000C, U+000E-001F, U+007F-009F, U+20DD-20E0, U+20E2-20E4, U+2150-218F, U+2190, U+2192, U+2194-2199, U+21AF, U+21E6-21F0, U+21F3, U+2218-2219, U+2299, U+22C4-22C6, U+2300-243F, U+2440-244A, U+2460-24FF, U+25A0-27BF, U+2800-28FF, U+2921-2922, U+2981, U+29BF, U+29EB, U+2B00-2BFF, U+4DC0-4DFF, U+FFF9-FFFB, U+10140-1018E, U+10190-1019C, U+101A0, U+101D0-101FD, U+102E0-102FB, U+10E60-10E7E, U+1D2E0-1D37F, U+1F000-1F0FF, U+1F100-1F10C, U+1F110-1F16C, U+1F170-1F190, U+1F19B-1F1AC, U+1F30D-1F30F, U+1F315, U+1F31C, U+1F31E, U+1F320-1F32C, U+1F336, U+1F378, U+1F37D, U+1F382, U+1F393-1F39F, U+1F3A7-1F3A8, U+1F3AC-1F3AF, U+1F3C2, U+1F3C4-1F3C6, U+1F3CA-1F3CE, U+1F3D4-1F3E0, U+1F3ED, U+1F3F1-1F3F3, U+1F3F5-1F3F7, U+1F408, U+1F415, U+1F41F, U+1F426, U+1F43F, U+1F441-1F442, U+1F444, U+1F446-1F449, U+1F44C-1F44E, U+1F453, U+1F46A, U+1F47D, U+1F4A3, U+1F4B0, U+1F4B3, U+1F4B9, U+1F4BB, U+1F4BF, U+1F4C8-1F4CB, U+1F4D6, U+1F4DA, U+1F4DF, U+1F4E3-1F4E6, U+1F4EA-1F4ED, U+1F4F7, U+1F4F9-1F4FB, U+1F4FD-1F4FE, U+1F503, U+1F507-1F50B, U+1F50D, U+1F512-1F513, U+1F53E-1F54A, U+1F54F-1F579, U+1F57B-1F594, U+1F597-1F5A3, U+1F5A5-1F5FA, U+1F610, U+1F650-1F67F, U+1F687, U+1F68D, U+1F691, U+1F694, U+1F698, U+1F6AD, U+1F6B2, U+1F6B9-1F6BA, U+1F6BC, U+1F6C6-1F6CB, U+1F6CD-1F6CF, U+1F6D3-1F6D7, U+1F6E0-1F6EA, U+1F6F0-1F6F3, U+1F6F7-1F6FC, U+1F700-1F7FF, U+1F800-1F80B, U+1F810-1F847, U+1F850-1F859, U+1F860-1F887, U+1F890-1F8AD, U+1F8B0-1F8B1, U+1F93B, U+1F946, U+1F984, U+1F996, U+1F9E9, U+1FA00-1FA6F, U+1FA70-1FA74, U+1FA78-1FA7A, U+1FA80-1FA86, U+1FA90-1FAA8, U+1FAB0-1FAB6, U+1FAC0-1FAC2, U+1FAD0-1FAD6, U+1FB00-1FBFF;
}
/* vietnamese */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-13.woff2') format('woff2');
unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;
}
/* latin-ext */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-14.woff2') format('woff2');
unicode-range: U+0100-02AF, U+0304, U+0308, U+0329, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20CF, U+2113, U+2C60-2C7F, U+A720-A7FF;
}
/* latin */
@font-face {
font-family: 'Open Sans';
font-style: italic;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-15.woff2') format('woff2');
unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
}
/* cyrillic-ext */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-16.woff2') format('woff2');
unicode-range: U+0460-052F, U+1C80-1C88, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;
}
/* cyrillic */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-17.woff2') format('woff2');
unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;
}
/* greek-ext */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-18.woff2') format('woff2');
unicode-range: U+1F00-1FFF;
}
/* greek */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-19.woff2') format('woff2');
unicode-range: U+0370-03FF;
}
/* hebrew */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-20.woff2') format('woff2');
unicode-range: U+0590-05FF, U+200C-2010, U+20AA, U+25CC, U+FB1D-FB4F;
}
/* math */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-21.woff2') format('woff2');
unicode-range: U+0302-0303, U+0305, U+0307-0308, U+0330, U+0391-03A1, U+03A3-03A9, U+03B1-03C9, U+03D1, U+03D5-03D6, U+03F0-03F1, U+03F4-03F5, U+2034-2037, U+2057, U+20D0-20DC, U+20E1, U+20E5-20EF, U+2102, U+210A-210E, U+2110-2112, U+2115, U+2119-211D, U+2124, U+2128, U+212C-212D, U+212F-2131, U+2133-2138, U+213C-2140, U+2145-2149, U+2190, U+2192, U+2194-21AE, U+21B0-21E5, U+21F1-21F2, U+21F4-2211, U+2213-2214, U+2216-22FF, U+2308-230B, U+2310, U+2319, U+231C-2321, U+2336-237A, U+237C, U+2395, U+239B-23B6, U+23D0, U+23DC-23E1, U+2474-2475, U+25AF, U+25B3, U+25B7, U+25BD, U+25C1, U+25CA, U+25CC, U+25FB, U+266D-266F, U+27C0-27FF, U+2900-2AFF, U+2B0E-2B11, U+2B30-2B4C, U+2BFE, U+FF5B, U+FF5D, U+1D400-1D7FF, U+1EE00-1EEFF;
}
/* symbols */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-22.woff2') format('woff2');
unicode-range: U+0001-000C, U+000E-001F, U+007F-009F, U+20DD-20E0, U+20E2-20E4, U+2150-218F, U+2190, U+2192, U+2194-2199, U+21AF, U+21E6-21F0, U+21F3, U+2218-2219, U+2299, U+22C4-22C6, U+2300-243F, U+2440-244A, U+2460-24FF, U+25A0-27BF, U+2800-28FF, U+2921-2922, U+2981, U+29BF, U+29EB, U+2B00-2BFF, U+4DC0-4DFF, U+FFF9-FFFB, U+10140-1018E, U+10190-1019C, U+101A0, U+101D0-101FD, U+102E0-102FB, U+10E60-10E7E, U+1D2E0-1D37F, U+1F000-1F0FF, U+1F100-1F10C, U+1F110-1F16C, U+1F170-1F190, U+1F19B-1F1AC, U+1F30D-1F30F, U+1F315, U+1F31C, U+1F31E, U+1F320-1F32C, U+1F336, U+1F378, U+1F37D, U+1F382, U+1F393-1F39F, U+1F3A7-1F3A8, U+1F3AC-1F3AF, U+1F3C2, U+1F3C4-1F3C6, U+1F3CA-1F3CE, U+1F3D4-1F3E0, U+1F3ED, U+1F3F1-1F3F3, U+1F3F5-1F3F7, U+1F408, U+1F415, U+1F41F, U+1F426, U+1F43F, U+1F441-1F442, U+1F444, U+1F446-1F449, U+1F44C-1F44E, U+1F453, U+1F46A, U+1F47D, U+1F4A3, U+1F4B0, U+1F4B3, U+1F4B9, U+1F4BB, U+1F4BF, U+1F4C8-1F4CB, U+1F4D6, U+1F4DA, U+1F4DF, U+1F4E3-1F4E6, U+1F4EA-1F4ED, U+1F4F7, U+1F4F9-1F4FB, U+1F4FD-1F4FE, U+1F503, U+1F507-1F50B, U+1F50D, U+1F512-1F513, U+1F53E-1F54A, U+1F54F-1F579, U+1F57B-1F594, U+1F597-1F5A3, U+1F5A5-1F5FA, U+1F610, U+1F650-1F67F, U+1F687, U+1F68D, U+1F691, U+1F694, U+1F698, U+1F6AD, U+1F6B2, U+1F6B9-1F6BA, U+1F6BC, U+1F6C6-1F6CB, U+1F6CD-1F6CF, U+1F6D3-1F6D7, U+1F6E0-1F6EA, U+1F6F0-1F6F3, U+1F6F7-1F6FC, U+1F700-1F7FF, U+1F800-1F80B, U+1F810-1F847, U+1F850-1F859, U+1F860-1F887, U+1F890-1F8AD, U+1F8B0-1F8B1, U+1F93B, U+1F946, U+1F984, U+1F996, U+1F9E9, U+1FA00-1FA6F, U+1FA70-1FA74, U+1FA78-1FA7A, U+1FA80-1FA86, U+1FA90-1FAA8, U+1FAB0-1FAB6, U+1FAC0-1FAC2, U+1FAD0-1FAD6, U+1FB00-1FBFF;
}
/* vietnamese */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-23.woff2') format('woff2');
unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;
}
/* latin-ext */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-24.woff2') format('woff2');
unicode-range: U+0100-02AF, U+0304, U+0308, U+0329, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20CF, U+2113, U+2C60-2C7F, U+A720-A7FF;
}
/* latin */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 400;
font-stretch: 100%;
src: url('/fonts/open_sans-25.woff2') format('woff2');
unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
}
/* cyrillic-ext */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-16.woff2') format('woff2');
unicode-range: U+0460-052F, U+1C80-1C88, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;
}
/* cyrillic */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-17.woff2') format('woff2');
unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;
}
/* greek-ext */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-18.woff2') format('woff2');
unicode-range: U+1F00-1FFF;
}
/* greek */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-19.woff2') format('woff2');
unicode-range: U+0370-03FF;
}
/* hebrew */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-20.woff2') format('woff2');
unicode-range: U+0590-05FF, U+200C-2010, U+20AA, U+25CC, U+FB1D-FB4F;
}
/* math */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-21.woff2') format('woff2');
unicode-range: U+0302-0303, U+0305, U+0307-0308, U+0330, U+0391-03A1, U+03A3-03A9, U+03B1-03C9, U+03D1, U+03D5-03D6, U+03F0-03F1, U+03F4-03F5, U+2034-2037, U+2057, U+20D0-20DC, U+20E1, U+20E5-20EF, U+2102, U+210A-210E, U+2110-2112, U+2115, U+2119-211D, U+2124, U+2128, U+212C-212D, U+212F-2131, U+2133-2138, U+213C-2140, U+2145-2149, U+2190, U+2192, U+2194-21AE, U+21B0-21E5, U+21F1-21F2, U+21F4-2211, U+2213-2214, U+2216-22FF, U+2308-230B, U+2310, U+2319, U+231C-2321, U+2336-237A, U+237C, U+2395, U+239B-23B6, U+23D0, U+23DC-23E1, U+2474-2475, U+25AF, U+25B3, U+25B7, U+25BD, U+25C1, U+25CA, U+25CC, U+25FB, U+266D-266F, U+27C0-27FF, U+2900-2AFF, U+2B0E-2B11, U+2B30-2B4C, U+2BFE, U+FF5B, U+FF5D, U+1D400-1D7FF, U+1EE00-1EEFF;
}
/* symbols */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-22.woff2') format('woff2');
unicode-range: U+0001-000C, U+000E-001F, U+007F-009F, U+20DD-20E0, U+20E2-20E4, U+2150-218F, U+2190, U+2192, U+2194-2199, U+21AF, U+21E6-21F0, U+21F3, U+2218-2219, U+2299, U+22C4-22C6, U+2300-243F, U+2440-244A, U+2460-24FF, U+25A0-27BF, U+2800-28FF, U+2921-2922, U+2981, U+29BF, U+29EB, U+2B00-2BFF, U+4DC0-4DFF, U+FFF9-FFFB, U+10140-1018E, U+10190-1019C, U+101A0, U+101D0-101FD, U+102E0-102FB, U+10E60-10E7E, U+1D2E0-1D37F, U+1F000-1F0FF, U+1F100-1F10C, U+1F110-1F16C, U+1F170-1F190, U+1F19B-1F1AC, U+1F30D-1F30F, U+1F315, U+1F31C, U+1F31E, U+1F320-1F32C, U+1F336, U+1F378, U+1F37D, U+1F382, U+1F393-1F39F, U+1F3A7-1F3A8, U+1F3AC-1F3AF, U+1F3C2, U+1F3C4-1F3C6, U+1F3CA-1F3CE, U+1F3D4-1F3E0, U+1F3ED, U+1F3F1-1F3F3, U+1F3F5-1F3F7, U+1F408, U+1F415, U+1F41F, U+1F426, U+1F43F, U+1F441-1F442, U+1F444, U+1F446-1F449, U+1F44C-1F44E, U+1F453, U+1F46A, U+1F47D, U+1F4A3, U+1F4B0, U+1F4B3, U+1F4B9, U+1F4BB, U+1F4BF, U+1F4C8-1F4CB, U+1F4D6, U+1F4DA, U+1F4DF, U+1F4E3-1F4E6, U+1F4EA-1F4ED, U+1F4F7, U+1F4F9-1F4FB, U+1F4FD-1F4FE, U+1F503, U+1F507-1F50B, U+1F50D, U+1F512-1F513, U+1F53E-1F54A, U+1F54F-1F579, U+1F57B-1F594, U+1F597-1F5A3, U+1F5A5-1F5FA, U+1F610, U+1F650-1F67F, U+1F687, U+1F68D, U+1F691, U+1F694, U+1F698, U+1F6AD, U+1F6B2, U+1F6B9-1F6BA, U+1F6BC, U+1F6C6-1F6CB, U+1F6CD-1F6CF, U+1F6D3-1F6D7, U+1F6E0-1F6EA, U+1F6F0-1F6F3, U+1F6F7-1F6FC, U+1F700-1F7FF, U+1F800-1F80B, U+1F810-1F847, U+1F850-1F859, U+1F860-1F887, U+1F890-1F8AD, U+1F8B0-1F8B1, U+1F93B, U+1F946, U+1F984, U+1F996, U+1F9E9, U+1FA00-1FA6F, U+1FA70-1FA74, U+1FA78-1FA7A, U+1FA80-1FA86, U+1FA90-1FAA8, U+1FAB0-1FAB6, U+1FAC0-1FAC2, U+1FAD0-1FAD6, U+1FB00-1FBFF;
}
/* vietnamese */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-23.woff2') format('woff2');
unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;
}
/* latin-ext */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-24.woff2') format('woff2');
unicode-range: U+0100-02AF, U+0304, U+0308, U+0329, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20CF, U+2113, U+2C60-2C7F, U+A720-A7FF;
}
/* latin */
@font-face {
font-family: 'Open Sans';
font-style: normal;
font-weight: 700;
font-stretch: 100%;
src: url('/fonts/open_sans-25.woff2') format('woff2');
unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
}
/* cyrillic-ext */
@font-face {
font-family: 'Open Sans Condensed';
font-style: normal;
font-weight: 700;
src: url('/fonts/open_sans_condensed-26.woff2') format('woff2');
unicode-range: U+0460-052F, U+1C80-1C88, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;
}
/* cyrillic */
@font-face {
font-family: 'Open Sans Condensed';
font-style: normal;
font-weight: 700;
src: url('/fonts/open_sans_condensed-27.woff2') format('woff2');
unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;
}
/* greek-ext */
@font-face {
font-family: 'Open Sans Condensed';
font-style: normal;
font-weight: 700;
src: url('/fonts/open_sans_condensed-28.woff2') format('woff2');
unicode-range: U+1F00-1FFF;
}
/* greek */
@font-face {
font-family: 'Open Sans Condensed';
font-style: normal;
font-weight: 700;
src: url('/fonts/open_sans_condensed-29.woff2') format('woff2');
unicode-range: U+0370-03FF;
}
/* vietnamese */
@font-face {
font-family: 'Open Sans Condensed';
font-style: normal;
font-weight: 700;
src: url('/fonts/open_sans_condensed-30.woff2') format('woff2');
unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;
}
/* latin-ext */
@font-face {
font-family: 'Open Sans Condensed';
font-style: normal;
font-weight: 700;
src: url('/fonts/open_sans_condensed-31.woff2') format('woff2');
unicode-range: U+0100-02AF, U+0304, U+0308, U+0329, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20CF, U+2113, U+2C60-2C7F, U+A720-A7FF;
}
/* latin */
@font-face {
font-family: 'Open Sans Condensed';
font-style: normal;
font-weight: 700;
src: url('/fonts/open_sans_condensed-32.woff2') format('woff2');
unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
}

24
docs/css/index.css Normal file
View file

@ -0,0 +1,24 @@
ul {
list-style: none;
margin: 0;
}
li {
font-size: 2rem;
margin-left: 6%;
}
li::before {
content: '/ ';
white-space: pre;
}
li:first-child {
font-size: 1.5rem;
margin-left: 0;
margin-bottom: 10%;
}
li:first-child::before {
content: '';
}

163
docs/css/main.css Normal file
View file

@ -0,0 +1,163 @@
*::selection {
color: #fff;
background: rgba(0, 0, 0, 0.8);
}
*:focus-visible {
outline: 4px solid hsl(0, 0%, 0%, 0.7);
outline-offset: 4px;
}
/* Headers */
h1, h2, h3, h4, h5 {
scroll-margin-top: 0.5em;
}
/* Links */
a {
border-bottom: 2px solid hsl(0, 0%, 0%, 0.2);
color: inherit;
text-decoration: none;
}
a:hover {
border-color: currentColor;
}
/* Lists */
ul {
list-style: square;
}
/* Tables */
@media (max-width: 500px) {
table {
display: block;
overflow: auto;
width: 100%;
}
}
/* Code and quotes*/
pre, blockquote {
border-left: 4px solid hsl(0, 0%, 0%, 0.7);
margin-left: 0;
padding-left: 1.0rem;
padding-right: 1.0rem;
}
pre {
background-color: hsl(0, 0%, 0%, 0.04);
overflow-x: auto;
padding-top: 0.5rem;
padding-bottom: 0.5rem;
}
pre > code {
background-color: unset;
padding: 0;
}
code {
font-family: 'Fira Code', monospace;
background-color: hsl(0, 0%, 0%, 0.04);
padding: 0.2rem 0.4rem;
}
/* Images */
figure.image img {
display: block;
box-sizing: border-box;
margin-bottom: 0;
}
figure.image.bordered img {
border: 4px solid hsl(0, 0%, 0%, 0.7);
}
figure.image figcaption {
border-left: 4px solid hsl(0, 0%, 0%, 0.2);
padding-left: 1.0rem;
padding-right: 1.0rem;
margin-top: 1.0rem;
}
/* Entries */
.entry:last-child,
.entry {
margin-bottom: 1.5rem;
}
.entry > header,
.entry > .description {
margin-bottom: 0.5rem;
}
/* Stripes */
.stripesContainer {
box-sizing: content-box;
max-width: 45rem;
padding: 5% 5% 0;
}
.stripes {
height: 8vh;
background-image: linear-gradient(
135deg,
currentColor 33.33%,
transparent 33.33%,
transparent 50%,
currentColor 50%,
currentColor 83.33%,
transparent 83.33%,
transparent 100%);
background-size: 30.00px 30.00px;
}
/* Layout */
html, body {
scroll-behavior: smooth;
background-color: #fff;
}
body > header,
body > footer,
body > main {
box-sizing: content-box;
max-width: 45rem;
padding: 3% 5%;
}
body > header ul {
display: flex;
flex-wrap: wrap;
font-size: 1.5rem;
list-style: none;
margin: 0;
}
body > header li {
margin-bottom: 0;
}
body > header li::after {
content: ' / ';
white-space: pre;
}
body > header li:last-child::after {
content: '';
}
body > footer {
color: hsl(0, 0%, 0%, 0.6);
}

1
docs/css/typography.css Normal file

File diff suppressed because one or more lines are too long

BIN
docs/favicon.ico Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 123 B

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

7
docs/icon.svg Normal file
View file

@ -0,0 +1,7 @@
<svg
version="1.1"
width="128" height="128"
xmlns="http://www.w3.org/2000/svg">
<rect width="100%" height="100%" fill="#000"/>
</svg>

After

Width:  |  Height:  |  Size: 143 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 176 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 140 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 88 KiB

File diff suppressed because it is too large Load diff

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 70 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 77 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 227 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 158 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 90 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 138 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 245 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 66 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 80 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 110 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 211 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 141 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 408 B

59
docs/index.html Normal file
View file

@ -0,0 +1,59 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta
name="viewport"
content="width=device-width, initial-scale=1.0">
<link rel="icon" href="/favicon.ico" sizes="32x32">
<link rel="icon" href="/icon.svg" type="image/svg+xml">
<title>
oddsquat
</title>
<meta name="description" content="My own private fanzine">
<link rel="preload" href="/fonts/open_sans_condensed-32.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans_condensed-27.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-25.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-24.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-17.woff2" as="font" type="font/woff2" crossorigin>
<link rel="stylesheet" type="text/css" href="/css/fonts.css">
<link rel="stylesheet" type="text/css" href="/css/typography.css">
<link rel="stylesheet" type="text/css" href="/css/main.css">
<link rel="stylesheet" href="/css/index.css">
</head>
<body>
<div class="stripesContainer">
<div class="stripes">
</div>
</div>
<main>
<nav>
<ul>
<li><a href="/">oddsquat</a></li>
<li><a href="/posts/">posts</a></li>
<li><a href="/lost+found/">lost+found</a></li>
<li><a href="/projects/">projects</a></li>
<li><a href="/about/">about</a></li>
</ul>
</nav>
</main>
<script async
data-goatcounter="https://he4et.goatcounter.com/count"
src="https://gc.zgo.at/count.js"></script>
</body>
</html>

590
docs/lost+found/index.html Normal file
View file

@ -0,0 +1,590 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta
name="viewport"
content="width=device-width, initial-scale=1.0">
<link rel="icon" href="/favicon.ico" sizes="32x32">
<link rel="icon" href="/icon.svg" type="image/svg+xml">
<title>
lost+found | oddsquat
</title>
<meta name="description" content="Unsorted pile of links I sometimes urgently need in the middle of a conversation.">
<link rel="preload" href="/fonts/open_sans_condensed-32.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans_condensed-27.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-25.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-24.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-17.woff2" as="font" type="font/woff2" crossorigin>
<link rel="stylesheet" type="text/css" href="/css/fonts.css">
<link rel="stylesheet" type="text/css" href="/css/typography.css">
<link rel="stylesheet" type="text/css" href="/css/main.css">
</head>
<body>
<div class="stripesContainer">
<div class="stripes">
</div>
</div>
<header>
<nav>
<ul>
<li><a href="/">oddsquat</a></li>
<li>lost+found</li>
</ul>
</nav>
</header>
<main>
<article>
<h1 id="lost-found">lost+found</h1>
<p>Unsorted pile of&nbsp;links I&nbsp;sometimes urgently need
in&nbsp;the middle of&nbsp;a&nbsp;conversation.</p>
<blockquote>
<p>Some file systems contain a&nbsp;special directory,
called <strong>lost+found</strong> under Unix, where a&nbsp;file system check
places lost and potentially corrupted files when the correct location
cannot be&nbsp;determined,
and so&nbsp;<strong>requires manual intervention by&nbsp;the user</strong>.</p>
</blockquote>
<hr>
<ul>
<li><article class='entry'>
<header>
<strong>
<a href='https://cari.institute/aesthetics' target='_blank'>
Index of&nbsp;Aesthetics
</a>
</strong>
</header>
<section class='description'>
An&nbsp;impressive library of&nbsp;visual styles
that are usually hard to&nbsp;name.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://humanprogress.org/trends/' target='_blank'>
Human Progress
</a>
</strong>
</header>
<section class='description'>
A&nbsp;collection of&nbsp;positive human statistics
and optimistic charts.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://novehiclesinthepark.com/' target='_blank'>
No&nbsp;Vehicles in&nbsp;the Park
</a>
</strong>
</header>
<section class='description'>
A&nbsp;short game that illustrates how one rule can mean
different things to&nbsp;different people.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://deaddrops.com/' target='_blank'>
Dead Drops
</a>
</strong>
</header>
<section class='description'>
A&nbsp;global network of&nbsp;anonymous,
cemented USB drives for offline file sharing.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://freesewing.eu/' target='_blank'>
FreeSewing
</a>
</strong>
</header>
<section class='description'>
Like GitHub, but for clothes.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://endoflife.date/' target='_blank'>
EndOfLife.date
</a>
</strong>
</header>
<section class='description'>
End-of-life (EOL) and support information is&nbsp;often
hard to&nbsp;track, or&nbsp;very badly presented.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://www.atlasobscura.com/' target='_blank'>
Atlas Obscura
</a>
</strong>
</header>
<section class='description'>
A&nbsp;comprehensive database of&nbsp;the worlds most
wondrous places and foods.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://learnxinyminutes.com/' target='_blank'>
Learn X&nbsp;in&nbsp;Y&nbsp;minutes
</a>
</strong>
</header>
<section class='description'>
A&nbsp;fast-paced intro to&nbsp;a&nbsp;new programming
language or&nbsp;tool.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://en.wikipedia.org/wiki/Ithkuil' target='_blank'>
Ithkuil
</a>
</strong>
</header>
<section class='description'>
An&nbsp;experimental constructed language designed to&nbsp;express
more profound levels of&nbsp;human cognition briefly and clearly.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='http://xahlee.info/kbd/keyboarding.html' target='_blank'>
Xah Keyboard Guide
</a>
</strong>
</header>
<section class='description'>
Keyboards, input devices, shortcuts, typing habits,
and the ergonomics behind it&nbsp;all.<br>
See the <a href='http://www.xahlee.info/kbd/diy_keyboards_index.html' target='_blank'>
list of&nbsp;Do-It-Yourself Keyboards</a>.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://ourworldindata.org/' target='_blank'>
Our World In&nbsp;Data
</a>
</strong>
</header>
<section class='description'>
An&nbsp;overview of&nbsp;global data and long-term trends.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://www.lesswrong.com/posts/tscc3e5eujrsEeFN4/well-kept-gardens-die-by-pacifism' target='_blank'>
Well-Kept Gardens Die By&nbsp;Pacifism
</a>
</strong>
</header>
<section class='description'>
Good online communities die primarily by&nbsp;refusing to&nbsp;defend themselves.<br>
Also <a href='https://lesswrong.ru/w/%D0%9F%D0%B0%D1%86%D0%B8%D1%84%D0%B8%D0%B7%D0%BC_%D0%B3%D1%83%D0%B1%D0%B8%D1%82_%D1%83%D1%85%D0%BE%D0%B6%D0%B5%D0%BD%D0%BD%D1%8B%D0%B5_%D1%81%D0%B0%D0%B4%D1%8B' target='_blank'>
available in&nbsp;Russian</a>.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://ciechanow.ski/archives/' target='_blank'>
Articles by&nbsp;Bartosz Ciechanowski
</a>
</strong>
</header>
<section class='description'>
Interactive articles about physics, math, and engineering.
It's probably the best website on&nbsp;the entire internet.<br>
My&nbsp;favorite post is&nbsp;the one about
<a href='https://ciechanow.ski/bicycle/' target='_blank'>bicycles</a>.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://suricrasia.online/iceberg/' target='_blank'>
The Cursed Computer Iceberg Meme
</a>
</strong>
</header>
<section class='description'>
An&nbsp;endless hall of&nbsp;shame and weirdness of&nbsp;computers.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://ncase.me/trust/' target='_blank'>
The Evolution of&nbsp;Trust
</a>
</strong>
</header>
<section class='description'>
A&nbsp;briliant interactive guide to&nbsp;the game theory
of&nbsp;why and how we&nbsp;trust each other.<br>
The rest of&nbsp;this site is&nbsp;also pretty good.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://iknowwhatyoudownload.com/' target='_blank'>
I&nbsp;Know What You Download
</a>
</strong>
</header>
<section class='description'>
Torrenting can leave traces.<br>
Check torrent downloads and distributions
for your own or&nbsp;your neighbor's IP&nbsp;address.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://encore.dev/blog/retries' target='_blank'>
Retries
</a>
</strong>
</header>
<section class='description'>
Requests over the network can fail.<br>
An&nbsp;interactive study of&nbsp;common retry methods for developers.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://hadihariri.com/2014/06/24/no-tabs-in-intellij-idea/' target='_blank'>
No&nbsp;Tabs in&nbsp;IntelliJ IDEA
</a>
</strong>
</header>
<section class='description'>
“There are many ways to&nbsp;navigate a&nbsp;project
inside IntelliJ IDEA (or&nbsp;any other editor)
that doesnt necessarily include having to&nbsp;look
through a&nbsp;list of&nbsp;tabs and figure out
where you have to&nbsp;click next.”<br>
Post from the VP&nbsp;of&nbsp;Program Management at&nbsp;JetBrains.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://sfwriter.com/wordstar.htm' target='_blank'>
An&nbsp;Interface Designed for Touch Typists
</a>
</strong>
</header>
<section class='description'>
If&nbsp;you think VIM is&nbsp;insane,
you should definitely read about WordStar,
which is&nbsp;still quite popular among many fiction writers.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://news.ycombinator.com/item?id=42492508' target='_blank'>
Ask HN: Programmers who don't use autocomplete/LSP, how do&nbsp;you do&nbsp;it?
</a>
</strong>
</header>
<section class='description'>
Different opinions on&nbsp;writing code
without using <del>overcomplicated</del> advanced tools.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://sneak.berlin/20201112/your-computer-isnt-yours/' target='_blank'>
Your Computer Isn't Yours
</a>
</strong>
</header>
<section class='description'>
An&nbsp;investigation into one of&nbsp;the many reasons why
no&nbsp;one should use products from Apple.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://www.yr.no/en/' target='_blank'>
Yr&nbsp;from NRK and Meteorologisk Institutt
</a>
</strong>
</header>
<section class='description'>
A&nbsp;weather forecast site with a&nbsp;no-nonsense interface.<br>
Direct links:
<a href='https://www.yr.no/en/forecast/graph/2-792680/Serbia/Central%20Serbia/Belgrade/Belgrade' target='_blank'>
Belgrade</a>,
<a href='https://www.yr.no/en/forecast/graph/2-745044/Republic%20of%20T%C3%BCrkiye/Istanbul/Istanbul' target='_blank'>
Istanbul</a> and
<a href='https://www.yr.no/en/forecast/graph/2-1486209/Russia/Sverdlovsk%20Oblast/Yekaterinburg' target='_blank'>
Yekaterinburg</a>.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://hoodmaps.com/' target='_blank'>
Hoodmaps
</a>
</strong>
</header>
<section class='description'>
A&nbsp;crowdsourced map to&nbsp;navigate cities
using marked areas and user-generated tags.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://shademap.app' target='_blank'>
ShadeMap
</a>
</strong>
</header>
<section class='description'>
This service calculates shadows from mountains, buildings, and trees
for any date and time, and displays them on&nbsp;a&nbsp;map.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://www.numbeo.com/cost-of-living/comparison.jsp' target='_blank'>
Cost of&nbsp;Living Comparison
</a>
</strong>
</header>
<section class='description'>
A&nbsp;comparison tool lets you compare
the affordability of&nbsp;two cities side-by-side.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://www.cia.gov/the-world-factbook/' target='_blank'>
The World Factbook
</a>
</strong>
</header>
<section class='description'>
A&nbsp;massive CIA database on&nbsp;almost every country
in&nbsp;the world.<br>
Handy when you need to&nbsp;check what kind
of&nbsp;power outlets a&nbsp;country uses before you get there.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://refactoringenglish.com/chapters/rules-for-software-tutorials/' target='_blank'>
Rules for Writing Software Tutorials
</a>
</strong>
</header>
<section class='description'>
Most software tutorials suck. Here's how to&nbsp;make one that doesn't.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://en.wikipedia.org/wiki/Pangram' target='_blank'>
Pangram
</a>
</strong>
</header>
<section class='description'>
A&nbsp;sentence using every letter of&nbsp;a&nbsp;given alphabet
at&nbsp;least once.<br>
<a href='https://www.artlebedev.ru/kovodstvo/sections/33/' target='_blank'>
An&nbsp;additional list in&nbsp;Russian and other languages</a>.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
about:translations
</strong>
</header>
<section class='description'>
Firefox has a&nbsp;built-in translator.
Not so&nbsp;smart, but works offline.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://datagubbe.se/noconf/' target='_blank'>
No&nbsp;Config for Old Men
</a>
</strong>
</header>
<section class='description'>
A&nbsp;rant about how modern software wont let you
customize it&nbsp;anymore.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://webcompat.com/' target='_blank'>
Webcompat.com
</a>
</strong>
</header>
<section class='description'>
Bug reporting for the web.<br>
If&nbsp;a&nbsp;site breaks in&nbsp;one browser but not another,
its a&nbsp;web compatibility&nbsp;bug. Report it.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://jsfuck.com/' target='_blank'>
JSFuck
</a>
</strong>
</header>
<section class='description'>
An&nbsp;esoteric and educational programming style
based on&nbsp;the atomic parts of&nbsp;JavaScript.<br>
It&nbsp;uses only six different
characters to&nbsp;write and execute code.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://paulbutler.org/2025/smuggling-arbitrary-data-through-an-emoji/' target='_blank'>
Smuggling arbitrary data through an&nbsp;emoji
</a>
</strong>
</header>
<section class='description'>
Unicode is&nbsp;broken.
You can encode data in&nbsp;any unicode character.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href='https://informationisbeautiful.net/visualizations/common-mythconceptions' target='_blank'>
Common Mythconceptions
</a>
</strong>
</header>
<section class='description'>
A&nbsp;list of&nbsp;the worlds biggest
myths and misconceptions&nbsp;— with myth-busting included.
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
<a href="https://en.wikipedia.org/wiki/A_Mathematician's_Lament">
A&nbsp;Mathematicians Lament&nbsp;— by&nbsp;Paul Lockhart
</a>
</strong>
</header>
<section class='description'>
A&nbsp;passionate critique of&nbsp;how math is&nbsp;taught
and a&nbsp;vision of&nbsp;how beautiful
it&nbsp;could be&nbsp;instead.<br>
Also <a href='https://www.nbspace.ru/math/' target='_blank'>
available in&nbsp;Russian</a>.
</section>
</article>
</li>
</ul>
</article>
</main>
<footer>
</footer>
<script async
data-goatcounter="https://he4et.goatcounter.com/count"
src="https://gc.zgo.at/count.js"></script>
</body>
</html>

View file

@ -0,0 +1,25 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta
name="description"
content="Redirect to '/posts/#2020'.">
<meta
http-equiv="Refresh"
content="0; URL=/posts/#2020">
<title>
Redirect | oddsquat
</title>
</head>
<body>
<main>
Redirect to
<a
style="color: inherit;"
href="/posts/#2020">
/posts/#2020
</a>
</main>
</body>
</html>

View file

@ -0,0 +1,123 @@
<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="utf-8">
<meta
name="viewport"
content="width=device-width, initial-scale=1.0">
<link rel="icon" href="/favicon.ico" sizes="32x32">
<link rel="icon" href="/icon.svg" type="image/svg+xml">
<title>
initial post | oddsquat
</title>
<meta name="description" content="Первый пост в этом фэнзине, рассказывающий о его внутреннем устойстве.">
<link rel="preload" href="/fonts/open_sans_condensed-32.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans_condensed-27.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-25.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-24.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-17.woff2" as="font" type="font/woff2" crossorigin>
<link rel="stylesheet" type="text/css" href="/css/fonts.css">
<link rel="stylesheet" type="text/css" href="/css/typography.css">
<link rel="stylesheet" type="text/css" href="/css/main.css">
</head>
<body>
<div class="stripesContainer">
<div class="stripes">
</div>
</div>
<header>
<nav>
<ul>
<li><a href="/">oddsquat</a></li>
<li><a href="/posts/">
posts</a></li>
<li><a href="/posts/#2020">
2020</a></li>
<li>initial post</li>
</ul>
</nav>
</header>
<main>
<article>
<h1 id="initial-post">Initial Post</h1>
<p><strong>Oddsquat</strong>&nbsp;— мой маленький личный фэнзин про эксперименты, код и&nbsp;прочий киберпанк. Обычно такие сайты называются блогами, но&nbsp;в&nbsp;слове «фэнзин» есть приятный отголосок панк-культуры и&nbsp;её&nbsp;неотъемлемой DIY-составляющей.</p>
<p>Основные причины, побудившие меня на&nbsp;создание своего уютного куска интернета:</p>
<ul>
<li>Хочется писать буквы, а&nbsp;возвращаться в&nbsp;ЖЖ&nbsp;не&nbsp;хочется.</li>
<li>Фронтендер без портфолио&nbsp;— подозрительный фронтендер.</li>
<li>Современный веб&nbsp;— памятник оверинженирингу. Лендинг с&nbsp;двумя абзацами текста, тремя картинками и&nbsp;мегабайтным бандлом из&nbsp;модных библиотек&nbsp;— одновременно безумие и&nbsp;норма в&nbsp;текущих реалиях. Мне больно на&nbsp;это смотреть, поэтому пришлось строить себе персональный оазис.</li>
</ul>
<p>В&nbsp;первом посте хочется рассказать, какие инструменты были использованы для создания этого сайта, какие решения были приняты и&nbsp;почему.</p>
<h2 id="-">Название</h2>
<p>Я&nbsp;вырос в&nbsp;девяностые, поэтому квикимобиль, бэтпещера и&nbsp;пузиблинчики для меня не&nbsp;пустой звук, а&nbsp;образец системы нейминга. Вот, например, у&nbsp;меня есть <a href="https://github.com/He4eT/oddkb" target="_blank">oddkb</a>.</p>
<p>Свою квартиру с&nbsp;момента заселения я&nbsp;называю oddsquat (даже локация в&nbsp;Foursquare была), так пусть теперь и&nbsp;мой форпост в&nbsp;сети называется так же.</p>
<p>Назвал сайт в&nbsp;честь SSID домашнего Wi-Fi, потому что не&nbsp;смог придумать более достойного названия :)</p>
<h2 id="-">Платформа</h2>
<p>Для статического сайта не&nbsp;нужен серверный код, поэтому WordPress и&nbsp;прочие CMS в&nbsp;качестве платформы я&nbsp;даже не&nbsp;рассматривал.</p>
<p>Про генераторы статических сайтов раньше слышал, но&nbsp;подробно не&nbsp;изучал. Их&nbsp;оказалось так много (тут есть <a href="https://jamstack.org/generators/">длинный список</a>), что даже страшно.</p>
<p>Посмотрев на&nbsp;самые популярные решения, я&nbsp;понял, что как-то неправильно понимаю значение термина «генератор статических сайтов», потому что все хором предлагают мне сгенерировать Progressive Web Application из&nbsp;React-компонентов с&nbsp;импортом данных из&nbsp;GraphQL-сервера вместо россыпи HTML-документов.</p>
<p>Уверен, что уютный бложик&nbsp;— это точно не&nbsp;Web&nbsp;Application, а&nbsp;от&nbsp;Progressive&nbsp;в&nbsp;данном случае всем будет только хуже: искусственные трудности с&nbsp;роутингом, серверным рендерингом и&nbsp;сохранением позиции скрола успешно решены, когда каждая страница&nbsp;— это отдельный документ. Браузеры восхитительно умеют работать с&nbsp;HTML-документами!</p>
<p>После непродолжительных поисков был найден <a href="https://doug2k1.github.io/nanogen/">Nanogen</a>, который делает именно то, что нужно, и&nbsp;не&nbsp;похож на&nbsp;космический корабль:</p>
<ul>
<li>Умеет Markdown и&nbsp;HTML (ejs);</li>
<li>Имеет очень гибкую систему шаблонов;</li>
<li>Не&nbsp;выходит за&nbsp;рамки стека Node.js.</li>
</ul>
<p>Да, в&nbsp;репозитории проекта давно не&nbsp;было коммитов, но&nbsp;хочется думать, что это по&nbsp;причине надёжности и&nbsp;закончености :)</p>
<h2 id="-">Типографика</h2>
<p>Я&nbsp;люблю текст и&nbsp;не&nbsp;умею в&nbsp;дизайн. Oddsquat&nbsp;— проект про буквы, значит, буквы должны быть красивыми и&nbsp;удобными.</p>
<p>К&nbsp;теме типографики в&nbsp;вебе я&nbsp;подходил несколько раз, но&nbsp;безуспешно. Не&nbsp;получается структурировать и&nbsp;сохранить в&nbsp;голове все эти сакральные знания про кернинг и&nbsp;засечки, потому что не&nbsp;вижу никакой связи между теорией и&nbsp;практикой.</p>
<p>Очередное погружение системных знаний опять не&nbsp;принесло, зато принесло удобный инструмент: <a href="https://github.com/KyleAMathews/typography.js">Typography.js</a>.</p>
<p>Этот тулкит позволяет, покрутив ручки <a href="http://kyleamathews.github.io/typography.js/">интерактивного демо</a>, получить новое, но&nbsp;при этом гармоничное сочетание абзацев, заголовков и&nbsp;отступов между ними.
Идеальный инструмент для тех, кто хочет поиграть со&nbsp;шрифтами, но&nbsp;не&nbsp;до&nbsp;конца понимает, как.</p>
<p>Авторы настолько заботливые, что даже подключают <code>normalize.css</code> при генерации своих стилей, снимая с&nbsp;вас ещё одну головную боль. Благодаря им&nbsp;весь мой дополнительный css для стилизации сайта уложился в&nbsp;сто строк кода и&nbsp;хорошо работает в&nbsp;любых браузерах и&nbsp;на&nbsp;любых экранах.</p>
<p>Со&nbsp;шрифтами всё просто:</p>
<ul>
<li><strong>Open Sans</strong> для текста и&nbsp;<strong>Open Sans Condensed</strong> для заголовков, потому что мне нравится слово «Open»;</li>
<li><strong>Fira Code</strong> для кода, потому что лигатуры (<code>--&gt;</code>, <code>!==</code>)&nbsp;— это красиво.</li>
</ul>
<h2 id="-">Аналитика</h2>
<p>Я&nbsp;долго думал, можно&nbsp;ли собирать аналитику просмотров, или нужно играть в&nbsp;идеальный веб до&nbsp;конца и&nbsp;полностью отказаться от&nbsp;слежки за&nbsp;пользователями. С&nbsp;одной стороны высокая идея, с&nbsp;другой&nbsp;— любопытство.</p>
<p>После непродолжительного исследования пришёл к&nbsp;выводу, что Метрика и&nbsp;Аналитика от&nbsp;поисковых гигантов мне точно не&nbsp;подходят, а&nbsp;вот автор <a href="https://goatcounter.com/">GoatCounter</a> полностью понимает мою боль.</p>
<p><a href="https://www.goatcounter.com/why/">Why I&nbsp;made GoatCounter</a>&nbsp;— отличный пост, где создатель сервиса ответил на&nbsp;все вопросы, которые у&nbsp;меня к&nbsp;нему возникли. Вот, например, замечательный абзац про причины бесплатности начального тарифа:</p>
<blockquote>
<p>I&nbsp;think its important to&nbsp;make the barrier of&nbsp;entry for software like this low as&nbsp;feasible to&nbsp;make actual meaningful inroads to&nbsp;“de-Google-fi” the internet a&nbsp;bit, and make pervasive tracking less common. Making it&nbsp;freely available (for personal use) is&nbsp;part of&nbsp;that.</p>
</blockquote>
<h2 id="-">Содержание</h2>
<p>Самое главное. С&nbsp;формой и&nbsp;техническими вопросами всё ясно, но&nbsp;что&nbsp;же я&nbsp;буду складывать внутрь? Пока план такой:</p>
<ul>
<li>Я&nbsp;довольно часто изучаю штуки из&nbsp;разных областей и&nbsp;хочу описывать эти опыты. Вот, например, описал создание легковесного сайта.</li>
<li>Мне нравится настраивать инструменты и&nbsp;рассказывать об&nbsp;этом.</li>
<li>Есть несколько почтовых рассылок, которые я&nbsp;очень хочу начать переводить, чтобы начать читать.</li>
</ul>
<p>Признаюсь, что был очарован сайтом от&nbsp;ребят из&nbsp;команды <a href="https://100r.co/site/home.html">Hundred Rabbits</a> и&nbsp;захотел такое&nbsp;же, только своё.</p>
<p>Stay tuned!</p>
</article>
</main>
<footer>
2020-11-08
</footer>
<script async
data-goatcounter="https://he4et.goatcounter.com/count"
src="https://gc.zgo.at/count.js"></script>
</body>
</html>

View file

@ -0,0 +1,109 @@
<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="utf-8">
<meta
name="viewport"
content="width=device-width, initial-scale=1.0">
<link rel="icon" href="/favicon.ico" sizes="32x32">
<link rel="icon" href="/icon.svg" type="image/svg+xml">
<title>
typographic linter | oddsquat
</title>
<meta name="description" content="Prettier для текста. Автоматизация рутинной типографики.">
<link rel="preload" href="/fonts/open_sans_condensed-32.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans_condensed-27.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-25.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-24.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-17.woff2" as="font" type="font/woff2" crossorigin>
<link rel="stylesheet" type="text/css" href="/css/fonts.css">
<link rel="stylesheet" type="text/css" href="/css/typography.css">
<link rel="stylesheet" type="text/css" href="/css/main.css">
</head>
<body>
<div class="stripesContainer">
<div class="stripes">
</div>
</div>
<header>
<nav>
<ul>
<li><a href="/">oddsquat</a></li>
<li><a href="/posts/">
posts</a></li>
<li><a href="/posts/#2020">
2020</a></li>
<li>typographic linter</li>
</ul>
</nav>
</header>
<main>
<article>
<h1 id="-code-style">Типографика как code style</h1>
<h2 id="-">Основы</h2>
<p>Для того, чтобы тексты было удобно читать и&nbsp;неудобно писать, человечество придумало разные правила. С&nbsp;орфографией и&nbsp;пунктуацией всё понятно, но&nbsp;про типографические правила говорят редко.</p>
<p>Типографика&nbsp;— набор правил вёрстки текста, призванных повысить эстетику и&nbsp;читаемость. Именно в&nbsp;таком порядке, потому что люди сначала замечают текст и&nbsp;только потом начинают читать.</p>
<p>Про шрифты, отступы и&nbsp;прочие кернинги в&nbsp;этот раз говорить не&nbsp;будем, потому что мне понравилось крутить ползунки в&nbsp;<a href="https://github.com/KyleAMathews/typography.js">Typography.js</a> и&nbsp;не&nbsp;переживать об&nbsp;эстетике.</p>
<p>Разговор пойдёт про висячие предлоги и&nbsp;прочие тире с&nbsp;кавычками.</p>
<h2 id="-">Проблематика</h2>
<p>Сайты в&nbsp;интернете делятся на&nbsp;два типа: те, кто запаривается за&nbsp;подготовку текстов, и&nbsp;те, кто забивает. <a href="https://meduza.io/">Meduza.io</a> расставляет неразрывные пробелы в&nbsp;текстах новостей, а&nbsp;<a href="https://www.rbc.ru/">rbc.ru</a>&nbsp;— нет. Это не&nbsp;единственное отличие этих новостных порталов, но&nbsp;очень знаковое, как мне кажется.</p>
<h3 id="-">Нужно забить!</h3>
<p>Я&nbsp;прекрасно понимаю тех, кто не&nbsp;запаривается. Часть не&nbsp;знает, часть забивает (<a href="https://vas3k.ru/">Вастрик</a>, например), а&nbsp;у&nbsp;остальных user-generated content, который довольно рискованно автоматически форматировать. Аргументы для каждой группы:</p>
<ul>
<li>И&nbsp;так всё понятно.</li>
<li>Условный Markdown со&nbsp;спецсимволами теряет половину обаяния.</li>
<li>Правильные автоматические кавычки-ёлочки не&nbsp;сделают из&nbsp;комментария в&nbsp;Facebook литературный памятник, зато случайный японский эмотикон может разрушить цивилизацию: <br>
<code>Прости ^_^&quot; Забыл купить &quot;Доширак&quot;</code> превращается в&nbsp;<br>
<code>Прости ^_^« Мы испортили »Твой текст«</code>.</li>
<li>У&nbsp;студентов должен быть отдельный курс по&nbsp;расшифровке смайликов и&nbsp;компилированию C++ из&nbsp;чатов. Бонусный аргумент.</li>
</ul>
<h3 id="-">Нужно запариться!</h3>
<p>Википедия утверждает, что <a href="https://ru.wikipedia.org/wiki/%D0%A2%D0%B8%D0%BF%D0%BE%D0%B3%D1%80%D0%B0%D1%84%D0%B8%D0%BA%D0%B0">типографика</a>&nbsp;— это «свод строгих правил», но&nbsp;список не&nbsp;показывает и&nbsp;ссылок не&nbsp;даёт. Стандартом де-факто в&nbsp;рунете являются правила из&nbsp;<a href="https://www.artlebedev.ru/kovodstvo/sections/62/">§&nbsp;62&nbsp;«Ководства»</a>. С&nbsp;ними или соглашаются, или <a href="https://medium.com/@kapanaga/62-6c664105dd30">громко спорят с&nbsp;некоторыми</a>.</p>
<p>Пусть мне и&nbsp;не&nbsp;нравится полное отсутствие у&nbsp;Лебедева обоснований или ссылок на&nbsp;источники, но&nbsp;самому погружаться в&nbsp;историю вопроса и&nbsp;читать какой-нибудь авторитетный <a href="https://www.artlebedev.ru/izdal/spravochnik-izdatelya-i-avtora-2017/">«Справочник издателя и&nbsp;автора»</a> страшно: в&nbsp;нём 1010&nbsp;страниц.</p>
<p>Авторы, которые хотят радовать читателей с&nbsp;помощью тире, обычно не&nbsp;пишут в&nbsp;блокноте (мне так кажется) или носят свои тексты из&nbsp;блокнота в&nbsp;<a href="https://www.artlebedev.ru/typograf/">Типограф</a> от&nbsp;Артемия Лебедева, а&nbsp;потом назад. Про первых я&nbsp;ничего не&nbsp;знаю, а&nbsp;ко&nbsp;вторым сам отношусь, когда нужно причесать один или два текста.</p>
<p>У&nbsp;Типографа и&nbsp;аналогичных веб-сервисов есть фундаментальные проблемы:</p>
<ul>
<li>Копировать текст из&nbsp;редактора в&nbsp;браузер, а&nbsp;потом назад&nbsp;— неудобно.</li>
<li>Сервис может быть офлайн в&nbsp;неподходящий момент, я&nbsp;тоже.</li>
<li>Сервис может читать мои тексты до&nbsp;публикации.</li>
<li>Некоторые тексты никому нельзя показывать (по&nbsp;разным причинам).</li>
</ul>
<p>Признаюсь, что раньше я&nbsp;ни&nbsp;разу не&nbsp;думал об&nbsp;использовании типографа вне браузера, но&nbsp;как только образовалась перспектива заниматься этим на&nbsp;постоянной основе, стало понятно, что копировать текст из&nbsp;редактора в&nbsp;браузер и&nbsp;назад&nbsp;— не&nbsp;самое оптимальное решение и&nbsp;нужно что-то с&nbsp;этим делать.</p>
<h2 id="-">Решение</h2>
<p>Очевидный вариант&nbsp;— научить текстовый редактор автоматически расставлять неразрывные пробелы, исправлять мелкие опечатки, приводить кавычки к&nbsp;правильному виду, заменять дефисы на&nbsp;тире в&nbsp;нужных местах и&nbsp;многое другое. <br>
Вот <a href="https://marketplace.visualstudio.com/items?itemName=rusnasonov.vscode-typograf">плагин для VS&nbsp;Code</a>.</p>
<p>Мне больше нравится другой подход. Мы&nbsp;уже давно используем линтеры для языков программирования, давайте использовать их&nbsp;и&nbsp;для контента.</p>
<p>Конечно, я&nbsp;не&nbsp;первый, кто так подумал. Плагин выше построен на&nbsp;основе замечательной библиотеки <a href="https://github.com/typograf/typograf">typograf</a> и&nbsp;прямо в&nbsp;README.md файле этого проекта можно найти ссылки на&nbsp;плагины для Babel, Gulp и&nbsp;Grunt.</p>
<p>Библиотека очень гибко настраивается, содержит <a href="https://github.com/typograf/typograf/blob/dev/docs/RULES.ru.md">сотню готовых правил</a> и&nbsp;позволяет легко добавлять кастомные.</p>
<p>В&nbsp;комплекте есть cli-утилита, которая умеет читать файлы, форматировать их&nbsp;и&nbsp;выводить результат в&nbsp;терминал, но&nbsp;почему-то не&nbsp;умеет файл перезаписывать. Поэтому для своих целей я&nbsp;написал небольшой скрипт, который, получив локаль и&nbsp;имя файла, изменяет его содержимое. С&nbsp;правилами тоже пришлось немного поиграть, потому что дефолтные принимают списки за&nbsp;диалоги и&nbsp;ломают markdown-разметку.</p>
<p>Теперь для расстановки всех хитрых значков не&nbsp;нужно ходить в&nbsp;браузер, достаточно просто запустить скрипт, посмотреть с&nbsp;помощью <code>git diff</code> на&nbsp;результат и&nbsp;закоммитить нужные изменения.</p>
<p>Красивые тексты лучше некрасивых.</p>
</article>
</main>
<footer>
2020-11-18
</footer>
<script async
data-goatcounter="https://he4et.goatcounter.com/count"
src="https://gc.zgo.at/count.js"></script>
</body>
</html>

View file

@ -0,0 +1,25 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta
name="description"
content="Redirect to '/posts/#2024'.">
<meta
http-equiv="Refresh"
content="0; URL=/posts/#2024">
<title>
Redirect | oddsquat
</title>
</head>
<body>
<main>
Redirect to
<a
style="color: inherit;"
href="/posts/#2024">
/posts/#2024
</a>
</main>
</body>
</html>

View file

@ -0,0 +1,317 @@
<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="utf-8">
<meta
name="viewport"
content="width=device-width, initial-scale=1.0">
<link rel="icon" href="/favicon.ico" sizes="32x32">
<link rel="icon" href="/icon.svg" type="image/svg+xml">
<title>
selfhosted LLM | oddsquat
</title>
<meta name="description" content="Персональные LLM в docker-контейнере на твоём компьютере.">
<link rel="preload" href="/fonts/open_sans_condensed-32.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans_condensed-27.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-25.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-24.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-17.woff2" as="font" type="font/woff2" crossorigin>
<link rel="stylesheet" type="text/css" href="/css/fonts.css">
<link rel="stylesheet" type="text/css" href="/css/typography.css">
<link rel="stylesheet" type="text/css" href="/css/main.css">
</head>
<body>
<div class="stripesContainer">
<div class="stripes">
</div>
</div>
<header>
<nav>
<ul>
<li><a href="/">oddsquat</a></li>
<li><a href="/posts/">
posts</a></li>
<li><a href="/posts/#2024">
2024</a></li>
<li>selfhosted LLM</li>
</ul>
</nav>
</header>
<main>
<article>
<h1 id="your-own-private-large-language-models">Your Own Private Large Language Models</h1>
<p>С&nbsp;одной стороны, я&nbsp;сомневаюсь, что Большие Языковые Модели (LLM) смогут однажды эволюционировать в&nbsp;AGI. С&nbsp;другой&nbsp;— я&nbsp;по-настоящему впечатлён тем, что щепотка статистики справляется с&nbsp;написанием текстов лучше меня.</p>
<p>В&nbsp;любом случае, джинна обратно в&nbsp;бутылку уже не&nbsp;вернуть, и&nbsp;все те&nbsp;письма в&nbsp;различные организации, которые я&nbsp;не&nbsp;хочу писать сам, будут теперь написаны месивом из&nbsp;байтиков.</p>
<p>Действительно пугает меня в&nbsp;этой ситуации только то, что флагманом новой эры почему-то стала компания OpenAI, которая, вопреки названию, совершенно не&nbsp;Open.
Множество компаний и&nbsp;людей вписали их&nbsp;продукты в&nbsp;свою рутину и&nbsp;не&nbsp;страшатся такой неподконтрольной зависимости.</p>
<p>Я&nbsp;так не&nbsp;могу. К&nbsp;счастью, я&nbsp;не&nbsp;один такой, и&nbsp;на&nbsp;данный момент уже есть множество альтернативных моделей от&nbsp;разных вендоров. Они отличаются друг от&nbsp;друга качеством, размером, возможностями и&nbsp;лицензиями, так что при желании можно надолго занять себя знакомством с&nbsp;обширным ассортиментом. Например, на&nbsp;портале <a href="https://huggingface.co/">HuggingFace</a>, который можно описать как «GitHub для LLM и&nbsp;всего, что вокруг».</p>
<p>Должен признаться, что очень слабо разбираюсь в&nbsp;параметрах и&nbsp;характеристиках языковых моделей, но&nbsp;оказалось, что для того, чтобы начать, эти знания не&nbsp;так уж&nbsp;и&nbsp;необходимы.</p>
<p>Ниже инструкция, как запустить LLM на&nbsp;своём железе, как упаковать всё это в&nbsp;docker-контейнер, чтобы не&nbsp;размазать случайно по&nbsp;всей файловой системе, как получить совместимый с&nbsp;OpenAI API и&nbsp;как потом этим пользоваться.</p>
<hr>
<ul>
<li><a href="#setup">Установка и&nbsp;настройка</a><ul>
<li><a href="#setup-ollama">Установка Ollama</a></li>
<li><a href="#setup-model">Загрузка модели и&nbsp;диалог с&nbsp;ней</a></li>
<li><a href="#custom-model">Кастомные модели и&nbsp;их&nbsp;тонкая настройка</a></li>
</ul>
</li>
<li><a href="#usage">Использование</a><ul>
<li><a href="#fake-open-ai">Мимикрия под API от&nbsp;OpenAI</a></li>
<li><a href="#ollama-nvim">Интеграция с&nbsp;NeoVim</a></li>
</ul>
</li>
<li><a href="#update-delete">Обновление и&nbsp;удаление</a></li>
<li><a href="#performance">Производительность</a></li>
<li><a href="#why">Зачем всё это нужно?</a></li>
</ul>
<hr>
<h2 id='setup'>
Установка и&nbsp;настройка
</h2>
<p>Существует несколько продуктов, которые стараются избавить пользователя от&nbsp;головной боли и&nbsp;возни с&nbsp;инфраструктурой. Мне понятнее всего оказался проект <a href="https://ollama.ai/">Ollama</a>, с&nbsp;ним мы&nbsp;и&nbsp;будем экспериментировать.</p>
<p>Кроме бинарников для Linux и&nbsp;MacOS, они <a href="https://ollama.ai/blog/ollama-is-now-available-as-an-official-docker-image">предоставляют</a> официальный <a href="https://hub.docker.com/r/ollama/ollama">docker-образ</a>, работу с&nbsp;которым я&nbsp;и&nbsp;опишу.</p>
<p>Использование docker-контейнеров, к&nbsp;сожалению, слегка усложняет взаимодействие с&nbsp;Ollama, так что большая часть текста и&nbsp;кода в&nbsp;этом посте посвящены решению проблем, которые, по&nbsp;сути, я&nbsp;придумал себе сам.</p>
<h3 id='setup-ollama'>
Установка Ollama
</h3>
<p>Для создания и&nbsp;первого запуска контейнера нужно выполнить команду:</p>
<pre><code>docker run -d -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollama</code></pre><p>Счастливые владельцы видеокарт от&nbsp;Nvidia могут установить <a href="https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html#installation">Nvidia container toolkit</a> и&nbsp;активировать поддержку GPU с&nbsp;помощью флага <code>--gpus=all</code>.</p>
<p>После создания запускать и&nbsp;останавливать контейнер <code>ollama</code> можно так:</p>
<pre><code>docker start ollama
docker stop ollama</code></pre><p>Контейнер предоставляет доступ к&nbsp;<a href="https://github.com/jmorganca/ollama/blob/main/docs/api.md">Ollama API</a> на&nbsp;11434&nbsp;порту, а&nbsp;также позволяет устанавливать и&nbsp;общаться с&nbsp;установленными LLM через терминал.</p>
<h3 id='setup-model'>
Загрузка модели и&nbsp;диалог с&nbsp;ней
</h3>
<p>Ollama позволяет запускать любые GGUF, PyTorch или Safetensors модели (что&nbsp;бы это ни&nbsp;значило), но&nbsp;самый простой путь&nbsp;— загрузка моделей из&nbsp;специальной <a href="https://ollama.ai/library">библиотеки</a>.</p>
<p>Для того, чтобы скачать модель и&nbsp;начать с&nbsp;ней диалог, нужно выполнить команду:</p>
<pre><code>docker exec -it ollama ollama run mistral</code></pre><p>Вместо <code>mistral</code> от&nbsp;одноимённой комании можно выбрать любую другую модель из&nbsp;библиотеки, например, легкую <code>phi</code> от&nbsp;Microsoft Research.</p>
<p>Кроме <code>run</code> доступны также <code>list</code>, <code>pull</code> и&nbsp;<code>rm</code> для просмотра списка, скачивания и&nbsp;удаления моделей соответственно.</p>
<p>Чтобы не&nbsp;писать такие длинные заклинания каждый раз, я&nbsp;добавил в&nbsp;<code>.zshrc</code> пару алиасов:</p>
<pre><code>alias summonable=&#39;docker exec -it ollama ollama list&#39;
alias summon=&#39;clear &amp;&amp; docker exec -it ollama ollama run&#39;</code></pre><p>Теперь можно смотреть на&nbsp;список установленных моделей и&nbsp;запускать диалог с&nbsp;выбранной:</p>
<pre><code>summonable
summon phi</code></pre><h3 id='custom-model'>
Кастомные модели и&nbsp;их&nbsp;тонкая настройка
</h3>
<p>Ollama позволяет на&nbsp;основе существующих создавать производные модели с&nbsp;заранее определёнными инструкциями или параметрами. Для этого нужно создать специальный файл, в&nbsp;котором указана родительская модель и&nbsp;определены желаемые значения параметров. Подробнее о&nbsp;формате этих файлов можно прочесть в&nbsp;документации: <a href="https://github.com/jmorganca/ollama/blob/main/docs/modelfile.md">Modelfile</a>.</p>
<blockquote>
<p>В&nbsp;какой-то момент Ollama Web UI&nbsp;превратился в&nbsp;Open WebUI, а&nbsp;OllamaHub прекратил существовать. Все ссылки в&nbsp;следующем абзаце больше не&nbsp;представляют какой-либо ценности.</p>
</blockquote>
<p>Чтобы посмотреть, как должен выглядеть Modelfile, можно посетить <a href="https://ollamahub.com/">OllamaHub</a> от&nbsp;разработчиков стороннего <a href="https://github.com/ollama-webui/ollama-webui/">Ollama Web UI</a>. На&nbsp;сайте есть <a href="https://ollamahub.com/m/smoothbrainape/hu-tao:latest">примеры очень тонкой настройки множества параметров</a> модели для соответствия образу конкретного персонажа, но&nbsp;в&nbsp;качестве образца я&nbsp;буду использовать небольшой <a href="https://ollamahub.com/m/kamjin/english-teacher:latest">English Teacher Modelfile</a>:</p>
<h4 id="englishteacher-modelfile">EnglishTeacher.Modelfile</h4>
<pre><code>FROM llama2
SYSTEM &quot;&quot;&quot;
I want you to act as a English teacher.
Your main responsibility will be to instruct me in all aspects of English, including grammar, vocabulary, reading, writing and speaking.
You should always take the initiative to correct my mistakes in grammar and vocabulary, and you can give me two or three examples at any appropriate time to help me understand better.
&quot;&quot;&quot;</code></pre><p>Вообще, для загрузки кастомной модели достаточно выполнить команду <code>create</code>, но&nbsp;в&nbsp;случае использования Ollama внутри docker-контейнера возникает необходимость каким-то образом файл с&nbsp;моделью в&nbsp;этот контейнер передать.</p>
<p>Для решения этой проблемы я&nbsp;набросал небольшой bash-скрипт:</p>
<h4 id="applymodelfile-bash">applyModelfile.bash</h4>
<pre><code class="language-bash">#!/bin/bash
containerId=$(docker ps | grep ollama/ollama | cut -d&#39; &#39; -f1)
echo &quot;Container ID:&quot;
echo $containerId
echo &quot;&quot;
if [ -z &quot;$containerId&quot; ]; then
echo &quot;Container does not exist.&quot;
exit 1
fi
modelName=$1
echo &quot;Model name:&quot;
echo $modelName
echo
sourcePath=&quot;./models/${modelName}.Modefile&quot;
targetPath=&quot;/home/${modelName}.Modefile&quot;
if ! test -f $sourcePath; then
echo &quot;File does not exist.&quot;
echo $sourcePath
exit 1
fi
docker cp $sourcePath &quot;${containerId}:${targetPath}&quot;
clear
docker exec -it ollama ollama create $modelName -f $targetPath</code></pre>
<p>Этот скрипт нужно поместить по&nbsp;соседству с&nbsp;директорией <code>models</code> и&nbsp;сделать исполняемым с&nbsp;помощью <code>chmod +x applyModelfile.bash</code>.
Должна получиться примерно такая структура:</p>
<pre><code>├── models
│ └── EnglishTeacher.Modefile
└── applyModelfile.bash</code></pre><p>После этого модель можно загрузить в&nbsp;контейнер и&nbsp;начать с&nbsp;ней диалог:</p>
<pre><code>./applyModelfile.bash EnglishTeacher
summon EnglishTeacher</code></pre><h2 id='usage'>
Использование
</h2>
<p>Разговоры с&nbsp;галлюцинирующим искусственным интеллектом в&nbsp;терминале&nbsp;— это, конечно, волшебно, но&nbsp;потенциал больших языковых моделeй по-настоящему раскрывается, когда они начинают портить данные в&nbsp;соседних приложениях!</p>
<p>В&nbsp;<a href="https://github.com/jmorganca/ollama#community-integrations">GitHub-репозитории Ollama</a> можно найти ссылки на&nbsp;множество веб-интерфейсов, библиотек и&nbsp;плагинов для текстовых редакторов и&nbsp;прочих Obsidian&#39;ов.</p>
<p>Не&nbsp;ручаюсь за&nbsp;весь список, но&nbsp;расскажу про то, с&nbsp;чем экспериментировал сам.</p>
<h3 id='fake-open-ai'>
Мимикрия под API от&nbsp;OpenAI
</h3>
<blockquote>
<p>В&nbsp;какой-то момент <a href="https://ollama.com/blog/openai-compatibility">в&nbsp;Ollama появилась поддержка совместимости с&nbsp;форматом API от&nbsp;OpenAI</a> и&nbsp;этот раздел потерял актуальность.</p>
</blockquote>
<p>API Ollama используется в&nbsp;меньшем числе продуктов, чем API от&nbsp;OpenAI. К&nbsp;счастью, это не&nbsp;проблема: с&nbsp;помощью прокси-прослойки под названием <a href="https://github.com/BerriAI/litellm">LiteLLM</a> можно сделать их&nbsp;совместимыми. Инструкция по&nbsp;установке и&nbsp;использованию в&nbsp;общем случае есть в&nbsp;репозитории и&nbsp;довольно тривиальна, но&nbsp;мне опять потребовалось немного кода, чтобы заставить их&nbsp;работать вместе на&nbsp;моих условиях.</p>
<p>Я&nbsp;хотел, чтобы LiteLLM-прокси и&nbsp;Ollama работали на&nbsp;разных компьтерах, и&nbsp;не&nbsp;хотел ставить pip-пакеты в&nbsp;систему. В&nbsp;результате родилось решение из&nbsp;docker-файла с&nbsp;хаками и&nbsp;скрипта, который в&nbsp;нём запускается. Я&nbsp;не&nbsp;специалист в&nbsp;написании docker-файлов, так что уверен в&nbsp;неоптимальности финального решения. Точно можно и&nbsp;нужно обойтись без <code>run --net=host</code> и&nbsp;отдельного скрипта, например.</p>
<p>Несмотря на&nbsp;костыльность связки, она справляется со&nbsp;своей задачей:</p>
<h4 id="dockerfile">Dockerfile</h4>
<pre><code class="language-Dockerfile">FROM python:3.10
COPY startProxy.sh /usr/src/app/startProxy.sh
RUN chmod +x /usr/src/app/startProxy.sh
WORKDIR /usr/src/app
# Prevent ollama run attempt
RUN echo &#39;#!/bin/sh\necho &quot;$1&quot;&#39; &gt; /usr/bin/ollama &amp;&amp; \
chmod +x /usr/bin/ollama
CMD [&quot;./startProxy.sh&quot;]</code></pre>
<h4 id="startproxy-sh">startProxy.sh</h4>
<pre><code class="language-sh">#!/bin/bash
pip install litellm
litellm --model ollama/mistral --api_base http://ollama.internal:11434 --drop_params</code></pre>
<p>Собрать и&nbsp;запустить docker-контейнер можно с&nbsp;помощью этих двух команд:</p>
<pre><code class="language-sh">docker build -t diy-ollama-proxy .
docker run --net=host diy-ollama-proxy</code></pre>
<p>После запуска вы&nbsp;получите API, который совместим с&nbsp;API от&nbsp;OpenAI и&nbsp;доступен по&nbsp;адресу <code>http://localhost:8000/</code>.</p>
<h3 id='ollama-nvim'>
Интеграция с&nbsp;NeoVim
</h3>
<p>Языковые модели отлично умеют взаимодействовать с&nbsp;текстом, так что использование их&nbsp;в&nbsp;текстовом редакторе кажется разумной идеей.</p>
<p>Мне не&nbsp;очень нравится идея Copilot, который зачем-то постоянно подсовывает тебе странные куски кода. Я&nbsp;пробовал использовать <a href="https://codeium.com/">Codeium</a> в&nbsp;ручном режиме, но&nbsp;оказалось, что странные куски кода по&nbsp;запросу мне тоже не&nbsp;очень нужны. Гораздо более привлекательной мне кажется возможность выделить существующий фрагмент текста или кода и&nbsp;попросить бездушную машину что-нибудь с&nbsp;ним сделать: упростить, дополнить, изменить или даже перевести с&nbsp;одного языка на&nbsp;другой. Идеальным для такого подхода оказался <a href="https://github.com/nomnivore/ollama.nvim">плагин ollama.nvim</a>.</p>
<p>Кроме того, что он&nbsp;поддерживает кастомные промпты (в&nbsp;том числе интерактивные), он&nbsp;позволил мне обращаться к&nbsp;LLM, которая запущена на&nbsp;другом компьютере в&nbsp;локальной сети (для удобства я&nbsp;указал его адрес в&nbsp;<code>/etc/hosts/</code>).</p>
<p>Установка и&nbsp;настройка с&nbsp;использованием пакетного менеджера lazy.nvim выглядит примерно так:</p>
<pre><code>{
&#39;nomnivore/ollama.nvim&#39;,
dependencies = {
&#39;nvim-lua/plenary.nvim&#39;,
},
cmd = { &#39;Ollama&#39;, &#39;OllamaModel&#39; },
keys = {
{
&#39;&lt;leader&gt;j&#39;,
&#39;:Ollama&lt;CR&gt;&#39;,
desc = &#39;Ollama Menu&#39;,
mode = { &#39;v&#39; },
},
{
&#39;&lt;leader&gt;j&#39;,
&quot;:lua require(&#39;ollama&#39;).prompt(&#39;Generate_Code&#39;)&lt;cr&gt;&quot;,
desc = &#39;Ollama Code Generation&#39;,
mode = { &#39;n&#39; },
},
},
opts = {
model = &#39;mistral&#39;,
url = &#39;http://ollama.internal:11434&#39;, -- see /etc/hosts
prompts = {
Ask_About_Code = false,
Simplify_Code = false,
Improve_Text = {
prompt = &#39;Check the following sentence for grammar and clarity: &quot;$sel&quot;.\nRewrite it for better readability while maintaining its original meaning.&#39;,
extract = false,
action = &#39;replace&#39;,
},
Modify_Text = {
prompt = &#39;Modify this text in the following way: $input\n\n```$sel```&#39;,
extract = false,
action = &#39;replace&#39;,
},
Use_Selection_as_Prompt = {
prompt = &#39;$sel&#39;,
extract = false,
action = &#39;replace&#39;,
},
},
},
},</code></pre><p>В&nbsp;этом конфиге я&nbsp;выключил несколько дефолтных промптов и&nbsp;добавил несколько своих:</p>
<ul>
<li><code>Improve_Text</code> заменяет выделенный кусок текста «улучшенным».</li>
<li><code>Modify_Text</code> является аналогом встроенного <code>Modify_Code</code> и&nbsp;позволяет делать с&nbsp;выделенным текстом всякие глупости. Например, заменить все числа на&nbsp;слова.</li>
<li><code>Use_Selection_as_Prompt</code> просто заменяет выделенный текст на&nbsp;ответ от&nbsp;LLM.</li>
</ul>
<p>В&nbsp;итоге получается два сценария использования, оба доступны по&nbsp;<code>&lt;leader&gt; + j</code>:</p>
<ul>
<li>В&nbsp;<code>normal</code> mode плагин спрашивает меня, какой код мне нужен, и&nbsp;вставляет его.</li>
<li>В&nbsp;<code>visual</code> mode появляется меню действий над выделенным текстом.</li>
</ul>
<p>Как видно из&nbsp;конфига, я&nbsp;использую только <code>mistral</code>, но&nbsp;можно указать модель для кажого промпта и&nbsp;делегировать, например, манипуляции над кодом <code>codellama</code>, а&nbsp;операции над текстом&nbsp;<code>llama2</code>.</p>
<p>Возможность добавления кастомных промптов позволяет в&nbsp;будущем реализовать новые сценарии или вынести повторяющиеся действия в&nbsp;отдельный пункт меню или даже на&nbsp;отдельный шорткат.</p>
<h2 id='update-delete'>
Обновление и&nbsp;удаление
</h2>
<p>Для обновления и&nbsp;удаления моделей можно использовать команды <code>pull</code> и&nbsp;<code>rm</code>:</p>
<pre><code>docker exec -it ollama ollama pull mixtral
docker exec -it ollama ollama rm mistral</code></pre><p>Я&nbsp;знаю, что для обновления и&nbsp;удаления docker-образов и&nbsp;docker-контейнеров тоже есть специальные команды (это тоже <code>pull</code> и&nbsp;<code>rm</code>), но&nbsp;каждый раз ленюсь в&nbsp;этом разобраться, просто сношу всё с&nbsp;помощью утилиты <a href="https://github.com/TomasTomecek/sen">sen</a> и&nbsp;разворачиваю нужное заново.</p>
<h2 id='performance'>
Производительность
</h2>
<p>Для эксплуатации LLM требуется гораздо меньше ресурсов, чем для её&nbsp;обучения. Запустить 7b-модель средней тупости можно практически на&nbsp;любом CPU и&nbsp;8&nbsp;GB&nbsp;RAM, но&nbsp;нагрузка на&nbsp;систему и&nbsp;скорость генерации ответов часто будут далеки от&nbsp;комфортных значений.</p>
<p>Например, на&nbsp;моём немолодом Intel Core i7-10510U @ 8x 4.9GHz неаккуратный запрос к&nbsp;<code>llama2</code> может заставить систему шуршать вентиляторами пару-тройку минут. При этом <code>phi</code> на&nbsp;этом&nbsp;же процессоре способна отвечать на&nbsp;какие-нибудь не&nbsp;очень сложные вопросы практически мгновенно.</p>
<p>К&nbsp;счастью, у&nbsp;меня случайно завалялся MacBook на&nbsp;процессоре M1&nbsp;и&nbsp;он&nbsp;уже показывает куда более впечатляющие результаты. <code>Mistral</code> даже на&nbsp;непростые запросы отвечает за&nbsp;считанные секунды, а&nbsp;в&nbsp;режиме чата токены вылетают на&nbsp;экран заметно быстрее, чем в&nbsp;веб-интерфейсе ChatGPT.</p>
<p>Неприятным открытием стало то, что docker-версия Ollama на&nbsp;MacOS выполняется заметно медленнее (от&nbsp;3&nbsp;до&nbsp;5&nbsp;раз, если верить ощущениям), чем нативная. Возможно, всё дело в&nbsp;том, что я&nbsp;как-то неправильно настроил docker или приложение в&nbsp;контейнере нужно запускать с&nbsp;какими-нибудь специальными флагами для максимальной утилизации ресурсов. В&nbsp;любом случае, к&nbsp;порядку на&nbsp;этом ноутбуке я&nbsp;отношусь гораздо менее трепетно, поэтому просто установил и&nbsp;использую приложение с&nbsp;сайта Ollama.</p>
<h2 id='why'>
Зачем всё это нужно?
</h2>
<p>Конечно, ChatGPT умнее и&nbsp;умеет из&nbsp;коробки гораздо больше.<br>
Конечно, ChatGPT требует меньше телодвижений для использования.<br>
Конечно, самые умные модели требуют внушительных ресурсов, ведь для запуска нашумевшей <a href="https://ollama.ai/library/mixtral">mixtral</a> или аналогичной модели нужно иметь 48&nbsp;Gb&nbsp;оперативной памяти.<br>
Конечно, сидя в&nbsp;кафе задать вопрос Bard от&nbsp;Google гораздо проще, чем достучаться до&nbsp;модели в&nbsp;закрытом ноутбуке, который остался дома.<br></p>
<p>Я&nbsp;всё это прекрасно понимаю, но&nbsp;ничего из&nbsp;этого не&nbsp;стоит того, чтобы добровольно ставить себя в&nbsp;зависимость от&nbsp;монополистов с&nbsp;их&nbsp;закрытыми чёрными ящиками.</p>
<p>Даже если закрыть глаза на&nbsp;все идеологические вопросы, то&nbsp;любая локальная LLM отличается от&nbsp;любого облачного провайдера тем, что:</p>
<ul>
<li>Может работать в&nbsp;оффлайне.</li>
<li>Не&nbsp;хранит и&nbsp;не&nbsp;сливает вашу переписку.</li>
<li>Не&nbsp;станет завтра тупее, чем есть сегодня.</li>
<li>Не&nbsp;забанит тебя за&nbsp;возмутивший кого-то там запрос.</li>
<li>Обладает тем уровнем цензуры, который выбрал ты&nbsp;сам.</li>
</ul>
<p>Я&nbsp;искренне рад, что для доступа даже к&nbsp;передовым технологиям, всё ещё не&nbsp;обязательно поступаться своей приватностью и&nbsp;своими свободами.</p>
<hr>
<p>Этот пост написан без использования LLM =)</p>
</article>
</main>
<footer>
2024-01-15
</footer>
<script async
data-goatcounter="https://he4et.goatcounter.com/count"
src="https://gc.zgo.at/count.js"></script>
</body>
</html>

View file

@ -0,0 +1,152 @@
<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="utf-8">
<meta
name="viewport"
content="width=device-width, initial-scale=1.0">
<link rel="icon" href="/favicon.ico" sizes="32x32">
<link rel="icon" href="/icon.svg" type="image/svg+xml">
<title>
wrapped bw | oddsquat
</title>
<meta name="description" content="Превращаем fully-featured Bitwarden command-line interface в удобный.">
<link rel="preload" href="/fonts/open_sans_condensed-32.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans_condensed-27.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-25.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-24.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-17.woff2" as="font" type="font/woff2" crossorigin>
<link rel="stylesheet" type="text/css" href="/css/fonts.css">
<link rel="stylesheet" type="text/css" href="/css/typography.css">
<link rel="stylesheet" type="text/css" href="/css/main.css">
</head>
<body>
<div class="stripesContainer">
<div class="stripes">
</div>
</div>
<header>
<nav>
<ul>
<li><a href="/">oddsquat</a></li>
<li><a href="/posts/">
posts</a></li>
<li><a href="/posts/#2024">
2024</a></li>
<li>wrapped bw</li>
</ul>
</nav>
</header>
<main>
<article>
<h1 id="-bitwarden-cli-fzf-">Интеграция Bitwarden CLI с&nbsp;fzf и&nbsp;буфером обмена</h1>
<p>Менеджер паролей&nbsp;— это специальное приложение, которое помогает делать вид, что я&nbsp;помню разные пароли для разных аккаунтов, а&nbsp;не&nbsp;ввожу везде один и&nbsp;тот&nbsp;же. Мне нравится Bitwarden: открытый исходный код, возможность поднять собственный сервер, клиенты под разные устройства и&nbsp;расширения под разные браузеры.</p>
<p>Самым удобным, внезапно, оказался клиент для Android, который не&nbsp;заставляет меня каждый раз вводить 12+ знаков мастер-пароля (такую длину требуют Bitwarden и&nbsp;здравый смысл), а&nbsp;может быть разблокирован с&nbsp;помощью биометрии. Похожего удобства захотелось достичь и&nbsp;на&nbsp;Linux.</p>
<h2 id="-cli">Дикий CLI</h2>
<p>На&nbsp;ноутбуке я&nbsp;использую <a href="https://bitwarden.com/help/cli/">Bitwarden CLI</a>. Это powerful, fully-featured tool, которым на&nbsp;практике оказалось не&nbsp;слишком удобно пользоваться, если ты&nbsp;человек.</p>
<h3 id="-">Ключи от&nbsp;ключей</h3>
<blockquote>
<p>You are responsible for maintaining your session key.</p>
</blockquote>
<p>Bitwarden CLI поддерживает <a href="https://bitwarden.com/help/cli/#using-a-session-key">механизм сессий</a>, который призван избавить пользователя от&nbsp;бесконечного ввода мастер-пароля. Приложение позволяет разблокировать хранилище и&nbsp;получить временный сессионный ключ, который можно либо хранить в&nbsp;беззащитной переменной окружения, либо прикладывать к&nbsp;каждому запросу вручную.</p>
<p>По&nbsp;сути своей, сессионный ключ отличается от&nbsp;мастер-пароля тем, что его можно моментально деактивировать, но&nbsp;совершенно невозможно запомнить, а, значит, нужно где-то хранить. Хочется делать это удобно и&nbsp;безопасно, а&nbsp;не&nbsp;в&nbsp;общедоступной переменной окружения.</p>
<h3 id="-stdout">Пароли в&nbsp;stdout</h3>
<blockquote>
<p>The get command can only return one result, so&nbsp;you should use specific search terms. If&nbsp;multiple results are found, the CLI will return an&nbsp;error.</p>
</blockquote>
<p>Где-то в&nbsp;этот момент чтения документации я&nbsp;окончательно начал подозревать, что официальный CLI предназначен для скриптов: всё строго, никакого автодополнения, никакого интерактивного поиска, а&nbsp;пароли лаконично вываливаются в&nbsp;стандартный вывод терминала, откуда их&nbsp;ещё нужно как-то переправить в&nbsp;место назначения.</p>
<h2 id="-cli">Приручение CLI</h2>
<p>Может показаться, что я&nbsp;ругаюсь, но&nbsp;отсутствие удобств и&nbsp;излишеств в&nbsp;официальном CLI&nbsp;— это хорошо:</p>
<ul>
<li>Отсутствие фич всегда приятнее, чем кривые фичи.</li>
<li>Минимализм упрощает жизнь мейнтейнерам.</li>
<li>Минимализм повышает надёжность.</li>
<li>Меньше сторонних зависимостей.</li>
<li>Стандартные интерфейсы идеально подходят для автоматизации.</li>
</ul>
<p>Идея сделать Bitwarden CLI удобнее, разумеется, пришла в&nbsp;голову не&nbsp;только мне, так что на&nbsp;GitHub предсказуемо быстро нашёлся <a href="https://gist.github.com/loeschzwerg/c2b9d0b50f712a026aa6454af3b58598">скрипт-обёртка</a> от&nbsp;<a href="https://github.com/loeschzwerg">@loeschzwerg</a>. Этот ZSH-скрипт менее требователен к&nbsp;пользователю и&nbsp;позволяет в&nbsp;случае, когда под пользовательский поисковый запрос подходит несколько аккаунтов, выбрать нужный из&nbsp;списка с&nbsp;помощью fzf и&nbsp;автоматически скопировать логин, пароль и&nbsp;даже TOTP в&nbsp;буфер обмена.</p>
<p>К&nbsp;сожалению, найденный скрипт никак не&nbsp;решал проблему управления сессиями, так что я&nbsp;решил его немного доработать, избавив заодно от&nbsp;избытка многоточий в&nbsp;интерфейсе.</p>
<h3 id="-">«Безопасное» хранение сессионного ключа</h3>
<p>Как я&nbsp;писал выше, мне нравится подход Android-клиента: нужно один раз ввести свой невероятно длинный мастер-пароль, после чего можно разблокировать хранилище отпечатком пальца. В&nbsp;ходе непродолжительных размышлений я&nbsp;решил, что самое простое и&nbsp;надёжное подобие для приложения в&nbsp;терминале&nbsp;— один раз получить сессионный ключ и&nbsp;сохранить его в&nbsp;файл, который будет доступен для чтения только пользователю <code>root</code> и&nbsp;недоступен любым другим приложениям, запущенным от&nbsp;имени текущего пользователя.</p>
<p>Приятный бонус для владельцев биометрических сканеров: они отлично интегрируются с&nbsp;утилитой <code>sudo</code>.</p>
<p>В&nbsp;результате скрипт обогатился двумя функциями и&nbsp;одной проверкой:</p>
<pre><code class="language-zsh">local sessionfile=&quot;$HOME/.bitwarden_session&quot;
get_saved_sessionkey () {
sudo touch $sessionfile
echo $(sudo cat $sessionfile)
}
save_sessionkey () {
local sessionkey=$1
sudo chmod 600 $sessionfile
sudo sh -c &quot;echo $sessionkey &gt; $sessionfile&quot;
}</code></pre>
<pre><code>local sessionkey=$(get_saved_sessionkey)
if [[ -z $sessionkey ]] ; then
# Get and save a new session key
sessionkey=$(bw unlock --raw)
save_sessionkey $sessionkey
else
echo &quot;Using the existing session key from &#39;$sessionfile&#39;.&quot;
fi</code></pre><p>При первом запуске сессионный ключ, полученный после ввода мастер-пароля, записывается в&nbsp;файл, который после выполнения команды <code>chmod 600</code> становится недоступен для чтения никому, кроме суперпользователя:</p>
<pre><code>~ » ls -lah
...
-rw-------. 1 root root 89 Jul 24 22:15 .bitwarden_session
...
~ » less .bitwarden_session
.bitwarden_session: Permission denied</code></pre><p>Парольный менеджер и&nbsp;скрипт-обёртка запускаются от&nbsp;имени текущего пользователя, повышение привилегий требуется только в&nbsp;момент записи и&nbsp;чтения сессионного ключа.</p>
<p>Деактивировать сохранённый ключ можно с&nbsp;помощью команды <code>bw lock</code>.
К&nbsp;сожалению, я&nbsp;так и&nbsp;не&nbsp;понял, как с&nbsp;помощью утилиты <code>bw</code> можно проверить, валиден&nbsp;ли ключ, так что после деактивации придётся удалить файл <code>~/.bitwarden_session</code> вручную, иначе скрипт так и&nbsp;будет подставлять протухший сохранённый ключ, а&nbsp;<code>bw</code> будет каждый раз игнорировать его и&nbsp;настойчиво спрашивать мастер-пароль.</p>
<p><strong>Update [2026-03-29]</strong>:
Нормального способа проверить валидность сессионного ключа <a href="https://github.com/bitwarden/clients/issues/9254">всё ещё нет</a>,
но&nbsp;я&nbsp;научил утилиту удалять файл с&nbsp;протухшим ключом по&nbsp;косвенным признакам.</p>
<h2 id="-">Применять с&nbsp;осторожностью</h2>
<p>Взаимодействие с&nbsp;менеджером паролей выглядит для меня теперь примерно так:</p>
<pre><code>~ » bwc github
[sudo] password for $USER:
Using the existing session key from &#39;/home/$USER/.bitwarden_session&#39;.
Searching for &#39;github&#39;...
abcdefgh-ijkl-mnop-qrst-uvwxyz123456
github.com
Username &#39;username&#39; copied to clipboard.
[Press any key to copy the password]
Password copied to clipboard.</code></pre><p>Финальный вариант скрипта можно найти в&nbsp;репозитории <a href="https://github.com/He4eT/fuzzy-bitwarden-clipboard">He4eT/fuzzy-bitwarden-clipboard</a>.</p>
<p>Настоятельно рекомендую читать любой код перед тем, как запускать&nbsp;его. Особенно в&nbsp;тех случаях, когда речь идёт о&nbsp;настолько чувствительных данных.</p>
<p><strong>Важно!</strong> На&nbsp;системах без шифрования диска все эти танцы с&nbsp;правами на&nbsp;доступ к&nbsp;файлу не&nbsp;несут никакой пользы и&nbsp;превращают затею в&nbsp;увлекательный цирк.</p>
<p>Нельзя исключать, что я&nbsp;что-то совершенно неправильно понимаю в&nbsp;принципах работы системы прав доступа в&nbsp;Linux и&nbsp;совершил какие-нибудь грубейшие, с&nbsp;точки зрения настоящих специалистов по&nbsp;информационной безопасности, ошибки. Пожалуйста, сообщите, если я&nbsp;где-то неправ.</p>
<p>Нужно помнить, что такое упрощение жизни ведёт к&nbsp;новым рискам: теперь любой, кто знает ваш пароль для учётной записи системного пользователя и&nbsp;имеет доступ к&nbsp;компьютеру, будет также иметь доступ и&nbsp;ко&nbsp;всем паролям, сохранённым в&nbsp;Bitwarden.</p>
<p>Пользуйтесь с&nbsp;осторожностью и/или храните свои пароли в&nbsp;надёжных местах =)</p>
</article>
</main>
<footer>
2024-07-27
</footer>
<script async
data-goatcounter="https://he4et.goatcounter.com/count"
src="https://gc.zgo.at/count.js"></script>
</body>
</html>

File diff suppressed because it is too large Load diff

139
docs/posts/index.html Normal file
View file

@ -0,0 +1,139 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta
name="viewport"
content="width=device-width, initial-scale=1.0">
<link rel="icon" href="/favicon.ico" sizes="32x32">
<link rel="icon" href="/icon.svg" type="image/svg+xml">
<title>
posts | oddsquat
</title>
<meta name="description" content="Сomplete list of posts">
<link rel="preload" href="/fonts/open_sans_condensed-32.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans_condensed-27.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-25.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-24.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-17.woff2" as="font" type="font/woff2" crossorigin>
<link rel="stylesheet" type="text/css" href="/css/fonts.css">
<link rel="stylesheet" type="text/css" href="/css/typography.css">
<link rel="stylesheet" type="text/css" href="/css/main.css">
</head>
<body>
<div class="stripesContainer">
<div class="stripes">
</div>
</div>
<header>
<nav>
<ul>
<li><a href="/">oddsquat</a></li>
<li>posts</li>
</ul>
</nav>
</header>
<main>
<article>
<h1 id="posts">Posts</h1>
<p>Announcements are available via <a href="/rss.xml">RSS</a>.</p>
<hr>
<h2 id="2026">2026</h2>
<ul>
<li><article class='entry'>
<header>
[ru]
<strong>
<a href='/posts/2026/ugly_keyboards_ru/'>ugly keyboards</a>
</strong>
</header>
<section class='description'>
Почему нас окружают уродливые клавиатуры и&nbsp;что с&nbsp;этим можно сделать.
</section>
</article>
</li>
</ul>
<h2 id="2024">2024</h2>
<ul>
<li><article class='entry'>
<header>
[ru]
<strong>
<a href='/posts/2024/wrapped_bw_ru/'>wrapped bw</a>
</strong>
</header>
<section class='description'>
Превращаем fully-featured Bitwarden command-line interface в&nbsp;удобный.
</section>
</article>
</li>
<li><article class='entry'>
<header>
[ru]
<strong>
<a href='/posts/2024/selfhosted_llm/'>selfhosted LLM</a>
</strong>
</header>
<section class='description'>
Персональные LLM в&nbsp;docker-контейнере на&nbsp;твоём компьютере.
</section>
</article>
</li>
</ul>
<h2 id="2020">2020</h2>
<ul>
<li><article class='entry'>
<header>
[ru]
<strong>
<a href='/posts/2020/typographic_linter/'>typographic linter</a>
</strong>
</header>
<section class='description'>
Prettier для текста. Автоматизация рутинной типографики.
</section>
</article>
</li>
<li><article class='entry'>
<header>
[ru]
<strong>
<a href='/posts/2020/initial_post/'>initial post</a>
</strong>
</header>
<section class='description'>
Какие инструменты были использованы для создания этого сайта, какие решения были приняты и&nbsp;почему.
</section>
</article>
</li>
</ul>
</article>
</main>
<footer>
</footer>
<script async
data-goatcounter="https://he4et.goatcounter.com/count"
src="https://gc.zgo.at/count.js"></script>
</body>
</html>

351
docs/projects/index.html Normal file
View file

@ -0,0 +1,351 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta
name="viewport"
content="width=device-width, initial-scale=1.0">
<link rel="icon" href="/favicon.ico" sizes="32x32">
<link rel="icon" href="/icon.svg" type="image/svg+xml">
<title>
projects | oddsquat
</title>
<meta name="description" content="Incomplete list of projects and experiments.">
<link rel="preload" href="/fonts/open_sans_condensed-32.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans_condensed-27.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-25.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-24.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-17.woff2" as="font" type="font/woff2" crossorigin>
<link rel="stylesheet" type="text/css" href="/css/fonts.css">
<link rel="stylesheet" type="text/css" href="/css/typography.css">
<link rel="stylesheet" type="text/css" href="/css/main.css">
</head>
<body>
<div class="stripesContainer">
<div class="stripes">
</div>
</div>
<header>
<nav>
<ul>
<li><a href="/">oddsquat</a></li>
<li>projects</li>
</ul>
</nav>
</header>
<main>
<article>
<h1 id="projects">Projects</h1>
<p>Incomplete list of&nbsp;my&nbsp;projects and experiments.</p>
<hr>
<ul>
<li><a href="#interactive-fiction-tools">Interactive Fiction Tools</a></li>
<li><a href="#games">Games</a></li>
<li><a href="#services">Services</a></li>
<li><a href="#inventory">Inventory</a><ul>
<li><a href="#hardware">Hardware</a></li>
<li><a href="#settings">Settings</a></li>
<li><a href="#software-plugins-and-tools">Software, Plugins and Tools</a></li>
</ul>
</li>
</ul>
<hr>
<h2 id="interactive-fiction-tools">Interactive Fiction Tools</h2>
<ul>
<li><article class='entry'>
<header>
<strong>
ElseIFPlayer
</strong>
</header>
<section class='description'>
Interactive Fiction player for the web.
</section>
<section>
<a href='https://github.com/He4eT/elseifplayer' target='_blank'>repository</a>
| <a href='https://www.ifwiki.org/ElseIFPlayer' target='_blank'>ifwiki</a>
| <a href='https://he4et.github.io/elseifplayer/' target='_blank'>app</a>
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
cheap-glkote
</strong>
</header>
<section class='description'>
Abstract implementation of&nbsp;the GlkOte library interface
designed to&nbsp;be&nbsp;used with Emglken.
</section>
<section>
<a href='https://github.com/He4eT/cheap-glkote' target='_blank'>repository</a>
| <a href='https://www.npmjs.com/package/cheap-glkote' target='_blank'>npm</a>
</section>
</article>
</li>
</ul>
<hr>
<h2 id="games">Games</h2>
<ul>
<li><article class='entry'>
<header>
<strong>
DASH DOT PIT
</strong>
</header>
<section class='description'>
Endless top-down shooter for TIC-80&nbsp;where Morse code
is&nbsp;your weapon.
</section>
<section>
<a href='https://github.com/He4eT/DotDashPit' target='_blank'>repository</a>
| <a href='https://tic80.com/play?cart=4301' target='_blank'>play</a>
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
Yet Another Experiment
</strong>
</header>
<section class='description'>
Tiny “escape the room” style TADS3&nbsp;game.
<br>Designed as&nbsp;a&nbsp;set of&nbsp;examples
for Interactive Fiction development.
</section>
<section>
<a href='https://github.com/He4eT/yet-another-experiment' target='_blank'>repository</a>
| <a href='https://ifdb.org/viewgame?id=rsssdo3anjpwnt6e' target='_blank'>ifdb</a>
| <a href='https://he4et.github.io/elseifplayer/#/focus/https%3A%2F%2Fifarchive.org%2Fif-archive%2Fgames%2Ftads%2Fyet_another_experiment.t3/serika_dark/' target='_blank'>play</a>
<section>
</article>
</li>
</ul>
<hr>
<h2 id="services">Services</h2>
<ul>
<li><article class='entry'>
<header>
<strong>
Simple SpaceAPI
</strong>
</header>
<section class='description'>
A&nbsp;lightweight SpaceAPI server with both web and REST interfaces.
</section>
<section>
<a href='https://github.com/He4eT/simple-spaceapi' target='_blank'>repository</a>
</section>
</article>
</li>
</ul>
<hr>
<h2 id="inventory">Inventory</h2>
<h3 id="hardware">Hardware</h3>
<ul>
<li><article class='entry'>
<header>
<strong>
Cantor MX Tastatura
</strong>
</header>
<section class='description'>
Small custom ergonomic mechanical keyboard.
</section>
<section>
<a href='https://github.com/He4eT/cantor-mx-tastatura' target='_blank'>repository</a>
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
oddkb
</strong>
</header>
<section class='description'>
Huge custom ergonomic mechanical Dactyl-Manuform (5&times;6) keyboard.
</section>
<section>
<a href='https://github.com/He4eT/oddkb' target='_blank'>repository</a>
</section>
</article>
</li>
</ul>
<hr>
<h3 id="settings">Settings</h3>
<ul>
<li><article class='entry'>
<header>
<strong>
dotfiles
</strong>
</header>
<section class='description'>
Custom-made desktop environment based on&nbsp;i3wm.
<br>It&nbsp;comes with settings for
i3wm, Polybar, Rofi, dunst, NeoVim, and some other applications.
</section>
<section>
<a href='https://github.com/He4eT/dotfiles' target='_blank'>repository</a>
</section>
</article>
</li>
</ul>
<hr>
<h3 id="software-plugins-and-tools">Software, Plugins and Tools</h3>
<ul>
<li><article class='entry'>
<header>
<strong>
desolate.nvim
</strong>
</header>
<section class='description'>
Another customizable not-so-colorful NeoVim colorscheme.
</section>
<section>
<a href='https://github.com/He4eT/desolate.nvim' target='_blank'>repository</a>
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
desolate-gtk
</strong>
</header>
<section class='description'>
Another customizable not-so-colorful GTK theme for your tiling WM.
</section>
<section>
<a href='https://github.com/He4eT/Desolate-GTK' target='_blank'>repository</a>
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
tabswitcher
</strong>
</header>
<section class='description'>
Switch between Firefox tabs and manage them with a&nbsp;fuzzy search
and basic command toolset.
</section>
<section>
<a href='https://github.com/He4eT/tabswitcher' target='_blank'>repository</a>
| <a href='https://addons.mozilla.org/en-GB/firefox/addon/tabswitcher/' target='_blank'>extension</a>
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
tabswiper
</strong>
</header>
<section class='description'>
Firefox extension that makes trimming your tabs as&nbsp;effortless
as&nbsp;swiping on&nbsp;a&nbsp;dating app.
</section>
<section>
<a href='https://github.com/He4eT/tabswiper' target='_blank'>repository</a>
| <a href='https://addons.mozilla.org/en-GB/firefox/addon/tabswiper/' target='_blank'>extension</a>
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
fuzzsoma
</strong>
</header>
<section class='description'>
SomaFM CLI station selector.
</section>
<section>
<a href='https://github.com/He4eT/fuzzsoma' target='_blank'>repository</a>
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
fuzzy-bitwarden-clipboard
</strong>
</header>
<section class='description'>
Interactive Bitwarden CLI wrapper.
</section>
<section>
<a href='https://github.com/He4eT/fuzzy-bitwarden-clipboard' target='_blank'>repository</a>
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
huge-link
</strong>
</header>
<section class='description'>
Minimalistic serverless publishing tool for small markdown posts.
</section>
<section>
<a href='https://github.com/He4eT/huge-link' target='_blank'>repository</a>
| <a href='https://he4et.github.io/huge-link/' target='_blank'>app</a>
</section>
</article>
</li>
<li><article class='entry'>
<header>
<strong>
conky-dashboard
</strong>
</header>
<section class='description'>
Desktop widgets for system status monitoring.
</section>
<section>
<a href='https://github.com/He4eT/conky-dashboard' target='_blank'>repository</a>
</section>
</article>
</li>
</ul>
<hr>
</article>
</main>
<footer>
</footer>
<script async
data-goatcounter="https://he4et.goatcounter.com/count"
src="https://gc.zgo.at/count.js"></script>
</body>
</html>

25
docs/qr/index.html Normal file
View file

@ -0,0 +1,25 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta
name="description"
content="Redirect to '/images/qr/oddsquat.org.png'.">
<meta
http-equiv="Refresh"
content="0; URL=/images/qr/oddsquat.org.png">
<title>
Redirect | oddsquat
</title>
</head>
<body>
<main>
Redirect to
<a
style="color: inherit;"
href="/images/qr/oddsquat.org.png">
/images/qr/oddsquat.org.png
</a>
</main>
</body>
</html>

1
docs/rss.xml Normal file
View file

@ -0,0 +1 @@
<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title><![CDATA[oddsquat]]></title><description><![CDATA[A fanzine about experiments, code and other cyberpunk stuff.]]></description><link>https://oddsquat.org</link><image><url>https://oddsquat.org/icon.svg&apos;</url><title>oddsquat</title><link>https://oddsquat.org</link></image><generator>RSS for Node</generator><lastBuildDate>Wed, 18 Mar 2026 14:48:21 +0100</lastBuildDate><atom:link href="https://oddsquat.org/rss.xml" rel="self" type="application/rss+xml"/><item><title><![CDATA[[RU] ugly keyboards]]></title><description><![CDATA[Почему нас окружают уродливые клавиатуры и что с этим можно сделать.]]></description><link>https://oddsquat.org/posts/2026/ugly_keyboards_ru/</link><guid isPermaLink="true">https://oddsquat.org/posts/2026/ugly_keyboards_ru/</guid><pubDate>Wed, 18 Mar 2026 00:00:00 +0100</pubDate></item><item><title><![CDATA[[RU] wrapped bw]]></title><description><![CDATA[Превращаем fully-featured Bitwarden command-line interface в удобный.]]></description><link>https://oddsquat.org/posts/2024/wrapped_bw_ru/</link><guid isPermaLink="true">https://oddsquat.org/posts/2024/wrapped_bw_ru/</guid><pubDate>Sat, 27 Jul 2024 00:00:00 +0200</pubDate></item><item><title><![CDATA[[RU] selfhosted LLM]]></title><description><![CDATA[Персональные LLM в docker-контейнере на твоём компьютере.]]></description><link>https://oddsquat.org/posts/2024/selfhosted_llm/</link><guid isPermaLink="true">https://oddsquat.org/posts/2024/selfhosted_llm/</guid><pubDate>Mon, 15 Jan 2024 00:00:00 +0100</pubDate></item><item><title><![CDATA[[RU] typographic linter]]></title><description><![CDATA[Prettier для текста. Автоматизация рутинной типографики.]]></description><link>https://oddsquat.org/posts/2020/typographic_linter/</link><guid isPermaLink="true">https://oddsquat.org/posts/2020/typographic_linter/</guid><pubDate>Thu, 18 Nov 2021 00:00:00 +0100</pubDate></item><item><title><![CDATA[[RU] initial post]]></title><description><![CDATA[Первый пост в этом фэнзине, рассказывающий о его внутреннем устойстве.]]></description><link>https://oddsquat.org/posts/2020/initial_post/</link><guid isPermaLink="true">https://oddsquat.org/posts/2020/initial_post/</guid><pubDate>Sun, 08 Nov 2020 00:00:00 +0100</pubDate></item></channel></rss>

390
docs/test/index.html Normal file
View file

@ -0,0 +1,390 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta
name="viewport"
content="width=device-width, initial-scale=1.0">
<link rel="icon" href="/favicon.ico" sizes="32x32">
<link rel="icon" href="/icon.svg" type="image/svg+xml">
<title>
markdown test page | oddsquat
</title>
<meta name="description" content="A test document written using the Markdown language.">
<link rel="preload" href="/fonts/open_sans_condensed-32.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans_condensed-27.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-25.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-24.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/fonts/open_sans-17.woff2" as="font" type="font/woff2" crossorigin>
<link rel="stylesheet" type="text/css" href="/css/fonts.css">
<link rel="stylesheet" type="text/css" href="/css/typography.css">
<link rel="stylesheet" type="text/css" href="/css/main.css">
</head>
<body>
<div class="stripesContainer">
<div class="stripes">
</div>
</div>
<header>
<nav>
<ul>
<li><a href="/">oddsquat</a></li>
<li><a href="/posts/">
posts</a></li>
<li><a href="/posts/#2020">
2020</a></li>
<li>markdown test page</li>
</ul>
</nav>
</header>
<main>
<article>
<h1 id="markdown-syntax">Markdown: Syntax</h1>
<p>Markdown is intended to be as easy-to-read and easy-to-write as is feasible.</p>
<p>Readability, however, is emphasized above all else. A Markdown-formatted
document should be publishable as-is, as plain text, without looking
like it&#39;s been marked up with tags or formatting instructions. While
Markdown&#39;s syntax has been influenced by several existing text-to-HTML
filters — including <a href="http://docutils.sourceforge.net/mirror/setext.html">Setext</a>, <a href="http://www.aaronsw.com/2002/atx/">atx</a>, <a href="http://textism.com/tools/textile/">Textile</a>, <a href="http://docutils.sourceforge.net/rst.html">reStructuredText</a>,
<a href="http://www.triptico.com/software/grutatxt.html">Grutatext</a>, and <a href="http://ettext.taint.org/doc/">EtText</a> — the single biggest source of
inspiration for Markdown&#39;s syntax is the format of plain text email.</p>
<p><strong>Note:</strong> This document is itself written using Markdown.</p>
<hr>
<h2 id="table-of-content">Table Of Content</h2>
<ul>
<li><a href="#block-elements">Block Elements</a><ul>
<li><a href="#paragraphs-and-line-breaks">Paragraphs and Line Breaks</a></li>
<li><a href="#headers">Headers</a></li>
<li><a href="#blockquotes">Blockquotes</a></li>
<li><a href="#lists">Lists</a></li>
<li><a href="#code-blocks">Code Blocks</a></li>
<li><a href="#tables">Tables</a></li>
</ul>
</li>
<li><a href="#span-elements">Span Elements</a><ul>
<li><a href="#links">Links</a></li>
<li><a href="#emphasis">Emphasis</a></li>
<li><a href="#code">Code</a></li>
</ul>
</li>
</ul>
<hr>
<h2 id="block-elements">Block Elements</h2>
<h3 id="paragraphs-and-line-breaks">Paragraphs and Line Breaks</h3>
<p>A paragraph is simply one or more consecutive lines of text, separated
by one or more blank lines. (A blank line is any line that looks like a
blank line — a line containing nothing but spaces or tabs is considered
blank.) Normal paragraphs should not be indented with spaces or tabs.</p>
<p>The implication of the &quot;one or more consecutive lines of text&quot; rule is
that Markdown supports &quot;hard-wrapped&quot; text paragraphs. This differs
significantly from most other text-to-HTML formatters (including Movable
Type&#39;s &quot;Convert Line Breaks&quot; option) which translate every line break
character in a paragraph into a <code>&lt;br /&gt;</code> tag.</p>
<p>When you <em>do</em> want to insert a <code>&lt;br /&gt;</code> break tag using Markdown, you
end a line with two or more spaces, then type return.</p>
<h3 id="headers">Headers</h3>
<p>Headers are lines that start with the <code>#</code> symbol.
The number of characters defines the header level,
from one (<code>#</code>) for <code>&lt;h1&gt;</code> to six (<code>######</code>) for <code>&lt;h6&gt;</code>.</p>
<h3 id="blockquotes">Blockquotes</h3>
<p>Markdown uses email-style <code>&gt;</code> characters for blockquoting. If you&#39;re
familiar with quoting passages of text in an email message, then you
know how to create a blockquote in Markdown. It looks best if you hard
wrap the text and put a <code>&gt;</code> before every line:</p>
<blockquote>
<p>This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.</p>
<p>Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.</p>
</blockquote>
<p>Markdown allows you to be lazy and only put the <code>&gt;</code> before the first
line of a hard-wrapped paragraph:</p>
<blockquote>
<p>This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.</p>
</blockquote>
<blockquote>
<p>Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.</p>
</blockquote>
<p>Blockquotes can be nested (i.e. a blockquote-in-a-blockquote) by
adding additional levels of <code>&gt;</code>:</p>
<blockquote>
<p>This is the first level of quoting.</p>
<blockquote>
<p>This is nested blockquote.</p>
</blockquote>
<p>Back to the first level.</p>
</blockquote>
<p>Blockquotes can contain other Markdown elements, including headers, lists,
and code blocks:</p>
<blockquote>
<h3 id="here-s-a-list">Here&#39;s a list</h3>
<ol>
<li>This is the first list item.</li>
<li>This is the second list item.</li>
</ol>
<h3 id="here-s-an-example-code-block">Here&#39;s an example code block</h3>
<pre><code>const PI = 3.1415`</code></pre></blockquote>
<p>Any decent text editor should make email-style quoting easy. For
example, with BBEdit, you can make a selection and choose Increase
Quote Level from the Text menu.</p>
<h3 id="lists">Lists</h3>
<p>Markdown supports ordered (numbered) and unordered (bulleted) lists.</p>
<p>Unordered lists use asterisks, pluses, and hyphens — interchangably
— as list markers:</p>
<ul>
<li>Red</li>
<li>Green</li>
<li>Blue</li>
</ul>
<p>is equivalent to:</p>
<ul>
<li>Red</li>
<li>Green</li>
<li>Blue</li>
</ul>
<p>and:</p>
<ul>
<li>Red</li>
<li>Green</li>
<li>Blue</li>
</ul>
<p>Ordered lists use numbers followed by periods:</p>
<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>
<p>It&#39;s important to note that the actual numbers you use to mark the
list have no effect on the HTML output Markdown produces. The HTML
Markdown produces from the above list is:</p>
<p>If you instead wrote the list in Markdown like this:</p>
<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>
<p>or even:</p>
<ol start="3">
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>
<p>you&#39;d get the exact same HTML output. The point is, if you want to,
you can use ordinal numbers in your ordered Markdown lists, so that
the numbers in your source match the numbers in your published HTML.
But if you want to be lazy, you don&#39;t have to.</p>
<p>To make lists look nice, you can wrap items with hanging indents:</p>
<ul>
<li>Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.</li>
<li>Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.</li>
</ul>
<p>But if you want to be lazy, you don&#39;t have to:</p>
<ul>
<li>Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.</li>
<li>Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.</li>
</ul>
<p>List items may consist of multiple paragraphs. Each subsequent
paragraph in a list item must be indented by either 4 spaces
or one tab:</p>
<ol>
<li><p>This is a list item with two paragraphs. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit. Aliquam hendrerit
mi posuere lectus.</p>
<p>Vestibulum enim wisi, viverra nec, fringilla in, laoreet
vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
sit amet velit.</p>
</li>
<li><p>Suspendisse id sem consectetuer libero luctus adipiscing.</p>
</li>
</ol>
<p>It looks nice if you indent every line of the subsequent
paragraphs, but here again, Markdown will allow you to be
lazy:</p>
<ul>
<li><p>This is a list item with two paragraphs.</p>
<p>This is the second paragraph in the list item. You&#39;re
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.</p>
</li>
<li><p>Another item in the same list.</p>
</li>
</ul>
<p>To put a blockquote within a list item, the blockquote&#39;s <code>&gt;</code>
delimiters need to be indented:</p>
<ul>
<li><p>A list item with a blockquote:</p>
<blockquote>
<p>This is a blockquote
inside a list item.</p>
</blockquote>
</li>
</ul>
<p>To put a code block within a list item, the code block needs
to be indented with list item indentation in mind:</p>
<ul>
<li><p>A list item with a code block:</p>
<pre><code>code goes here
code goes here</code></pre></li>
</ul>
<h3 id="code-blocks">Code Blocks</h3>
<p>Pre-formatted code blocks are used for writing about programming or
markup source code. Rather than forming normal paragraphs, the lines
of a code block are interpreted literally. Markdown wraps a code block
in both <code>&lt;pre&gt;</code> and <code>&lt;code&gt;</code> tags.</p>
<pre><code>tell application &quot;Foo&quot;
beep
end tell</code></pre><p>Regular Markdown syntax is not processed within code blocks. E.g.,
asterisks are just literal asterisks within a code block. This means
it&#39;s also easy to use Markdown to write about Markdown&#39;s own syntax.</p>
<pre><code>## This is **not** a Markdown</code></pre><h3 id="tables">Tables</h3>
<p>Markdown tables are created using pipes (|) to separate columns and hyphens (-) to define the header row. Heres the basic structure:</p>
<ol>
<li>Header Row: The first row contains column names.</li>
<li>Divider Line: The second row uses hyphens to separate the header from the data.</li>
<li>Data Rows: The rows below the divider contain the actual data.</li>
</ol>
<table>
<thead>
<tr>
<th>Name</th>
<th>Age</th>
<th>City</th>
</tr>
</thead>
<tbody><tr>
<td>Alice</td>
<td>25</td>
<td>New York</td>
</tr>
<tr>
<td>Bob</td>
<td>30</td>
<td>London</td>
</tr>
</tbody></table>
<p>You can style text inside Markdown table cells just like regular Markdown.
This includes making text bold, italic, monospaced, or adding links or code.</p>
<table>
<thead>
<tr>
<th>Column 1</th>
<th>Column 2</th>
<th>Column 3</th>
</tr>
</thead>
<tbody><tr>
<td><strong>Things</strong></td>
<td><em>Don&#39;t</em></td>
<td><a href="/">Need</a></td>
</tr>
<tr>
<td>To</td>
<td><em><strong>Look</strong></em></td>
<td><code>Pretty</code></td>
</tr>
</tbody></table>
<p>You can align text in Markdown table columns to the left, right, or center by placing a colon (:) in different positions within the header divider row.</p>
<ol>
<li>Left-aligned: <code>:---</code> (Colon on the left)</li>
<li>Right-aligned: <code>---:</code> (Colon on the right)</li>
<li>Center-aligned: <code>:---:</code> (Colons on both sides)</li>
</ol>
<table>
<thead>
<tr>
<th align="left">Column 1</th>
<th align="center">Column 2</th>
<th align="right">Column 3</th>
</tr>
</thead>
<tbody><tr>
<td align="left">Cell Contents</td>
<td align="center">More Stuff</td>
<td align="right">And Again</td>
</tr>
<tr>
<td align="left">You Can Also</td>
<td align="center">Put Pipes In</td>
<td align="right">Like this [|]</td>
</tr>
</tbody></table>
<p>Markdown tables dont support merging cells (like in HTML).
Each cell is treated separately.
But if you want an empty space, just leave it blank.</p>
<table>
<thead>
<tr>
<th>Header 1</th>
<th>Header 2</th>
</tr>
</thead>
<tbody><tr>
<td>Cell 1</td>
<td></td>
</tr>
<tr>
<td>Cell 3</td>
<td>Cell 4</td>
</tr>
</tbody></table>
<h2 id="span-elements">Span Elements</h2>
<h3 id="links">Links</h3>
<p>To create an inline link, use a set of regular parentheses immediately
after the link text&#39;s closing square bracket. Inside the parentheses,
put the URL where you want the link to point, along with an <em>optional</em>
title for the link, surrounded in quotes. For example:</p>
<p>This is <a href="http://example.com/">an example</a> inline link.</p>
<p><a href="/test/markdown/" title="This is an example title">This link</a> has a title attribute.</p>
<h3 id="emphasis">Emphasis</h3>
<p>Markdown treats asterisks (<code>*</code>) and underscores (<code>_</code>) as indicators of
emphasis. Text wrapped with one <code>*</code> or <code>_</code> will be wrapped with an
HTML <code>&lt;em&gt;</code> tag; double <code>*</code>&#39;s or <code>_</code>&#39;s will be wrapped with an HTML
<code>&lt;strong&gt;</code> tag. E.g., this input:</p>
<p><em>single asterisks</em></p>
<p><em>single underscores</em></p>
<p><strong>double asterisks</strong></p>
<p><strong>double underscores</strong></p>
<h3 id="code">Code</h3>
<p>To indicate a span of code, wrap it with backtick quotes (<code>`</code>).
Unlike a pre-formatted code block, a code span indicates code within a
normal paragraph. For example:</p>
<p>Use the <code>printf()</code> function.</p>
</article>
</main>
<footer>
2020-10-30
</footer>
<script async
data-goatcounter="https://he4et.goatcounter.com/count"
src="https://gc.zgo.at/count.js"></script>
</body>
</html>

View file

@ -26,6 +26,22 @@ a:hover {
border-color: currentColor; border-color: currentColor;
} }
/* Lists */
ul {
list-style: square;
}
/* Tables */
@media (max-width: 500px) {
table {
display: block;
overflow: auto;
width: 100%;
}
}
/* Code and quotes*/ /* Code and quotes*/
pre, blockquote { pre, blockquote {
@ -72,11 +88,7 @@ figure.image figcaption {
margin-top: 1.0rem; margin-top: 1.0rem;
} }
/* Lists */ /* Entries */
ul {
list-style: square;
}
.entry:last-child, .entry:last-child,
.entry { .entry {
@ -88,16 +100,6 @@ ul {
margin-bottom: 0.5rem; margin-bottom: 0.5rem;
} }
/* Tables */
@media (max-width: 500px) {
table {
display: block;
overflow: auto;
width: 100%;
}
}
/* Stripes */ /* Stripes */
.stripesContainer { .stripesContainer {