summaryrefslogtreecommitdiffhomepage
path: root/src/prj/mkpass
diff options
context:
space:
mode:
Diffstat (limited to 'src/prj/mkpass')
-rw-r--r--src/prj/mkpass/basic-usage.sh.gsp6
-rw-r--r--src/prj/mkpass/basic-usage.sh.html6
-rw-r--r--src/prj/mkpass/index.gsp106
-rw-r--r--src/prj/mkpass/index.html102
-rw-r--r--src/prj/mkpass/length-flag.sh.gsp4
-rw-r--r--src/prj/mkpass/length-flag.sh.html4
6 files changed, 116 insertions, 112 deletions
diff --git a/src/prj/mkpass/basic-usage.sh.gsp b/src/prj/mkpass/basic-usage.sh.gsp
new file mode 100644
index 0000000..bd8ddf7
--- /dev/null
+++ b/src/prj/mkpass/basic-usage.sh.gsp
@@ -0,0 +1,6 @@
+$ @span .sh-fn {-mkpass}
+m4_gsp_quote(⁨;%_)1S%wYO-unC6%D2pz9'bx^YFI>"VX;T[jzOUsiUr}r/R#T0Qs*XMT*fUef|2L⁩)m4_dnl
+$ @span .sh-fn {-mkpass} a-zA-Z0-9
+qTneHVHfwH3b1nCanKKW24lIcsRO2TUAgp7AGbZInfsV8ZjdsR35ZikHIzyUu06x
+$ @span .sh-fn {-mkpass} [:alpha:][:digit:]
+JlGe9kLOT1ik3CRvOb8VxHqHzluG6oLJ9VI8BVGFTn2lODu3pvTv5ZqeXy3XfT1R
diff --git a/src/prj/mkpass/basic-usage.sh.html b/src/prj/mkpass/basic-usage.sh.html
deleted file mode 100644
index ab1aca8..0000000
--- a/src/prj/mkpass/basic-usage.sh.html
+++ /dev/null
@@ -1,6 +0,0 @@
-$ <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.gsp b/src/prj/mkpass/index.gsp
new file mode 100644
index 0000000..a7ff910
--- /dev/null
+++ b/src/prj/mkpass/index.gsp
@@ -0,0 +1,106 @@
+html lang="en" {
+ head { m4_include(head.gsp) }
+ body {
+ header {
+ div {
+ h1 {-Easy Password Generation}
+ m4_include(nav.gsp)
+ }
+
+ figure .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.
+ }
+ }
+ figcaption {-Sahil Malik}
+ }
+ }
+
+ main {
+ p {
+ em {-
+ You can find the @code{-mkpass} git repository over at
+ @a
+ href="https://git.sr.ht/~mango/mkpass"
+ target="_blank"
+ {-sourcehut}
+ or
+ @a
+ href="https://github.com/Mango0x45/mkpass"
+ target="_blank"
+ {-GitHub}.
+ }
+ }
+
+ h2 {-Table of Contents}
+ ul {
+ li {a href="#prologue" {-Prologue}}
+ li {a href="#usage" {-Basic Usage}}
+ }
+
+ h2 #prologue {-Prologue}
+ 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} aims to be the absolute
+ simplest password generator possible while still providing the
+ functionality you need.ls
+ }
+
+ 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™.
+ }
+
+ h2 #usage {-Basic Usage}
+ p {-
+ The most basic usage of @code{-mkpass} is to just call @code{-mkpass}.
+ 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)}
+ }
+ style range:
+ }
+
+ figure {
+ pre { m4_fmt_code(basic-usage.sh.gsp) }
+ }
+
+ p {-
+ You can also specify the length of the password using
+ the @code{--l} flag:
+ }
+
+ figure {
+ pre { m4_fmt_code(length-flag.sh.gsp) }
+ }
+
+ p {-
+ 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.
+ }
+ }
+
+ hr{}
+
+ footer { m4_footer }
+ }
+}
diff --git a/src/prj/mkpass/index.html b/src/prj/mkpass/index.html
deleted file mode 100644
index 8180358..0000000
--- a/src/prj/mkpass/index.html
+++ /dev/null
@@ -1,102 +0,0 @@
-<!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.sr.ht/~mango/mkpass"
- target="_blank">sourcehut</a>
- or <a href="https://github.com/Mango0x45/mkpass"
- target="_blank">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>
-
- <p>
- 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.
- </p>
- </main>
-
- <hr>
-
- <footer>
- m4_footer
- </footer>
- </body>
-</html>
diff --git a/src/prj/mkpass/length-flag.sh.gsp b/src/prj/mkpass/length-flag.sh.gsp
new file mode 100644
index 0000000..24ed26e
--- /dev/null
+++ b/src/prj/mkpass/length-flag.sh.gsp
@@ -0,0 +1,4 @@
+$ @span .sh-fn {-mkpass} a-z
+hxjgusvfxzfasluhlkxvsdszxbzoffkyruauiggigjmhptivctnudnkiararlwcn
+$ @span .sh-fn {-mkpass} -l 12 a-z
+wymyggnmwkwz
diff --git a/src/prj/mkpass/length-flag.sh.html b/src/prj/mkpass/length-flag.sh.html
deleted file mode 100644
index f9405a1..0000000
--- a/src/prj/mkpass/length-flag.sh.html
+++ /dev/null
@@ -1,4 +0,0 @@
-$ <span class="sh-fn">mkpass</span> a-z
-hxjgusvfxzfasluhlkxvsdszxbzoffkyruauiggigjmhptivctnudnkiararlwcn
-$ <span class="sh-fn">mkpass</span> -l 12 a-z
-wymyggnmwkwz