summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorThomas Voss <mail@thomasvoss.com> 2023-08-28 01:16:00 +0300
committerThomas Voss <mail@thomasvoss.com> 2023-08-28 01:16:00 +0300
commitf75eadfe20aecda45a13b8ad41ac30116f371148 (patch)
treeb64cfffc4a0d7ae32f73bbe66b00b84facdb53e6
parent680cec5590e98b2a1a13b6f9875d19e544101b6f (diff)
Add a post for ‘mkpass’
-rw-r--r--Makefile2
-rw-r--r--src/prj/index.html1
-rw-r--r--src/prj/mkpass/basic-usage.sh.html6
-rw-r--r--src/prj/mkpass/index.html93
-rw-r--r--src/prj/mkpass/length-flag.sh.html4
5 files changed, 106 insertions, 0 deletions
diff --git a/Makefile b/Makefile
index 6dadc1d..3b8a21c 100644
--- a/Makefile
+++ b/Makefile
@@ -32,6 +32,8 @@ src/srp/fw-ec/index.html: ${call gendeps,src/srp/fw-ec}
@touch $@
src/prj/mmv/index.html: ${call gendeps,src/prj/mmv}
@touch $@
+src/prj/mkpass/index.html: ${call gendeps,src/prj/mkpass}
+ @touch $@
check:
LANG=en_US.UTF-8 find src -name 'index.html' -exec \
diff --git a/src/prj/index.html b/src/prj/index.html
index 87f5d85..c38dd05 100644
--- a/src/prj/index.html
+++ b/src/prj/index.html
@@ -30,6 +30,7 @@
<p>Posts:</p>
<ul>
+ <li><a href="mkpass">mkpass — make a password</a></li>
<li><a href="mmv">mmv, mpc — mapped file moves and -copies</a></li>
</ul>
</main>
diff --git a/src/prj/mkpass/basic-usage.sh.html b/src/prj/mkpass/basic-usage.sh.html
new file mode 100644
index 0000000..ab1aca8
--- /dev/null
+++ b/src/prj/mkpass/basic-usage.sh.html
@@ -0,0 +1,6 @@
+$ <span class="sh-fn">mkpass</span>
+;%_)1S%wYO-unC6%D2pz9'bx^YFI&gt;&quot;VX;T[jzOUsiUr}r/R#T0Qs*XMT*fUef|2L
+$ <span class="sh-fn">mkpass</span> a-zA-Z0-9
+qTneHVHfwH3b1nCanKKW24lIcsRO2TUAgp7AGbZInfsV8ZjdsR35ZikHIzyUu06x
+$ <span class="sh-fn">mkpass</span> [:alpha:][:digit:]
+JlGe9kLOT1ik3CRvOb8VxHqHzluG6oLJ9VI8BVGFTn2lODu3pvTv5ZqeXy3XfT1R
diff --git a/src/prj/mkpass/index.html b/src/prj/mkpass/index.html
new file mode 100644
index 0000000..546e5f1
--- /dev/null
+++ b/src/prj/mkpass/index.html
@@ -0,0 +1,93 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ m4_include(head.html)
+ </head>
+ <body>
+ <header>
+ <div>
+ <h1>Easy Password Generation</h1>
+ m4_include(nav.html)
+ </div>
+
+ <figure class="quote">
+ <blockquote>
+ <p>Why does JavaScript suck? The answer is simple: history. JavaScript
+ was created by a really smart guy called Brendan Eich over a period of
+ a week or so. He did it because Microsoft was largely perceived as
+ evil, and his aim was to create a programming platform in the Netscape
+ navigator. That way, the browser would run everywhere, and the OS
+ wouldn't matter as much. HAHA! Down with Microsoft. You can see how
+ well that worked out.</p>
+ </blockquote>
+ <figcaption>
+ Sahil Malik
+ </figcaption>
+ </figure>
+ </header>
+
+ <main>
+ <p>
+ <em>
+ You can find the <code>mkpass</code> git repository over at
+ <a href="https://git.st.ht/~mango/mkpass"
+ target="_blank">sourcehut</a>
+ or <a href="https://github.com/Mango0x45/mkpass">GitHub</a>.
+ </em>
+ </p>
+
+ <h2>Table of Contents</h2>
+
+ <ul>
+ <li><a href="#prologue">Prologue</a></li>
+ <li><a href="#usage">Basic Usage</a></li>
+ </ul>
+
+ <h2 id="prologue">Prologue</h2>
+ <p>
+ Password generators are incredibly useful for those who don’t use the
+ same password everywhere. The issue is that everyone uses the same
+ password everywhere. Hopefully when people see how easy password
+ generation can be, that’ll change; there really is no excuse to not use
+ different passwords these days. <code>mkpass</code> aims to be the
+ absolute simplest password generator possible while still providing the
+ functionality you need.ls
+ </p>
+
+ <p>
+ Two factor authentication is also something you should be using — and
+ something that is very easy to manage — and something that I will be
+ posting about shortly™.
+ </p>
+
+ <h2 id="usage">Basic Usage</h2>
+ <p>
+ The most basic usage of <code>mkpass</code> is to just
+ call <code>mkpass</code>. By default this will generate a 64-character
+ password made up of random printable characters. If you need to use
+ specific characters (for example, maybe you can only use alphanumeric
+ characters) then you can simply specify a
+ <code><a href="https://www.man7.org/linux/man-pages/man1/tr.1.html"
+ target="_blank">tr(1)</a></code> style range:
+ </p>
+
+ <figure>
+ <pre>m4_fmt_code(basic-usage.sh.html)</pre>
+ </figure>
+
+ <p>
+ You can also specify the length of the password using
+ the <code>-l</code> flag:
+ </p>
+
+ <figure>
+ <pre>m4_fmt_code(length-flag.sh.html)</pre>
+ </figure>
+
+ And that ladies and gentlemen, is the entire program. A nice minimal tool
+ that does one thing and one thing only, while integrating nicely with the
+ UNIX environment. This is (in my opinion), an example of well-designed
+ software.
+ </main>
+ </body>
+</html>
diff --git a/src/prj/mkpass/length-flag.sh.html b/src/prj/mkpass/length-flag.sh.html
new file mode 100644
index 0000000..f9405a1
--- /dev/null
+++ b/src/prj/mkpass/length-flag.sh.html
@@ -0,0 +1,4 @@
+$ <span class="sh-fn">mkpass</span> a-z
+hxjgusvfxzfasluhlkxvsdszxbzoffkyruauiggigjmhptivctnudnkiararlwcn
+$ <span class="sh-fn">mkpass</span> -l 12 a-z
+wymyggnmwkwz