Date: Tue, 19 Feb 2013 00:27:01 -0800 From: "Constantine A. Murenin" <cnst++@FreeBSD.org> To: freebsd-chat@FreeBSD.org, freebsd-current@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: announcing mdoc.su, short manual page URLs Message-ID: <20130219082700.GA9938@Cns.Cns.SU>
index | next in thread | raw e-mail
Dear freebsd-{chat,current,doc}@,
I would like to announce and introduce <URL:http://mdoc.su/>,
a deterministic URL shortener for BSD manual pages,
written entirely in nginx.conf.
It supports several address schemes, for example:
http://mdoc.su/f/zfs
http://mdoc.su/f/zfs.8
http://mdoc.su/f/8/zfs
http://mdoc.su/freebsd/zfs
http://mdoc.su/FreeBSD/zfs
http://mdoc.su/d/hammer.5
http://mdoc.su/d/hammer.8
etc.
Source code for the whole mdoc.su.nginx.conf is available at:
https://github.com/cnst/mdoc.su
https://bitbucket.org/cnst/mdoc.su
Specifically, the following currently controls FreeBSD rewriting:
location /FreeBSD { rewrite ^/FreeBSD(/.*)?$ /f$1; }
location /f {
set $fb "http://www.freebsd.org/cgi/man.cgi?query=";
set $fs "&sektion=";
rewrite ^/freebsd(/.*)?$ /.$1;
rewrite ^/./([^/.]+)/([^/]+)$ $fb$2$fs$1 redirect;
rewrite ^/./([^/]+)\.([1-9])$ $fb$1$fs$2 redirect;
rewrite ^/./([^/]+)$ $fb$1$fs redirect;
rewrite ^/./?$ / last;
return 404;
}
Translation: "/FreeBSD" and "/freebsd" get rewritten to "/f" internally,
without any extra replies to the user, and then the rest of the URI is
analysed, and a "302 Found" redirect is finally issued to the user.
Pages like http://mdoc.su/f/ redirect to the main "/" page internally,
without affecting the URL that's visible to the user, making it easier
to keep a starting page specifically for one BSD.
Questions, comments and suggestions are very welcome.
Available through IPv4 and IPv6.
Enjoy!
Best regards,
Constantine.
home |
help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20130219082700.GA9938>