.\" Open Infrastructure: service-tools
.\"
.\" Copyright (C) 2014-2022 Daniel Baumann <daniel.baumann@open-infrastructure.net>
.\"
.\" SPDX-License-Identifier: GPL-3.0+
.\"
.\" This program is free software: you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation, either version 3 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
.\"
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "APACHE-TOOLS" 7  service-tools "Open Infrastructure"
.SH NAME
apache-tools \- Extra tools for Apache HTTP server
.SH DESCRIPTION
.sp
This package is a collection of extra tools for the Apache HTTP server,
currently containing:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
alternative icons for Apache autoindex
(Tango Icons and Font Awesome based themes)
.UNINDENT
.UNINDENT
.UNINDENT
.SH DOWNLOAD
.nf
Upstream Releases:
\fI\%https://get.open\-infrastructure.net/software/service\-tools/upstream\fP
.fi
.sp
.nf
Upstream Sources:
\fI\%https://git.open\-infrastructure.net/software/service\-tools\fP
.fi
.sp
.nf
Debian Releases:
\fI\%https://get.open\-infrastructure.net/software/service\-tools/debian\fP
.fi
.sp
.nf
Debian Sources:
\fI\%https://git.progress\-linux.org/users/daniel/debian/packages/open\-infrastructure\-service\-tools\fP
.fi
.sp
.SH INSTALLATION
.SS Source
.nf
$ sudo apt install git make python3\-docutils
$ git clone \fI\%https://git.open\-infrastructure.net/software/service\-tools\fP
$ cd service\-tools/apache && sudo make install
.fi
.sp
.SS Debian 9 (stretch) and newer
.nf
$ sudo apt install apache\-tools
.fi
.sp
.SH DEVELOPMENT
.sp
Bug reports, feature requests, help, patches, support and everything else are
welcome on the Open Infrastructure Software Mailing List
(\fI\%https://lists.open\-infrastructure.net/listinfo/software\fP).
.sp
Please base patches against the \(aqnext\(aq Git branch using common sense
(\fI\%https://www.kernel.org/doc/Documentation/SubmittingPatches\fP).
.sp
Debian specific bugs can also be reported in the Debian Bug Tracking System
(\fI\%https://bugs.debian.org\fP).
.SH KNOWN LIMITATIONS
.sp
Changing from one icon set to the other requires a reload of the apache webserver.
.SH USAGE
.sp
The default icon theme is determined by the /usr/share/apache\-icons/default
(and /usr/share/apache\-icons/default.conf respectivly) file.
.sp
On Debian based system \(dqsudo update\-alternatives \-\-config apache\-icons\(dq can be
used to automatically select the active icon theme (including the default apache
icons).
.sp
The following themes are available:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
awesome\-png: Fork Awesome based, PNG format
.IP \(bu 2
awesome\-svg: Fork Awesome based, SVG format
.IP \(bu 2
tango\-png: Tango Icons based, PNG format
.IP \(bu 2
tango\-svg: Tango Icons based, SVG format
.UNINDENT
.UNINDENT
.UNINDENT
.sp
The SVG themes are preferable because they are sharper and scale losless.
Very old browser can not render SVG icons, use PNG if that is a concern.
.sp
An example of the tango\-svg theme can be seen on
\fI\%https://get.open\-infrastructure.net\fP\&.
.SH LINKS
.nf
* Fork Awesome
.in +2
(\fI\%https://forkaweso.me\fP)
.in -2
.fi
.sp
.nf
* Tango Desktop Project
.in +2
(\fI\%http://tango.freedesktop.org\fP)
.in -2
.fi
.sp
.SH AUTHORS
.sp
service\-tools were written by Daniel Baumann
<\fI\%daniel.baumann@open\-infrastructure.net\fP> and others.
.