commit 69a3d32e321428c6937a548b780ab769fdc7b3ef (patch)
parent 994b675c7a3f8fd2b1ab3ae14e634efea36480b3
Author: Alex Karle <alex@alexkarle.com>
Date: Mon, 19 Jul 2021 21:02:00 -0400
doc: Linkify README (now that we're on sr.ht)
Now that this is a sr.ht project, we need real Markdown!
Diffstat:
| M | README.md | | | 57 | +++++++++++++++++++++++++++++---------------------------- |
1 file changed, 29 insertions(+), 28 deletions(-)
diff --git a/README.md b/README.md
@@ -4,36 +4,37 @@ My small corner of the internet.
www.
----
-A static site comprised of mdoc(7) flavored man pages, built to HTML via
-mandoc(1) (managed by make(1)).
+A static site comprised of [mdoc(7)][mdoc] flavored man pages, built to
+HTML via [mandoc(1)][mandoc] (managed by [make(1)][make]).
-Currently hosted with OpenBSD's httpd(8), but any web server should be able to
-serve it up.
+Currently hosted with OpenBSD's [httpd(8)][httpd], but any web server
+should be able to serve it up.
git.
----
I use a simple setup of git-daemon for anonymous (read-only) downloads,
-ssh+git for read+write access (limited to myself) and stagit(1) to host static
-views into the diffs and files of each repo.
-
-I like the stagit approach in that it is simple, modular, and emphasizes the use
-of regular git for larger operations (i.e. diff between refs, etc).
-
-I use the default post-receive and create scripts that ship with the tool (with
-small modifications for the installation). The logo is in this repo as
-logo.png.
-
-The content, being static, is served up with httpd(8) as well.
-
-See Also:
----------
-* [mandoc(1)](https://man.openbsd.org/mandoc.1)
-* [mdoc(7)](https://man.openbsd.org/mdoc.7)
-* [stagit(1)](https://git.codemadness.org/stagit)
-* [httpd(8)](https://man.openbsd.org/httpd.8)
-* [git-daemon(1)](https://git-scm.com/docs/git-daemon)
-
-I also discuss the setup in my blog posts
-[self-hosted(7)](https://alexkarle.com/self-hosted.html)
-and
-[my-old-man(7)](https://alexkarle.com/my-old-man.html).
+ssh+git for read+write access (limited to myself) and
+[stagit(1)][stagit] to host static views into the diffs and files of
+each repo.
+
+I like the stagit approach in that it is simple, modular, and emphasizes
+the use of regular git for larger operations (i.e. diff between refs,
+etc).
+
+I use the default post-receive and create scripts that ship with the
+tool (with small modifications for the installation). The logo is in
+this repo as logo.png.
+
+The content, being static, is served up with [httpd(8)][httpd] as well.
+
+I also discuss the setup in my blog posts [self-hosted(7)][self-hosted]
+and [my-old-man(7)][my-old-man].
+
+[mdoc]: https://man.openbsd.org/mdoc.7
+[mandoc]: https://man.openbsd.org/mandoc.1
+[make]: https://man.openbsd.org/make.1
+[httpd]: https://man.openbsd.org/httpd.8
+[stagit]: https://git.codemadness.org/stagit
+[git-daemon]: https://git-scm.com/docs/git-daemon
+[self-hosted]: https://alexkarle.com/self-hosted.html
+[my-old-man]: https://alexkarle.com/my-old-man.html
