alexkarle.com

Source for alexkarle.com
git clone git://git.alexkarle.com/alexkarle.com.git
Log | Files | Refs | README | LICENSE

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:
MREADME.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