1.1 KiB
Connection-list utility
social.sh and ack2list.pl are retained historical utilities. The shell
pipeline uses ack to find local tilde links, then the Perl script generates an
HTML table. css/social.css supplies the stylesheet.
The original pipeline assumes a working directory containing ack2list.pl and
an output directory named public_html. It scans /home, has hard-coded
exclusions, and does not safely escape all filesystem/link values as HTML.
It is not an appropriate root job or a web-request handler on a new shared host.
Before using a reviewed copy, restrict scanning to intended public HTML, handle permissions and symlinks, bound the scan, validate/escape the output, and publish atomically from staging. Decide whether indexing is opt-in and how members exclude a page. Preserve other people's private files and do not interpret local links as shell commands.
The docs refresh keeps the utility and stylesheet intact for existing users. See community tooling for the current deployment approach and the setup guide for the host.