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