'\" t
.\"     Title: apache-icons
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 20170405
.\"    Manual: Open Infrastructure
.\"    Source: container-tools
.\"  Language: English
.\"
.TH "APACHE\-ICONS" "7" "20170405" "container\-tools" "Open Infrastructure"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
apache-icons \- Alternative icons for Apache autoindex
.SH "DESCRIPTION"
.sp
"The Apache HTTP Server is the world\(cqs most used web server software\&."  \(em Wikipedia (https://en\&.wikipedia\&.org/wiki/Apache_HTTP_Server)
.sp
apache\-icons provides alternative icons for Apache autoindex\&.
.SH "DOWNLOAD"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Upstream Releases:
https://files\&.open\-infrastructure\&.net/software/apache\-icons/upstream
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Upstream Sources:
https://sources\&.open\-infrastructure\&.net/software/apache\-icons
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Debian Releases:
https://files\&.open\-infrastructure\&.net/software/apache\-icons/debian
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Debian Sources:
https://sources\&.progress\-linux\&.org/users/daniel/debian/packages/open\-infrastructure\-apache\-icons
.RE
.SH "INSTALLATION"
.SS "SOURCE"
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
sudo apt install asciidoc git docbook\-xml docbook\-xsl libxml2\-utils make xsltproc imagemagick librsvg2\-bin
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
git clone
https://sources\&.open\-infrastructure\&.net/software/apache\-icons
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
cd apache\-icons && sudo make install
.RE
.SS "DEBIAN 9 (STRETCH) AND NEWER"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
sudo apt install apache\-icons
.RE
.SH "UBUNTU 16\&.10 (YAKKETY) AND NEWER"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
sudo apt install apache\-icons
.RE
.SH "DEVELOPMENT"
.sp
Bug reports, feature requests, help, patches, support and everything else are welcome on the Open Infrastructure Software Mailing List:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
https://lists\&.open\-infrastructure\&.net/listinfo/software
.RE
.sp
Please base patches against the \fInext\fR Git branch using common sense:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
https://www\&.kernel\&.org/doc/Documentation/SubmittingPatches
.RE
.sp
Debian specific bugs can also be reported in the Debian Bug Tracking System:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
https://bugs\&.debian\&.org
.RE
.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 "sudo update\-alternatives \-\-config apache\-icons" can be used to automatically select the active icon theme (including the default apache icons)\&.
.sp
The following themes are available:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
awesome\-png: Font Awesome based, PNG format
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
awesome\-svg: Font Awesome based, SVG format
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
tango\-png: Tango Icons based, PNG format
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
tango\-svg: Tango Icons based, SVG format
.RE
.sp
The SVG themes are preferable because they are sharper and scale losless\&. They require somewhat modern browsers though\&.
.sp
An example of the tango\-svg theme can be seen on https://files\&.open\-infrastructure\&.net\&.
.SH "LINKS"
.PP
\fBFont Awesome:\fR
.RS 4
http://fontawesome\&.io/
.RE
.PP
\fBTango Desktop Project:\fR
.RS 4
http://tango\&.freedesktop\&.org/
.RE
.SH "AUTHORS"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Daniel Baumann <daniel\&.baumann@open\-infrastructure\&.net>
.RE