3 # $Id: SWInfo.pm,v 1.5 2004/04/08 01:52:19 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 #----- Package preamble -----------------------------------------------------
35 use SWCGI
qw(:DEFAULT
:layout
);
39 #----- Useful functions -----------------------------------------------------
41 # --- @subst(IREF, FILE, INFO)@ ---
43 # Given an Info reference and the name of the current Info file, returns an
44 # HTML anchor which represents the link.
47 my ($iref, $file, $i) = @_;
52 # --- Dig out the node and file being referred to ---
60 if ($iref =~ /^.+: *(.+)$/) { $iref = $1; }
61 if ($iref =~ /(?:\(([^\)]*)\))?(.*)$/) {
68 # --- Transform it into something that won't get mangled ---
70 $node = SWCGI::sanitize($node);
72 ($dir = $i->{dir}) =~ s:$C{prefix}/info/?::;
73 $dir = "&dir=" . SWCGI::sanitize($dir) if $dir;
75 return "<a href=\"$ref?act=info&file=$file&node=$node$dir\">$oref</a>$tail";
78 #----- Actions --------------------------------------------------------------
81 my $file = $Q{file} || "dir";
82 my $node = $Q{node} || "Top";
83 my $dir = $Q{dir} || "";
86 # --- Read the node in ---
88 Info::setpath("$C{prefix}/info");
90 "$dir/$file" =~ m:\./: and
91 barf("bad filename `$dir/$file'");
92 my $i = (($dir && Info->new("$dir/$file")) ||
94 or barf("couldn't find info file
`$file'");
95 my $n = $i->node($node) or
96 barf("info file `$file' doesn't contain node
`$node'");
98 # --- Now translate the node into HTML, first line first ---
103 $n =~ s/\A( [^\n]* Next:\ *) ([^,\n]*) / $1 . subst($2, $file, $i) /eix;
104 $n =~ s/\A( [^\n]* Prev:\ *) ([^,\n]*) / $1 . subst($2, $file, $i) /eix;
105 $n =~ s/\A( [^\n]* Up:\ *) ([^,\n]*) / $1 . subst($2, $file, $i) /eix;
107 # --- Grind through picking up any notes ---
112 if ($n =~ /(\*Note\s*)([^:]*: *(?:\([^\)]*\))?[^.,;:]*)([.,;:])/i) {
113 $out .= $` . $1 . subst
($2, $file, $i) . $3;
120 # --- If there's a menu then process that
---
122 if ($n =~ /\n\* *Menu:/s) {
126 if ($n =~ /(\n\* *)([^:]*: *(?:\([^\)]*\))?[^.,;:]*)([.,;:])/) {
127 $out .= $` . $1 . subst
($2, $file, $i) . $3;
136 # --- Spot URLs (except `mailto') ---
138 $out =~ s
! \b (http s?
| ftp
| file
| news
) :
139 [^]<>)\s
]* [^]<>).,\s
\']
140 !urlsubst
($&, $&)!egx
;
142 # --- Spot email addresses (including `mailto' URLs) ---
144 $out =~ s
! (?
:\bmailto
:)?
145 ([^\s
()<>&;:{}.,\
`\'\"] [^\s()<>&;:{}\`\'\"]*
147 [^\s
()<>&;:{}\'\"]* [^\s
()<>&;:{}.,\'\"])
148 !<a href
="mailto:$1">$&</a
>!gx
;
150 # --- Spot manpage references ---
152 $out =~ s
! ([-_
.\w
]+) \
( (\d
+\w
*) \
)
153 !SWMan
::subst
("$1($2)", $1, $2)!egx
;
155 # --- Fix up the HTML ---
157 $out =~ s/\<\</</g;
158 $out =~ s/\>\>/>/g;
160 header
("Info: ($file)$node");
161 print("<pre>\n$out</pre>\n");
165 #----- Actions provided -----------------------------------------------------
167 $main::ACT
{"info"} = \
&info
;
169 #----- That's all, folks ----------------------------------------------------