]> git.proxmox.com Git - pve-docs.git/blobdiff - scan-adoc-refs
generate wiki output file mappings automatically
[pve-docs.git] / scan-adoc-refs
index eb70e510795b69c76bc4131eb5049cde3055e511..03dc51cf59f668da803c738d3fbb09b8f58b3ea4 100755 (executable)
@@ -14,7 +14,52 @@ my $environments = {
     pvelogo => 0, # ignore
 };
 
-my $fileinfo = {};
+my $fileinfo = {
+    outfile => {
+       default => {
+           "pve-admin-guide.adoc" => "pve-admin-guide.html",
+           "datacenter.cfg.adoc" => "datacenter.cfg.5.html",
+           "ha-manager.adoc" => "chapter-ha-manager.html",
+           "pct.adoc" => "chapter-pct.html",
+           "pve-bibliography.adoc" => "chapter-pve-bibliography.html",
+           "pve-firewall.adoc" => "chapter-pve-firewall.html",
+           "pve-installation.adoc" => "chapter-pve-installation.html",
+           "pvecm.adoc" => "chapter-pvecm.html",
+           "pvesm.adoc" => "chapter-pvesm.html",
+           "pveum.adoc" => "chapter-pveum.html",
+           "qm.adoc" => "chapter-qm.html",
+           "sysadmin.adoc" => "chapter-sysadmin.html",
+           "vzdump.adoc" => "chapter-vzdump.html",
+           "pmxcfs.adoc" => "chapter-pmxcfs.html",
+           "pve-faq.adoc" => "chapter-pve-faq.html",
+       },
+       manvolnum => {
+           "ha-manager.adoc" => "ha-manager.1",
+           "pct.adoc" => "pct.1",
+           "pveam.adoc" => "pveam.1",
+           "pveceph.adoc" => "pveceph.1",
+           "pvecm.adoc" => "pvecm.1",
+           "pveperf.adoc" => "pveperf.1",
+           "pvesm.adoc" => "pvesm.1",
+           "pvesubscription.adoc" => "pvesubscription.1",
+           "pveum.adoc" => "pveum.1",
+           "qm.adoc" => "qm.1",
+           "qmrestore.adoc" => "qmrestore.1",
+           "vzdump.adoc" => "vzdump.1",
+           "datacenter.cfg.adoc" => "datacenter.cfg.5",
+           "pct.conf.adoc" => "pct.conf.5",
+           "qm.conf.adoc" => "qm.conf.5",
+           "pmxcfs.adoc" => "pmxcfs.8",
+           "pvedaemon.adoc" => "pvedaemon.8",
+           "pve-firewall.adoc" => "pve-firewall.8",
+           "pve-ha-crm.adoc" => "pve-ha-crm.8",
+           "pve-ha-lrm.adoc" => "pve-ha-lrm.8",
+           "pveproxy.adoc" => "pveproxy.8",
+           "pvestatd.adoc" => "pvestatd.8",
+           "spiceproxy.adoc" => "spiceproxy.8",
+       },
+    },
+};
 
 my $start_env = [];
 foreach my $e (keys %$environments) {
@@ -90,19 +135,35 @@ sub register_blockid {
 }
 
 sub register_title {
-    my ($filename, $env, $doctype, $title) = @_;
+    my ($filename, $env, $doctype, $title, $blockid) = @_;
 
     # fixme: what about other macros?
     $title =~ s/\{pve\}/Proxmox VE/g;
     $title =~ s!http://\S+\[(.*?)\]!$1!g;
 
-    $fileinfo->{titles}->{$env}->{$filename} = $title;
+    # register document title (onyl once)
+    if (!defined($fileinfo->{titles}->{$env}->{$filename})) {
 
-    if (defined($doctype)) {
-       $fileinfo->{doctype}->{$env}->{$filename} = $doctype;
-    } else {
-       die "unable to change title (no doctype)"
-           if !defined($fileinfo->{doctype}->{$env}->{$filename});
+       $fileinfo->{titles}->{$env}->{$filename} = $title;
+
+       if (defined($doctype)) {
+           $fileinfo->{doctype}->{$env}->{$filename} = $doctype;
+       } else {
+           die "unable to change title (no doctype)"
+               if !defined($fileinfo->{doctype}->{$env}->{$filename});
+       }
+
+       if (defined($doctype) && ($env eq 'manvolnum') && ($doctype == 0)) {
+           if ($title =~ m/.*\(([1-8])\)\s*$/) {
+               $fileinfo->{mansection}->{$env}->{$filename} = $1;
+           }
+       }
+    }
+
+    if ($blockid) {
+       die "internal error"
+           if !defined($fileinfo->{blockid}->{$env}->{$blockid});
+       $fileinfo->{reftitle}->{$env}->{$blockid} = $title;
     }
 }
 
@@ -117,6 +178,7 @@ sub scan_adoc_file {
        die "unable to open file '$filename' - $!\n";
 
     my $env_last_line = {};
+    my $env_last_blockid = {};
 
     while (defined (my $line = <$fh>)) {
        if ($line =~ m/^if(n?)def::(\S+)\[(.*)\]\s*$/) {
@@ -136,17 +198,26 @@ sub scan_adoc_file {
 
        # try to detect titles
        foreach my $e (@{$env_stack->[-1]}) {
-           my $title = $fileinfo->{titles}->{$e}->{$filename};
-           next if defined($title);
-
            if ($line =~ m/^=====+$/) {
-               register_title($filename, $e, 0, $env_last_line->{$e});
+               register_title($filename, $e, 0, $env_last_line->{$e},
+                              $env_last_blockid->{$e});
            } elsif ($line =~ m/^-----+$/) {
-               register_title($filename, $e, 1, $env_last_line->{$e});
+               register_title($filename, $e, 1, $env_last_line->{$e},
+                              $env_last_blockid->{$e});
+           } elsif ($line =~ m/^~~~~~+$/) {
+               register_title($filename, $e, 2, $env_last_line->{$e},
+                              $env_last_blockid->{$e});
+           } elsif ($line =~ m/^\^\^\^\^\^+$/) {
+               register_title($filename, $e, 3, $env_last_line->{$e},
+                              $env_last_blockid->{$e});
            } elsif ($line =~ m/^= +(\S.*?)( +=)?$/) {
-               register_title($filename, $e, 0, $1);
+               register_title($filename, $e, 0, $1, $env_last_blockid->{$e});
            } elsif ($line =~ m/^== +(\S.*?)( +==)?$/) {
-               register_title($filename, $e, 1, $1);
+               register_title($filename, $e, 1, $1, $env_last_blockid->{$e});
+           } elsif ($line =~ m/^=== +(\S.*?)( +===)?$/) {
+               register_title($filename, $e, 2, $1, $env_last_blockid->{$e});
+           } elsif ($line =~ m/^==== +(\S.*?)( +====)?$/) {
+               register_title($filename, $e, 3, $1, $env_last_blockid->{$e});
            }
 
            $env_last_line->{$e} = $line;
@@ -175,7 +246,17 @@ sub scan_adoc_file {
            die "implement me" if $blockid =~m/,/;
            my $reftext = '';
            register_blockid($filename, $blockid, $reftext, $env_stack->[-1]);
+           foreach my $e (@{$env_stack->[-1]}) {
+               $env_last_blockid->{$e} = $blockid;
+           }
        }
+
+       if ($line =~ m/^\s*$/) {
+           foreach my $e (@{$env_stack->[-1]}) {
+               delete $env_last_blockid->{$e};
+           }
+       }
+
        # fixme: "anchor:"
        # bibliography anchors
        if ($line =~ m/\[\[\[([^\]]*)\]\]\]/) {
@@ -205,8 +286,9 @@ sub resolve_link_target {
     while ($repeat) {
        $repeat = 0;
        foreach my $fn (keys %$include_hash) {
-           next if $fn eq 'pve-admin-guide.adoc';
            if ($include_hash->{$fn}->{$filename}) {
+               next if ($fn eq 'pve-admin-guide.adoc') &&
+                   $fileinfo->{outfile}->{$env}->{$filename};
                $filename = $fn;
                $repeat = 1;
                last;
@@ -217,6 +299,24 @@ sub resolve_link_target {
     return $filename;
 }
 
+
+# try to generate output file mapping
+foreach my $e (@$start_env) {
+    my $toplevel_hash = $fileinfo->{toplevel}->{$e};
+    foreach my $fn (sort keys %$toplevel_hash) {
+       my $mansection = $fileinfo->{mansection}->{manvolnum}->{$fn};
+       if ($e eq 'wiki') {
+           my $realfn = $fn;
+           $realfn =~ s/\.adoc$//;
+           if (defined($mansection) && ($mansection == 5)) {
+               $realfn .= ".$mansection";
+           }
+           my $realfn = "$realfn-plain.html";
+           $fileinfo->{outfile}->{$e}->{$fn} = $realfn;
+       }
+    }
+}
+
 # now resolve blockids
 foreach my $e (@$start_env) {
     my $blockid_hash = $fileinfo->{blockid}->{$e};
@@ -227,15 +327,23 @@ foreach my $e (@$start_env) {
            $title =~ s/\s/_/g;
            die "found not title for '$fn' in env '$e'" if !$title;
            $fileinfo->{blockid_target}->{$e}->{$blockid} = "link:/wiki/$title#$blockid";
+
+           # we do not produce wiki pages for all content
+           #my $realfn = $fileinfo->{outfile}->{$e}->{$fn};
+           #warn "no output file mapping for '$fn' ($e)\n" if !$realfn;
+
        } elsif ($e eq 'default') {
-           my $realfn = "chapter-$fn";
-           $realfn =~ s/\.adoc/.html/;
+           my $realfn = $fileinfo->{outfile}->{$e}->{$fn} ||
+               die "no output file mapping for '$fn'\n";
            $fileinfo->{blockid_target}->{$e}->{$blockid} = "link:/pve-docs/$realfn#$blockid";
-       } else {
+       } elsif ($e eq 'manvolnum') {
+           # we do not produce manpages for all content
+           # my $realfn = $fileinfo->{outfile}->{$e}->{$fn} ||
+           # warn "no output file mapping for '$fn'\n";
            $fileinfo->{blockid_target}->{$e}->{$blockid} = $fn;
        }
     }
 }
 
 
-print to_json($fileinfo, { pretty => 1 } );
+print to_json($fileinfo, { pretty => 1,  canonical => 1 } );