summaryrefslogtreecommitdiffhomepage
path: root/src/prj/mkpass/index.html
blob: a5fdb4611b92dff9dec920002d4097cbf0e8b846 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
<!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>

			<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>