Deliantra-Client/DC/Pod.pm

package DC::Pod;

use strict;
use utf8;

use Storable;

our $VERSION = 1.03;

our $goto_document = sub { };
our %wiki;

my $MA_BEG = "\x{fcd0}";
my $MA_SEP = "\x{fcd1}";
my $MA_END = "\x{fcd2}";

# nodes (order must stay as it is)
sub N_PARENT (){ 0 }
sub N_PAR    (){ 1 }
sub N_LEVEL  (){ 2 }
sub N_KW     (){ 3 }
sub N_DOC    (){ 4 }

# paragraphs (order must stay as it is)
sub P_INDENT (){ 0 }
sub P_LEVEL  (){ 1 }
sub P_MARKUP (){ 2 }
sub P_INDEX  (){ 3 }

*wiki = Storable::retrieve DC::find_rcfile "docwiki.pst";

sub goto_document($) {
   $goto_document->(split /\//, $_[0]);
}

sub is_prefix_of($@) {
   my ($node, @path) = @_;

   return 1 unless @path;

   my $kw = lc pop @path;

   $node = $node->{parent}
      or return 0;

   return scalar grep $_ eq $kw, @{ $node->{kw} };
}

sub find(@) {
   my (@path) = @_;

   return unless @path;

   my $kw = lc pop @path;

   # TODO: make sure results are unique

   grep { is_prefix_of $_, @path }
      map @$_,
         $kw eq "*" ? @wiki{sort keys %wiki}
                    : $wiki{$kw} || ()
}

sub full_path_of($) {
   my ($node) = @_;

   my @path;

   # skip toplevel hierarchy pod/, because its not a document
   while ($node->{parent}) {
      unshift @path, $node;
      $node = $node->{parent};
   }

   @path
}

sub full_path($) {
   join "/", map $_->{kw}[0], &full_path_of
}

sub section_of($) {
   my ($node) = @_;

   my $doc = $node->{doc};
   my $par = $node->{par};
   my $lvl = $node->{level};

   my @res;

   do {
      my $p = $doc->[$par];

      if (length $p->[P_MARKUP]) {
         push @res, {
            markup => $p->[P_MARKUP],
            indent => $p->[P_INDENT],
         };
      }
   } while $doc->[++$par][P_LEVEL] > $lvl;

   @res
}

sub section(@) {
   map section_of $_, &find
}

sub thaw_section(\@\%) {
   for (@{$_[0]}) {
      $_->{markup} =~ s{
         $MA_BEG
         ([^$MA_END]+)
         $MA_END
      }{
         my ($type, @arg) = split /$MA_SEP/o, $1;

         $_[1]{$type}($_, @arg)
      }ogex;
   }
}

my %as_label = (
   image => sub {
      my ($par, $path) = @_;

      "<small>img</small>"
   },
   link => sub {
      my ($par, $text, $link) = @_;

      "<span foreground='#ffff00'>↺</span><span foreground='#c0c0ff' underline='single'>" . (DC::asxml $text) . "</span>"
   },
);

sub as_label(@) {
   thaw_section @_, %as_label;

   my $text =
      join "\n",
         map +("\xa0" x ($_->{indent} / 4)) . $_->{markup},
            @_;

   $text =~ s/^\s+//;
   $text =~ s/\s+$//;

   $text
}

my %as_paragraphs = (
   image => sub {
      my ($par, $path, $flags) = @_;

      push @{ $par->{widget} }, new DC::UI::Image path => $path,
         $flags & 1 ? (max_h => $::FONTSIZE) : ();

      "\x{fffc}"
   },
   link => sub {
      my ($par, $text, $link) = @_;

      push @{ $par->{widget} }, new DC::UI::Label
         markup     => "<span foreground='#ffff00'>↺</span><span foreground='#c0c0ff' underline='single'>" . (DC::asxml $text) . "</span>",
         fontsize   => 0.8,
         can_hover  => 1,
         can_events => 1,
         padding_x  => 0,
         padding_y  => 0,
         tooltip    => "Go to <i>" . (DC::asxml $link) . "</i>",
         on_button_up => sub {
            goto_document $link;
         };

      "\x{fffc}"
   },
);

sub as_paragraphs(@) {
   thaw_section @_, %as_paragraphs;

   @_
}

sub section_paragraphs(@) {
   as_paragraphs &section
}

sub section_label(@) {
   as_label &section
}

1
Revision:	1.18
Committed:	Tue Mar 25 01:46:36 2008 UTC (16 years, 2 months ago) by root
Branch:	MAIN
Changes since 1.17:	+18 -5 lines
Log Message:	make documents level 1, root level 0, also use arrays for paragraphs, for, among other things, speed and memory savings
#	Content
1	package DC::Pod;
2
3	use strict;
4	use utf8;
5
6	use Storable;
7
8	our $VERSION = 1.03;
9
10	our $goto_document = sub { };
11	our %wiki;
12
13	my $MA_BEG = "\x{fcd0}";
14	my $MA_SEP = "\x{fcd1}";
15	my $MA_END = "\x{fcd2}";
16
17	# nodes (order must stay as it is)
18	sub N_PARENT (){ 0 }
19	sub N_PAR (){ 1 }
20	sub N_LEVEL (){ 2 }
21	sub N_KW (){ 3 }
22	sub N_DOC (){ 4 }
23
24	# paragraphs (order must stay as it is)
25	sub P_INDENT (){ 0 }
26	sub P_LEVEL (){ 1 }
27	sub P_MARKUP (){ 2 }
28	sub P_INDEX (){ 3 }
29
30	*wiki = Storable::retrieve DC::find_rcfile "docwiki.pst";
31
32	sub goto_document($) {
33	$goto_document->(split /\//, $_[0]);
34	}
35
36	sub is_prefix_of($@) {
37	my ($node, @path) = @_;
38
39	return 1 unless @path;
40
41	my $kw = lc pop @path;
42
43	$node = $node->{parent}
44	or return 0;
45
46	return scalar grep $_ eq $kw, @{ $node->{kw} };
47	}
48
49	sub find(@) {
50	my (@path) = @_;
51
52	return unless @path;
53
54	my $kw = lc pop @path;
55
56	# TODO: make sure results are unique
57
58	grep { is_prefix_of $_, @path }
59	map @$_,
60	$kw eq "*" ? @wiki{sort keys %wiki}
61	: $wiki{$kw} \|\| ()
62	}
63
64	sub full_path_of($) {
65	my ($node) = @_;
66
67	my @path;
68
69	# skip toplevel hierarchy pod/, because its not a document
70	while ($node->{parent}) {
71	unshift @path, $node;
72	$node = $node->{parent};
73	}
74
75	@path
76	}
77
78	sub full_path($) {
79	join "/", map $_->{kw}[0], &full_path_of
80	}
81
82	sub section_of($) {
83	my ($node) = @_;
84
85	my $doc = $node->{doc};
86	my $par = $node->{par};
87	my $lvl = $node->{level};
88
89	my @res;
90
91	do {
92	my $p = $doc->[$par];
93
94	if (length $p->[P_MARKUP]) {
95	push @res, {
96	markup => $p->[P_MARKUP],
97	indent => $p->[P_INDENT],
98	};
99	}
100	} while $doc->[++$par][P_LEVEL] > $lvl;
101
102	@res
103	}
104
105	sub section(@) {
106	map section_of $_, &find
107	}
108
109	sub thaw_section(\@\%) {
110	for (@{$_[0]}) {
111	$_->{markup} =~ s{
112	$MA_BEG
113	([^$MA_END]+)
114	$MA_END
115	}{
116	my ($type, @arg) = split /$MA_SEP/o, $1;
117
118	$_[1]{$type}($_, @arg)
119	}ogex;
120	}
121	}
122
123	my %as_label = (
124	image => sub {
125	my ($par, $path) = @_;
126
127	"<small>img</small>"
128	},
129	link => sub {
130	my ($par, $text, $link) = @_;
131
132	"<span foreground='#ffff00'>↺</span><span foreground='#c0c0ff' underline='single'>" . (DC::asxml $text) . "</span>"
133	},
134	);
135
136	sub as_label(@) {
137	thaw_section @_, %as_label;
138
139	my $text =
140	join "\n",
141	map +("\xa0" x ($_->{indent} / 4)) . $_->{markup},
142	@_;
143
144	$text =~ s/^\s+//;
145	$text =~ s/\s+$//;
146
147	$text
148	}
149
150	my %as_paragraphs = (
151	image => sub {
152	my ($par, $path, $flags) = @_;
153
154	push @{ $par->{widget} }, new DC::UI::Image path => $path,
155	$flags & 1 ? (max_h => $::FONTSIZE) : ();
156
157	"\x{fffc}"
158	},
159	link => sub {
160	my ($par, $text, $link) = @_;
161
162	push @{ $par->{widget} }, new DC::UI::Label
163	markup => "<span foreground='#ffff00'>↺</span><span foreground='#c0c0ff' underline='single'>" . (DC::asxml $text) . "</span>",
164	fontsize => 0.8,
165	can_hover => 1,
166	can_events => 1,
167	padding_x => 0,
168	padding_y => 0,
169	tooltip => "Go to <i>" . (DC::asxml $link) . "</i>",
170	on_button_up => sub {
171	goto_document $link;
172	};
173
174	"\x{fffc}"
175	},
176	);
177
178	sub as_paragraphs(@) {
179	thaw_section @_, %as_paragraphs;
180
181	@_
182	}
183
184	sub section_paragraphs(@) {
185	as_paragraphs &section
186	}
187
188	sub section_label(@) {
189	as_label &section
190	}
191
192	1