| 1 |
#! perl # mandatory |
| 2 |
|
| 3 |
# implements the doclet exti request, to serve cfhtml strings |
| 4 |
|
| 5 |
our %DOCLET; # $DOCLET{category} = $cb |
| 6 |
|
| 7 |
sub register($$) { |
| 8 |
my ($category, $cb) = @_; |
| 9 |
$DOCLET{$category} = $cb; |
| 10 |
Guard::guard { delete $DOCLET{$category} } |
| 11 |
} |
| 12 |
|
| 13 |
sub doclet($$$) { |
| 14 |
my ($pl, $category, $item) = @_; |
| 15 |
|
| 16 |
if (my $cb = $DOCLET{$category}) { |
| 17 |
$cb->($pl, $category, $item) |
| 18 |
} else { |
| 19 |
"No documentation found for $category/$item." |
| 20 |
} |
| 21 |
} |
| 22 |
|
| 23 |
our $SKILL_HANDLER = ext::doclet::register skill => sub { |
| 24 |
my ($pl, $category, $name) = @_; |
| 25 |
|
| 26 |
my $skill = $pl->find_skill ($name); |
| 27 |
|
| 28 |
"B<$name>\n\n" |
| 29 |
. ($skill ? $skill->msg : "You don't know anything about this skill.") |
| 30 |
}; |
| 31 |
|
| 32 |
cf::register_async_exticmd doclet => sub { |
| 33 |
my ($ns, $reply, $category, $item) = @_; |
| 34 |
|
| 35 |
$ns->async (sub { |
| 36 |
my $cfpod; |
| 37 |
|
| 38 |
if (my $pl = $ns->pl) { |
| 39 |
$cfpod = $pl->expand_cfpod (doclet $pl, $category, $item); |
| 40 |
} else { |
| 41 |
$cfpod = "(documentation not available before login)"; |
| 42 |
} |
| 43 |
|
| 44 |
$reply->($cfpod); |
| 45 |
}); |
| 46 |
}; |
| 47 |
|
