apache-tools(7)

📦
this version · 5 versions
, in ubuntu resolute, ubuntu stonking

💖 apache-tools — the manual, but make it make sense 💖

okay bestie, so this is apache-tools(7) from the Miscellaneous Information Manual, and it's literally just a lil doc explaining what this package is. sit with me, grab a boba 🧋

✨ NAME ✨

apache-tools — extra tools for the Apache HTTP server. that's it, that's the whole name section. extra. tools. slay 💅

🌸 DESCRIPTION 🌸

so this package is a whole lil collection of extra tools for the Apache HTTP server, and right now it contains:

  • alternative icons for Apache autoindex (Tango Icons and Font Awesome based themes) 🎀

that's the list. one bullet. iconic behavior honestly 👑

🦋 DOWNLOAD 🦋

here's where you go get it, no gatekeeping:

💜 INSTALLATION 💜

🧚 Source

if you're building it yourself, the vibe is:

$ sudo apt install git make python3-docutils
$ git clone <https://git.open-infrastructure.net/software/service-tools>
$ cd service-tools/apache && sudo make install

copy those exactly, don't freestyle, i'm begging 🙈

🍓 Debian 9 (stretch) and newer

and if you're on Debian 9 (stretch) or anything newer than that:

$ sudo apt install apache-tools

one line. that's the whole thing. we love an easy install 😭

🔥 DEVELOPMENT 🔥

bug reports, feature requests, help, patches, support and everything else are welcome on the Open Infrastructure Software Mailing List:

<https://lists.open-infrastructure.net/listinfo/software>

literally all of it. they want to hear from you, bestie 🫶

if you're submitting patches, please base them against the 'next' Git branch, using common sense:

<https://www.kernel.org/doc/Documentation/SubmittingPatches>

yes they linked the kernel's submitting-patches doc. common sense is a skill and they're handing you the homework 💀

and if it's a Debian specific bug, you can also report that in the Debian Bug Tracking System: <https://bugs.debian.org>

😭 KNOWN LIMITATIONS 😭

so here's the one thing you gotta know and it's mildly annoying:

changing from one icon set to the other requires a reload of the apache webserver.

no hot-swap, no magic. reload the webserver. that's the rule ✨

👑 USAGE 👑

k so here's how you actually pick your icons. the default icon theme is determined by the /usr/share/apache-icons/default (and /usr/share/apache-icons/default.conf respectivly) file.

on Debian based system, this command right here:

sudo update-alternatives --config apache-icons

can be used to automatically select the active icon theme (including the default apache icons). automatic selection? we love to see it 🙌

the following themes are available:

  • awesome-png: Fork Awesome based, PNG format
  • awesome-svg: Fork Awesome based, SVG format
  • tango-png: Tango Icons based, PNG format
  • tango-svg: Tango Icons based, SVG format

and the tea on which one to pick: the SVG themes are preferable because they are sharper and scale losless. but — very old browser can not render SVG icons, so use PNG if that is a concern. know your audience, i guess 💀

an example of the tango-svg theme can be seen on <https://get.open-infrastructure.net>. go look, it's giving ✨

💖 AUTHORS 💖

service-tools were written by Daniel Baumann <daniel.baumann@open-infrastructure.net> and others. shoutout to the and-others, we see you 🫶

and that's the whole page bestie!! ily, go reload your apache server 💅

this was the Open Infrastructure service-tools manual, apache-tools(7) — mwah 💋

📦 where this page comes from