info/BezierInfo-2
1
0
Fork 0
mirror of https://github.com/Pomax/BezierInfo-2.git synced 2025-09-02 04:42:43 +02:00
Code Issues Releases Wiki Activity

.

Browse Source
This commit is contained in:
Pomax
2020-09-25 16:03:32 -07:00
parent 8caa51813a
commit e0f770b2c8
6 changed files with 20343 additions and 8039 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7381
docs/index.html
View File

File diff suppressed because it is too large Load Diff

7197
docs/ja-JP/index.html
View File

File diff suppressed because it is too large Load Diff

181
docs/news/2020-09-18.html
View File

@@ -1,17 +1,15 @@
<!DOCTYPE html> <!DOCTYPE html>
<html lang="en-GB"> <html lang="en-GB">
<head> <head>
<meta charset="utf-8" /> <meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" /> <meta name="viewport" content="width=device-width, initial-scale=1" />
<title>A Primer on Bézier Curves - Rewriting the tech stack</title> <title>A Primer on Bézier Curves - Rewriting the tech stack</title>
<base href=".."> <base href=".." />
<link rel="icon" href="images/favicon.png" type="image/png" /> <link rel="icon" href="images/favicon.png" type="image/png" />
<link rel="alternate" type="application/rss+xml" title="RSS" href="news/rss.xml"> <link rel="alternate" type="application/rss+xml" title="RSS" href="news/rss.xml" />
<!-- page styling --> <!-- page styling -->
<link rel="preload" href="images/paper.png" as="image" /> <link rel="preload" href="images/paper.png" as="image" />
@@ -29,7 +27,7 @@
<meta property="og:locale" content="en-GB" /> <meta property="og:locale" content="en-GB" />
<meta property="og:type" content="article" /> <meta property="og:type" content="article" />
<meta property="og:published_time" content="Thu Sep 17 2020 17:00:00 +00:00" /> <meta property="og:published_time" content="Thu Sep 17 2020 17:00:00 +00:00" />
<meta property="og:updated_time" content="Fri Sep 25 2020 16:00:34 +00:00" /> <meta property="og:updated_time" content="Fri Sep 25 2020 16:03:04 +00:00" />
<meta property="og:author" content="Mike 'Pomax' Kamermans" /> <meta property="og:author" content="Mike 'Pomax' Kamermans" />
<meta property="og:section" content="Bézier Curves" /> <meta property="og:section" content="Bézier Curves" />
<meta property="og:tag" content="Bézier Curves" /> <meta property="og:tag" content="Bézier Curves" />
@@ -42,8 +40,6 @@
<meta name="twitter:url" content="https://pomax.github.io/bezierinfo/news/" /> <meta name="twitter:url" content="https://pomax.github.io/bezierinfo/news/" />
<meta name="twitter:description" content="Rewriting the tech stack" /> <meta name="twitter:description" content="Rewriting the tech stack" />
<!-- my own referral/page hit tracker, because Google knows enough --> <!-- my own referral/page hit tracker, because Google knows enough -->
<script src="./js/site/referrer.js" type="module" async></script> <script src="./js/site/referrer.js" type="module" async></script>
@@ -58,7 +54,6 @@
<!-- make images lazy load much earlier --> <!-- make images lazy load much earlier -->
<script src="./js/site/better-lazy-loading.js" type="module" async defer></script> <script src="./js/site/better-lazy-loading.js" type="module" async defer></script>
</head> </head>
<body> <body>
@@ -67,59 +62,89 @@
<script> <script>
(function () { (function () {
var loc = window.location.toString(); var loc = window.location.toString();
if (loc.includes('localhost') || loc.includes('BezierInfo-2')) { if (loc.includes("localhost") || loc.includes("BezierInfo-2")) {
var e = document.querySelector('div.dev'); var e = document.querySelector("div.dev");
e.removeAttribute("style"); e.removeAttribute("style");
} }
}()); })();
</script> </script>
</div> </div>
<div class="github"> <div class="github">
<img src="images/ribbon.png" alt="This page on GitHub" style="border:none;" useMap="#githubmap" width="200" height="149" /> <img src="images/ribbon.png" alt="This page on GitHub" style="border: none;" usemap="#githubmap" width="200" height="149" />
<map name="githubmap"> <map name="githubmap">
<area shape="poly" coords="30,0, 200,0, 200,114" href="http://github.com/pomax/BezierInfo-2" alt="This page on GitHub" /> <area shape="poly" coords="30,0, 200,0, 200,114" href="http://github.com/pomax/BezierInfo-2" alt="This page on GitHub" />
</map> </map>
</div> </div>
<header> <header>
<h1>Rewriting the tech stack</h1> <h1>Rewriting the tech stack</h1>
<h5 class="post-date">Fri, 18 Sep 2020</h5> <h5 class="post-date">Fri, 18 Sep 2020</h5>
</header> </header>
<main> <main>
<!-- Because people probably want to share this article --> <!-- Because people probably want to share this article -->
<div class="notforprint scl"> <div class="notforprint scl">
<img src="images/icons.gif" usemap="#rhtimap" title="Share this on social media" /> <img src="images/icons.gif" usemap="#rhtimap" title="Share this on social media" />
<map name="rhtimap"> <map name="rhtimap">
<area class="sclnk-rdt" shape="rect" coords="0, 0, 19, 15" <area
class="sclnk-rdt"
shape="rect"
coords="0, 0, 19, 15"
href="https://www.reddit.com/submit?url=https://pomax.github.io/bezierinfo/news/2020-09-18.html&title==A Primer on Bézier Curves - Rewriting the tech stack&text=An update about the Primer on Bézier curves." href="https://www.reddit.com/submit?url=https://pomax.github.io/bezierinfo/news/2020-09-18.html&title==A Primer on Bézier Curves - Rewriting the tech stack&text=An update about the Primer on Bézier curves."
alt="submit to reddit" title="submit to reddit"> alt="submit to reddit"
<area class="sclnk-hn" shape="rect" coords="0, 20, 19, 35" title="submit to reddit"
/>
<area
class="sclnk-hn"
shape="rect"
coords="0, 20, 19, 35"
href="https://news.ycombinator.com/submitlink?u=https://pomax.github.io/bezierinfo/news/2020-09-18.html&t=A Primer on Bézier Curves - Rewriting the tech stack" href="https://news.ycombinator.com/submitlink?u=https://pomax.github.io/bezierinfo/news/2020-09-18.html&t=A Primer on Bézier Curves - Rewriting the tech stack"
alt="submit to hacker news" title="submit to hacker news"> alt="submit to hacker news"
<area class="sclnk-twt" shape="rect" coords="0, 40, 19, 55" title="submit to hacker news"
/>
<area
class="sclnk-twt"
shape="rect"
coords="0, 40, 19, 55"
href="https://twitter.com/intent/tweet?hashtags=bezier,curves,maths&original_referer=https://pomax.github.io/bezierinfo&text=Reading “Rewriting the tech stack” by @TheRealPomax over on https://pomax.github.io/bezierinfo/news/2020-09-18.html" href="https://twitter.com/intent/tweet?hashtags=bezier,curves,maths&original_referer=https://pomax.github.io/bezierinfo&text=Reading “Rewriting the tech stack” by @TheRealPomax over on https://pomax.github.io/bezierinfo/news/2020-09-18.html"
alt="tweet your read" title="tweet your read"> alt="tweet your read"
title="tweet your read"
/>
</map> </map>
</div> </div>
<p>
<p>Once upon a time, I needed to draw some Bezier curves because I was trying to create a Japanese kanji composition system that turned strokes into outlines, and that required knowing how to offset Bezier curves and... at the time (2011, time flies) there was no good single source of information for Bezier curves on the web. So I made one. Sure it started small, but it turns out that if you just keep adding bits to something, several years later you have quite the monster, and a single HTML file becomes intractible.</p> Once upon a time, I needed to draw some Bezier curves because I was trying to create a Japanese kanji composition system that turned strokes
<p>So, in 2016, when <a href="">React.js</a> exploded onto the scene, I rewrote the primer as a React app, and it became a lot easier to maintain. Like, <em>a lot</em> a lot. However, there was a downside: no JS meant no content. Sure, server-side rendering sort of existed, but not really, and because the Primer is hosted through github, there was no "server" to run. Plus, trying to rehydrate an app the size of the Primer from a giant HTML file had truly <em>dire</em> performance.</p> into outlines, and that required knowing how to offset Bezier curves and... at the time (2011, time flies) there was no good single source of
<p>So I left it a regular React app, and every time I thought "wouldn't it be nice if it was just... a web page again?" the browser landscape just hadn't caught up. Finally, in 2020, things are different: with a global pandemic, and some vacation time, and something random causing me to look up the state of HTML custom elements, everything was pointing at it being time to finally, <em>finally</em>, turn the Primer back into a normal web page.</p> information for Bezier curves on the web. So I made one. Sure it started small, but it turns out that if you just keep adding bits to
<p>The new tech stack is, frankly, pretty amazing. It does some things that weren't possible even half a year before I started the rewrite, let alone being possible in 2016, and so because so much has changed, this post will be the first in a series of posts on how the new tech stack works.</p> something, several years later you have quite the monster, and a single HTML file becomes intractible.
</p>
<p>
So, in 2016, when <a href="">React.js</a> exploded onto the scene, I rewrote the primer as a React app, and it became a lot easier to
maintain. Like, <em>a lot</em> a lot. However, there was a downside: no JS meant no content. Sure, server-side rendering sort of existed, but
not really, and because the Primer is hosted through github, there was no "server" to run. Plus, trying to rehydrate an app the size of the
Primer from a giant HTML file had truly <em>dire</em> performance.
</p>
<p>
So I left it a regular React app, and every time I thought "wouldn't it be nice if it was just... a web page again?" the browser landscape
just hadn't caught up. Finally, in 2020, things are different: with a global pandemic, and some vacation time, and something random causing me
to look up the state of HTML custom elements, everything was pointing at it being time to finally, <em>finally</em>, turn the Primer back into
a normal web page.
</p>
<p>
The new tech stack is, frankly, pretty amazing. It does some things that weren't possible even half a year before I started the rewrite, let
alone being possible in 2016, and so because so much has changed, this post will be the first in a series of posts on how the new tech stack
works.
</p>
<p>To give a bit of a teaser, some of the things I'll be writing about:</p> <p>To give a bit of a teaser, some of the things I'll be writing about:</p>
<ul> <ul>
<li>Essentially reinventing (a limited form of) Processing.js</li> <li>Essentially reinventing (a limited form of) Processing.js</li>
<li>Writing a custom build system, because I'm exhausted with Webpack and hope to never use it again.</li> <li>Writing a custom build system, because I'm exhausted with Webpack and hope to never use it again.</li>
<li>Using modern ES module code that runs in both the browser and Node.js.</li> <li>Using modern ES module code that runs in both the browser and Node.js.</li>
<li>Chapter content written as easy to read and write markdown format: <a href="./news/2020-09-18.md">view this blog post's source file</a>.</li> <li>
Chapter content written as easy to read and write markdown format: <a href="./news/2020-09-18.md">view this blog post's source file</a>.
</li>
<li>A custom <code>&lt;graphics-element&gt;</code> element that turns a <code>src="blah.js"</code> into an interactive canvas graphic...</li> <li>A custom <code>&lt;graphics-element&gt;</code> element that turns a <code>src="blah.js"</code> into an interactive canvas graphic...</li>
<li>...with that same source code being read in and run by Node.js <em>on a canvas</em> to generate fallback images.</li> <li>...with that same source code being read in and run by Node.js <em>on a canvas</em> to generate fallback images.</li>
</ul> </ul>
@@ -127,16 +152,20 @@
<graphics-element title="An example graphic" width="275" height="275" src="./news/example.js"> <graphics-element title="An example graphic" width="275" height="275" src="./news/example.js">
<fallback-image> <fallback-image>
<span class="view-source">Scripts are disabled. Showing fallback image.</span> <span class="view-source">Scripts are disabled. Showing fallback image.</span>
<img width="275px" height="275px" src="./images/news/2020-09-18.html/b465a1526a406578c9806a9985e2dbd0.png" loading="lazy"> <img width="275px" height="275px" src="./images/news/2020-09-18.html/b465a1526a406578c9806a9985e2dbd0.png" loading="lazy" />
<label>An example graphic</label> <label>An example graphic</label>
</fallback-image></graphics-element> </fallback-image></graphics-element
>
</blockquote> </blockquote>
<ul> <ul>
<li>Real LaTeX code, that gets compiled into optimized SVG using <code>xelatex</code>, <code>pdfcrop</code>, <code>pdf2svg</code>, and <code>svgo</code>:</li> <li>
Real LaTeX code, that gets compiled into optimized SVG using <code>xelatex</code>, <code>pdfcrop</code>, <code>pdf2svg</code>, and
<code>svgo</code>:
</li>
</ul> </ul>
<blockquote> <blockquote>
<img class="LaTeX SVG" src="./images/news/2020-09-18.html/15225da473048d8c7b5b473b89de0b66.svg" width="401px" height="97px" loading="lazy"> <img class="LaTeX SVG" src="./images/news/2020-09-18.html/15225da473048d8c7b5b473b89de0b66.svg" width="401px" height="97px" loading="lazy" />
</blockquote> </blockquote>
<ul> <ul>
@@ -146,8 +175,12 @@
<li>with some code formatting so that there are line numbers without needing JS:</li> <li>with some code formatting so that there are line numbers without needing JS:</li>
</ul> </ul>
<table class="code"><tr><td>1</td><td rowspan="13"> <table class="code">
<textarea disabled rows="13" role="doc-example">let curve; <tr>
<td>1</td>
<td rowspan="13">
<textarea disabled rows="13" role="doc-example">
let curve;
setup() { setup() {
curve = Bezier.defaultCubic(); curve = Bezier.defaultCubic();
@@ -159,20 +192,47 @@ draw() {
clear(`lightblue`); clear(`lightblue`);
curve.drawCurve(); curve.drawCurve();
curve.drawPoints(); curve.drawPoints();
}</textarea> }</textarea
</td></tr> >
<tr><td>2</td></tr> </td>
<tr><td>3</td></tr> </tr>
<tr><td>4</td></tr> <tr>
<tr><td>5</td></tr> <td>2</td>
<tr><td>6</td></tr> </tr>
<tr><td>7</td></tr> <tr>
<tr><td>8</td></tr> <td>3</td>
<tr><td>9</td></tr> </tr>
<tr><td>10</td></tr> <tr>
<tr><td>11</td></tr> <td>4</td>
<tr><td>12</td></tr> </tr>
<tr><td>13</td></tr></table> <tr>
<td>5</td>
</tr>
<tr>
<td>6</td>
</tr>
<tr>
<td>7</td>
</tr>
<tr>
<td>8</td>
</tr>
<tr>
<td>9</td>
</tr>
<tr>
<td>10</td>
</tr>
<tr>
<td>11</td>
</tr>
<tr>
<td>12</td>
</tr>
<tr>
<td>13</td>
</tr>
</table>
<ul> <ul>
<li>Responsive CSS, so the content intelligently reflows where possible.</li> <li>Responsive CSS, so the content intelligently reflows where possible.</li>
@@ -180,26 +240,23 @@ draw() {
<li>Automatic link-checking to make sure none of the links in the Primer lead you to a 404.</li> <li>Automatic link-checking to make sure none of the links in the Primer lead you to a 404.</li>
<li>This "news" section, so that I can write posts to go along with new sections getting added, or notable changes being made.</li> <li>This "news" section, so that I can write posts to go along with new sections getting added, or notable changes being made.</li>
</ul> </ul>
<p>It's going to take me a while to detail the entire tech stack, but ultimately what matters is that you get a Primer that is a normal "vanilla" HTML, CSS, and JS page again, that "just works" even with JS disabled.</p> <p>
<p>Enjoy <a href="https://pomax.github.io/bezierinfo">The new Primer on Bézier Curves</a>, and if you find any problems, <a href="https://github.com/Pomax/BezierInfo-2/issues">you know where to go</a>.</p> It's going to take me a while to detail the entire tech stack, but ultimately what matters is that you get a Primer that is a normal "vanilla"
HTML, CSS, and JS page again, that "just works" even with JS disabled.
</p>
<p>
Enjoy <a href="https://pomax.github.io/bezierinfo">The new Primer on Bézier Curves</a>, and if you find any problems,
<a href="https://github.com/Pomax/BezierInfo-2/issues">you know where to go</a>.
</p>
<p>See you in the next post!</p> <p>See you in the next post!</p>
<p>— Pomax</p> <p>— Pomax</p>
</main> </main>
<hr> <hr />
<footer class="copyright">
This post is a news entry for the <a href="https://pomax.github.io/bezierinfo/">Primer on Bézier Curves</a>
</footer>
<footer class="copyright">This post is a news entry for the <a href="https://pomax.github.io/bezierinfo/">Primer on Bézier Curves</a></footer>
<!-- fix firefox's scroll position algorithm. Due to how it works, it cannot be async/defer --> <!-- fix firefox's scroll position algorithm. Due to how it works, it cannot be async/defer -->
<script src="./js/site/fix-scroll.js"></script> <script src="./js/site/fix-scroll.js"></script>
</body> </body>
</html> </html>

49
docs/news/index.html
View File

@@ -1,17 +1,15 @@
<!DOCTYPE html> <!DOCTYPE html>
<html lang="en-GB"> <html lang="en-GB">
<head> <head>
<meta charset="utf-8" /> <meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" /> <meta name="viewport" content="width=device-width, initial-scale=1" />
<title>A Primer on Bézier Curves - News</title> <title>A Primer on Bézier Curves - News</title>
<base href=".."> <base href=".." />
<link rel="icon" href="images/favicon.png" type="image/png" /> <link rel="icon" href="images/favicon.png" type="image/png" />
<link rel="alternate" type="application/rss+xml" title="RSS" href="news/rss.xml"> <link rel="alternate" type="application/rss+xml" title="RSS" href="news/rss.xml" />
<!-- page styling --> <!-- page styling -->
<link rel="preload" href="images/paper.png" as="image" /> <link rel="preload" href="images/paper.png" as="image" />
@@ -28,7 +26,7 @@
<meta property="og:description" content="" /> <meta property="og:description" content="" />
<meta property="og:locale" content="en-GB" /> <meta property="og:locale" content="en-GB" />
<meta property="og:type" content="article" /> <meta property="og:type" content="article" />
<meta property="og:published_time" content="Fri Sep 25 2020 16:00:34 GMT-0700 (Pacific Daylight Time)" /> <meta property="og:published_time" content="Fri Sep 25 2020 16:03:04 GMT-0700 (Pacific Daylight Time)" />
<meta property="og:updated_time" content="" /> <meta property="og:updated_time" content="" />
<meta property="og:author" content="Mike 'Pomax' Kamermans" /> <meta property="og:author" content="Mike 'Pomax' Kamermans" />
<meta property="og:section" content="Bézier Curves" /> <meta property="og:section" content="Bézier Curves" />
@@ -42,8 +40,6 @@
<meta name="twitter:url" content="https://pomax.github.io/bezierinfo" /> <meta name="twitter:url" content="https://pomax.github.io/bezierinfo" />
<meta name="twitter:description" content="" /> <meta name="twitter:description" content="" />
<!-- my own referral/page hit tracker, because Google knows enough --> <!-- my own referral/page hit tracker, because Google knows enough -->
<script src="./js/site/referrer.js" type="module" async></script> <script src="./js/site/referrer.js" type="module" async></script>
@@ -58,7 +54,6 @@
<!-- make images lazy load much earlier --> <!-- make images lazy load much earlier -->
<script src="./js/site/better-lazy-loading.js" type="module" async defer></script> <script src="./js/site/better-lazy-loading.js" type="module" async defer></script>
</head> </head>
<body> <body>
@@ -67,63 +62,47 @@
<script> <script>
(function () { (function () {
var loc = window.location.toString(); var loc = window.location.toString();
if (loc.includes('localhost') || loc.includes('BezierInfo-2')) { if (loc.includes("localhost") || loc.includes("BezierInfo-2")) {
var e = document.querySelector('div.dev'); var e = document.querySelector("div.dev");
e.removeAttribute("style"); e.removeAttribute("style");
} }
}()); })();
</script> </script>
</div> </div>
<div class="github"> <div class="github">
<img src="images/ribbon.png" alt="This page on GitHub" style="border:none;" useMap="#githubmap" width="200" height="149" /> <img src="images/ribbon.png" alt="This page on GitHub" style="border: none;" usemap="#githubmap" width="200" height="149" />
<map name="githubmap"> <map name="githubmap">
<area shape="poly" coords="30,0, 200,0, 200,114" href="http://github.com/pomax/BezierInfo-2" alt="This page on GitHub" /> <area shape="poly" coords="30,0, 200,0, 200,114" href="http://github.com/pomax/BezierInfo-2" alt="This page on GitHub" />
</map> </map>
</div> </div>
<header> <header>
<h1>News posts</h1> <h1>News posts</h1>
</header> </header>
<main> <main>
<p> <p>
Every now and then the Primer gets updated - these posts chronicle the evolution of the site, Every now and then the Primer gets updated - these posts chronicle the evolution of the site, and hopefully offer interesting information not
and hopefully offer interesting information not just about the process of maintaining a resource just about the process of maintaining a resource like this, but also neat tech tricks, implementation approaches, maths that didn't make it
like this, but also neat tech tricks, implementation approaches, maths that didn't make it into into the primer itself, etc.
the primer itself, etc.
</p> </p>
<p> <p>
This section is still very new, so for the moment there aren't all that many posts up yet, but This section is still very new, so for the moment there aren't all that many posts up yet, but there's a series of posts planned already, and
there's a series of posts planned already, and if you're the kind of person who likes to keep if you're the kind of person who likes to keep tabs on updates by using RSS: good news, <a href="news/rss.xml">have an RSS link!</a>.
tabs on updates by using RSS: good news, <a href="news/rss.xml">have an RSS link!</a>.
</p> </p>
<ul> <ul>
<li><a href="news/2020-09-18.html">Rewriting the tech stack</a> (Fri, 18 Sep 2020)</li> <li><a href="news/2020-09-18.html">Rewriting the tech stack</a> (Fri, 18 Sep 2020)</li>
</ul> </ul>
</main> </main>
<hr> <hr />
<footer class="copyright">
This post is a news entry for the <a href="..">Primer on Bézier Curves</a>
</footer>
<footer class="copyright">This post is a news entry for the <a href="..">Primer on Bézier Curves</a></footer>
<!-- fix firefox's scroll position algorithm. Due to how it works, it cannot be async/defer --> <!-- fix firefox's scroll position algorithm. Due to how it works, it cannot be async/defer -->
<script src="./js/site/fix-scroll.js"></script> <script src="./js/site/fix-scroll.js"></script>
</body> </body>
</html> </html>

2
docs/news/rss.xml
View File

@@ -6,7 +6,7 @@
<atom:link href="https://pomax.github.io/bezierinfo" rel="self"></atom:link> <atom:link href="https://pomax.github.io/bezierinfo" rel="self"></atom:link>
<description>News updates for the <a href="https://pomax.github.io/bezierinfo">primer on Bézier Curves</a> by Pomax</description> <description>News updates for the <a href="https://pomax.github.io/bezierinfo">primer on Bézier Curves</a> by Pomax</description>
<language>en-GB</language> <language>en-GB</language>
<lastBuildDate>Fri Sep 25 2020 16:00:34 +00:00</lastBuildDate> <lastBuildDate>Fri Sep 25 2020 16:03:04 +00:00</lastBuildDate>
<image> <image>
<url>https://pomax.github.io/bezierinfo/images/og-image.png</url> <url>https://pomax.github.io/bezierinfo/images/og-image.png</url>
<title>A Primer on Bézier Curves</title> <title>A Primer on Bézier Curves</title>

7150
docs/zh-CN/index.html
View File

File diff suppressed because it is too large Load Diff