mirror of
https://github.com/tildeclub/tilde.club.git
synced 2026-10-25 00:55:38 +00:00
20 lines
1.1 KiB
Markdown
20 lines
1.1 KiB
Markdown
|
# 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](../../docs/community.md) for the current deployment
|
||
|
|
approach and [the setup guide](../../docs/how-to-set-up-a-tilde.md) for the host.
|