3 # $Id: SWInfo.pm,v 1.3 1999/08/19 12:11:10 mdw Exp $
5 # Read and output GNU Info files
10 #----- Licensing notice -----------------------------------------------------
12 # This file is part of sw-tools.
14 # sw-tools is free software; you can redistribute it and/or modify
15 # it under the terms of the GNU General Public License as published by
16 # the Free Software Foundation; either version 2 of the License, or
17 # (at your option) any later version.
19 # sw-tools is distributed in the hope that it will be useful,
20 # but WITHOUT ANY WARRANTY; without even the implied warranty of
21 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 # GNU General Public License for more details.
24 # You should have received a copy of the GNU General Public License
25 # along with sw-tools; if not, write to the Free Software Foundation,
26 # Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
28 #----- Revision history -----------------------------------------------------
31 # Revision 1.3 1999/08/19 12:11:10 mdw
32 # More improvements to URL recognizer.
34 # Revision 1.2 1999/08/18 17:10:07 mdw
35 # Slight improvements to URL and email address parsing.
37 # Revision 1.1 1999/07/30 18:46:37 mdw
38 # New CGI script for browsing installed software and documentation.
41 #----- Package preamble -----------------------------------------------------
48 use SWCGI
qw(:DEFAULT
:layout
);
52 #----- Useful functions -----------------------------------------------------
54 # --- @subst(IREF, FILE, INFO)@ ---
56 # Given an Info reference and the name of the current Info file, returns an
57 # HTML anchor which represents the link.
60 my ($iref, $file, $i) = @_;
65 # --- Dig out the node and file being referred to ---
73 if ($iref =~ /^.+: *(.+)$/) { $iref = $1; }
74 if ($iref =~ /(?:\(([^\)]*)\))?(.*)$/) {
81 # --- Transform it into something that won't get mangled ---
83 $node =~ s/[+&=%]|[^ -~]/sprintf("%%%02x", ord($&))/eg;
86 ($dir = $i->{dir}) =~ s:$C{prefix}/info/?::;
87 $dir = "&dir=$dir" if $dir;
89 return "<a href=\"$ref?act=info&file=$file&node=$node$dir\">$oref</a>$tail";
92 #----- Actions --------------------------------------------------------------
95 my $file = $Q{file} || "dir";
96 my $node = $Q{node} || "Top";
97 my $dir = $Q{dir} || "";
100 # --- Read the node in ---
102 Info::setpath("$C{prefix}/info");
104 "$dir/$file" =~ m:\./: and
105 barf("bad filename `$dir/$file'");
106 my $i = (($dir && Info->new("$dir/$file")) ||
108 or barf("couldn't find info file
`$file'");
109 my $n = $i->node($node) or
110 barf("info file `$file' doesn't contain node
`$node'");
112 # --- Now translate the node into HTML, first line first ---
117 $n =~ s/\A( [^\n]* Next:\ *) ([^,\n]*) / $1 . subst($2, $file, $i) /eix;
118 $n =~ s/\A( [^\n]* Prev:\ *) ([^,\n]*) / $1 . subst($2, $file, $i) /eix;
119 $n =~ s/\A( [^\n]* Up:\ *) ([^,\n]*) / $1 . subst($2, $file, $i) /eix;
121 # --- Grind through picking up any notes ---
126 if ($n =~ /(\*Note\s*)([^:]*: *(?:\([^\)]*\))?[^.,;:]*)([.,;:])/i) {
127 $out .= $` . $1 . subst
($2, $file, $i) . $3;
134 # --- If there's a menu then process that
---
136 if ($n =~ /\n\* *Menu:/s) {
140 if ($n =~ /(\n\* *)([^:]*: *(?:\([^\)]*\))?[^.,;:]*)([.,;:])/) {
141 $out .= $` . $1 . subst
($2, $file, $i) . $3;
150 # --- Spot URLs (except `mailto') ---
152 $out =~ s
! \b (http s?
| ftp
| file
| news
) :
153 [^]<>)\s
]* [^]<>).,\s
\']
154 !urlsubst
($&, $&)!egx
;
156 # --- Spot email addresses (including `mailto' URLs) ---
158 $out =~ s
! (?
:\bmailto
:)?
159 ([^\s
()<>&;:{}.,\
`\'\"] [^\s()<>&;:{}\`\'\"]*
161 [^\s
()<>&;:{}\'\"]* [^\s
()<>&;:{}.,\'\"])
162 !<a href
="mailto:$1">$&</a
>!gx
;
164 # --- Spot manpage references ---
166 $out =~ s
! ([-_
.\w
]+) \
( (\d
+\w
*) \
)
167 !SWMan
::subst
("$1($2)", $1, $2)!egx
;
169 # --- Fix up the HTML ---
171 $out =~ s/\<\</</g;
172 $out =~ s/\>\>/>/g;
174 header
("Info: ($file)$node");
175 print("<pre>\n$out</pre>\n");
179 #----- Actions provided -----------------------------------------------------
181 $main::ACT
{"info"} = \
&info
;
183 #----- That's all, folks ----------------------------------------------------