HostARM

HostARM is a CGI program providing

• Ada Reference Manual 2012
• Ada Reference Manual 2022
• Annotated Ada Reference Manual 202Y (Draft 5)

HostARM focuses on user friendliness and more modern look of the manuals.

Benefits

• Search not dependant on external hosts
• Keypress navigation
• Shorter URL: Remove two levels of the URL and no html ending
• Optional stripping of navigation bars
• Alphabet navigation bar in index

Installation

HostARM is distributed as an Alire crate.

alr install hostarm

Apache configuration

This applies to Debian/Ubuntu.

After configuration of Apache, HostARM should be accessible at
/localhost:2778/home.

Why 2778?

2778 is decimal 16#Ada#.

Configuration

Put this into /etc/apache2/sites-available/hostarm.conf:

<VirtualHost *:2778>
    ServerName localhost
    <Directory /var/www/html/>
        Options +ExecCGI +FollowSymLinks -SymLinksIfOwnerMatch
        AllowOverride None
        Require all granted
    </Directory>

    <Files "hostarm">
        SetHandler cgi-script
    </Files>

    RewriteEngine On
    RewriteCond %{REQUEST_URI} !^/hostarm
    RewriteRule ^/(.*)$ /hostarm/$1 [L]

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Enable the required Apache modules (mod_cgid rather than mod_cgi, since the default mpm_event MPM is not compatible with mod_cgi):
a2enmod rewrite cgid

Put HostARM configuration on the list of enabled sites:
ln -s /etc/apache2/sites-available/hostarm.conf /etc/apache2/sites-enabled

Make Apache listen to port 2778:
Add Listen 2778 to /etc/apache2/ports.conf.

Make HostARM available as CGI program:
ln -s /home/USER/.alire/bin/hostarm /var/www/html/, with USER replaced.

Reload the new Apache configuration:
systemctl reload apache2

Links

• Alire crate.
• Project website.

Screenshot