summaryrefslogtreecommitdiffhomepage
path: root/src/prj/mkpass/index.html
diff options
context:
space:
mode:
Diffstat (limited to 'src/prj/mkpass/index.html')
-rw-r--r--src/prj/mkpass/index.html93
1 files changed, 93 insertions, 0 deletions
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>