]>
git.proxmox.com Git - pve-docs.git/blob - scan-adoc-refs
14 pvelogo
=> 0, # ignore
20 foreach my $e (keys %$environments) {
21 push @$start_env, $e if $environments->{$e};
24 my $env_stack = [$start_env];
25 my $env_name_stack = [];
27 sub reset_environment_stack
{
28 $env_stack = [$start_env];
32 sub push_environment
{
35 die "undefined environment '$env'\n" if !defined($environments->{$env});
37 # FIXME: this seems wrong (nested env?)?
38 return if !$environments->{$env}; # do not track
42 foreach my $e (@{$env_stack->[-1]}) {
47 die "empty environment" if !scalar($new_env);
48 push @$env_stack, $new_env;
50 push @$env_stack, [$env];
53 push @$env_name_stack, $env;
59 die "undefined environment '$env'\n" if !defined($environments->{$env});
61 return if !$environments->{$env}; # do not track
64 my $res = pop @$env_name_stack;
66 die "environment missmatch ($res != $env)\n" if $res ne $env;
69 sub register_include
{
70 my ($filename, $include_filename, $env_list) = @_;
72 return if $include_filename !~ m/\.adoc$/; # skip attributes.txt
74 foreach my $e (@$env_list) {
75 $fileinfo->{include
}->{$e}->{$filename}->{$include_filename} = 1;
79 sub register_blockid
{
80 my ($filename, $blockid, $reftext, $env_list) = @_;
82 foreach my $e (@$env_list) {
83 my $fn = $fileinfo->{blockid
}->{$e}->{$blockid};
84 die "blockid '$blockid' already defined in $fn"
86 $fileinfo->{blockid
}->{$e}->{$blockid} = $filename;
87 $fileinfo->{reftext
}->{$e}->{$blockid} = $reftext
93 my ($filename, $env, $doctype, $title) = @_;
95 # fixme: what about other macros?
96 $title =~ s/\{pve\}/Proxmox VE/g;
97 $title =~ s!http://\S+\[(.*?)\]!$1!g;
99 $fileinfo->{titles
}->{$env}->{$filename} = $title;
101 if (defined($doctype)) {
102 $fileinfo->{doctype
}->{$env}->{$filename} = $doctype;
104 die "unable to change title (no doctype)"
105 if !defined($fileinfo->{doctype
}->{$env}->{$filename});
112 reset_environment_stack
();
114 # print "SCAN $filename\n";
116 my $fh = IO
::File-
>new("$filename", "r") or
117 die "unable to open file '$filename' - $!\n";
119 my $env_last_line = {};
121 while (defined (my $line = <$fh>)) {
122 if ($line =~ m/^if(n?)def::(\S+)\[(.*)\]\s*$/) {
123 my ($not, $env, $text) = ($1, $2, $3);
124 die "unsuported ifdef usage - implement me" if $text;
125 push_environment
($env, $not);
127 } elsif ($line =~ m/^endif::(\S+)\[(.*)\]\s*$/) {
128 my ($env, $text) = ($1, $2);
129 die "unsuported ifdef usage - implement me" if $text;
130 pop_environment
($env);
132 } elsif ($line =~ m/^include::(\S+)\[.*\]\s*$/) {
133 register_include
($filename, $1, $env_stack->[-1]);
137 # try to detect titles
138 foreach my $e (@{$env_stack->[-1]}) {
139 my $title = $fileinfo->{titles
}->{$e}->{$filename};
140 next if defined($title);
142 if ($line =~ m/^=====+$/) {
143 register_title
($filename, $e, 0, $env_last_line->{$e});
144 } elsif ($line =~ m/^-----+$/) {
145 register_title
($filename, $e, 1, $env_last_line->{$e});
146 } elsif ($line =~ m/^= +(\S.*?)( +=)?$/) {
147 register_title
($filename, $e, 0, $1);
148 } elsif ($line =~ m/^== +(\S.*?)( +==)?$/) {
149 register_title
($filename, $e, 1, $1);
152 $env_last_line->{$e} = $line;
153 chomp $env_last_line->{$e};
156 if ($line =~ m/^:(\S+?):\s*(.*\S)?\s*$/) {
157 my ($key, $value) = ($1, $2);
158 if ($key eq 'pve-toplevel') {
160 foreach my $e (@{$env_stack->[-1]}) {
161 my $title = $fileinfo->{titles
}->{$e}->{$filename};
162 die "not title for toplevel file '$filename' (env=$e)\n"
164 $fileinfo->{toplevel
}->{$e}->{$filename} = 1;
166 } elsif ($key eq 'title') {
167 foreach my $e (@{$env_stack->[-1]}) {
168 register_title
($filename, $e, undef, $value);
173 if ($line =~ m/^\[\[(.*)\]\]\s*$/) {
175 die "implement me" if $blockid =~m/,/;
177 register_blockid
($filename, $blockid, $reftext, $env_stack->[-1]);
180 # bibliography anchors
181 if ($line =~ m/\[\[\[([^\]]*)\]\]\]/) {
183 die "implement me" if $blockid =~m/,/;
184 register_blockid
($filename, $blockid, "[$blockid]", $env_stack->[-1]);
189 my $scanned_files = {};
190 while (my $filename = shift) {
191 next if $filename !~ m/\.adoc$/; # skip attributes.txt
192 next if $scanned_files->{$filename};
194 scan_adoc_file
($filename);
195 $scanned_files->{$filename} = 1;
198 sub resolve_link_target
{
199 my ($env, $filename) = @_;
201 my $include_hash = $fileinfo->{include
}->{$env};
207 foreach my $fn (keys %$include_hash) {
208 if ($include_hash->{$fn}->{$filename}) {
219 # now resolve blockids
220 foreach my $e (@$start_env) {
221 my $blockid_hash = $fileinfo->{blockid
}->{$e};
222 foreach my $blockid (keys %$blockid_hash) {
223 my $fn = resolve_link_target
($e, $blockid_hash->{$blockid});
225 my $title = $fileinfo->{titles
}->{$e}->{$fn};
227 die "found not title for '$fn' in env '$e'" if !$title;
228 $fileinfo->{blockid_target
}->{$e}->{$blockid} = "link:/wiki/$title#$blockid";
230 $fileinfo->{blockid_target
}->{$e}->{$blockid} = $fn;
236 print to_json
($fileinfo, { pretty
=> 1 } );