ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/server/ext/help.ext
(Generate patch)

Comparing deliantra/server/ext/help.ext (file contents):
Revision 1.3 by root, Wed Apr 18 17:57:24 2007 UTC vs.
Revision 1.15 by root, Tue Sep 23 04:29:11 2008 UTC

1#! perl 1#! perl
2 2
3our $TOPIC; 3our $TOPIC;
4
5our $HELP_CHANNEL = {
6 id => "help",
7 title => "Help",
8 reply => "help ",
9 tooltip => "Online Help",
10};
4 11
5sub load_topics($$) { 12sub load_topics($$) {
6 my ($type, $path) = @_; 13 my ($type, $path) = @_;
7 14
8 my $paragraphs = cf::pod::load_pod "$PODDIR/$path.pod" 15 my $paragraphs = cf::pod::load_pod "$PODDIR/$path.pod"
10 17
11 my @topics; 18 my @topics;
12 my $level = 1e9; 19 my $level = 1e9;
13 20
14 for my $par (@$paragraphs) { 21 for my $par (@$paragraphs) {
15 Coro::cede; 22 cf::cede_to_tick;
16 if ($par->{type} eq "head2") { 23 if ($par->{type} eq "head2") {
17 if ($par->{markup} =~ /^(\S+)/) { 24 if ($par->{markup} =~ /^(\S+)/) {
18 push @topics, $1 => [$type => $par]; 25 push @topics, $1 => [$type => $par];
19 $level = $par->{level}; 26 $level = $par->{level};
20 } 27 }
25 32
26 @topics 33 @topics
27} 34}
28 35
29sub reload() { 36sub reload() {
37 my $guard = cf::lock_acquire "ext::help::loading";
38
39 local $Coro::current->{desc} = "help loader";
40
30 $TOPIC = { 41 $TOPIC = {
31 (load_topics "DM Commands" => "dmcommand_help"), 42 (load_topics "DM Commands" => "dmcommand_help"),
32 (load_topics "Emotes" => "emote_help"), 43 (load_topics "Emotes" => "emote_help"),
33 (load_topics "Commands" => "command_help"), 44 (load_topics "Commands" => "command_help"),
34 (load_topics "Generic Help Topics" => "generic_help"), 45 (load_topics "Generic Help Topics" => "generic_help"),
35 }; 46 };
47
48 ()
36} 49}
37 50
38cf::sync_job { 51cf::post_init {
39 my $guard = cf::lock_acquire "ext::help::loading";
40 cf::async_ext {
41 reload; 52 reload;
42 undef $guard;
43 };
44}; 53};
54
55# for lack of a better place: "media tags"
56# b bold
57# i italic
58# ul underlined
59# fixed font
60# arcane font
61# hand font
62# strange font
63# print font (default)
64# color=xxx
45 65
46cf::register_command help => sub { 66cf::register_command help => sub {
47 my ($pl, $topic) = @_; 67 my ($pl, $topic) = @_;
48 68
49 if (cf::lock_active "ext::help::loading") { 69 if (cf::lock_active "ext::help::loading") {
50 $pl->reply (undef, "help files are being loaded currently, try again in a few seconds."); 70 $pl->send_msg ($HELP_CHANNEL => "help files are being loaded currently, try again in a few seconds.", cf::NDI_REPLY | cf::NDI_CLEAR);
51 return; 71 return;
52 } 72 }
53 73
54 $topic = $1 if $topic =~ /(\S+)/; 74 $topic = $1 if $topic =~ /(\S+)/;
55 75
61 push @{$topics{$v->[0]}}, $k; 81 push @{$topics{$v->[0]}}, $k;
62 } 82 }
63 83
64 my $res; 84 my $res;
65 while (my ($k, $v) = each %topics) { 85 while (my ($k, $v) = each %topics) {
66 $res .= "[b]$k:[/b]\n" . (join " ", @$v) . "\n\n"; 86 $res .= "T<$k:>\n\n" . (join " ", sort @$v) . "\n\n";
67 } 87 }
68 88
69 $pl->reply (undef, $res); 89 $pl->send_msg ($HELP_CHANNEL => $res, cf::NDI_REPLY | cf::NDI_CLEAR);
70 90
71 } elsif (my $topic = $TOPIC->{$topic}) { 91 } elsif (my $item = $TOPIC->{$topic}) {
72 my ($type, @pars) = @$topic; 92 my ($type, @pars) = @$item;
73 $pl->reply (undef, cf::pod::as_text \@pars); 93 $pl->send_msg ($HELP_CHANNEL => (cf::pod::as_cfpod \@pars), cf::NDI_REPLY | cf::NDI_CLEAR);
74 94
75 } else { 95 } else {
76 $pl->reply (undef, "'$topic' no such help topic, try just 'help' to get a list of topics."); 96 $pl->send_msg ($HELP_CHANNEL => "'$topic' no such help topic, try just 'help' to get a list of topics.", cf::NDI_REPLY);
77 } 97 }
78}; 98};
79 99

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines