X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=scan-adoc-refs;h=bc893249c7b0c8da6c10a25a40493e0c29ed8546;hp=6563c3534c10041e5f28e050698a13a54a4e582e;hb=63a0180693d69c0875c388e6ca7df46bca64efca;hpb=0142692aedc3579330722fe8217bc5d66790cd3d

diff --git a/scan-adoc-refs b/scan-adoc-refs
index 6563c35..bc89324 100755
--- a/scan-adoc-refs
+++ b/scan-adoc-refs
@@ -2,11 +2,18 @@
 
 use strict;
 use warnings;
+use Getopt::Long;
 use IO::File;
 use JSON;
 
 use Data::Dumper;
 
+my $generate_depends;
+
+GetOptions("depends=s" => \$generate_depends) or
+    die("Error in command line arguments\n");
+
+
 my $environments = {
     default => 1,
     wiki => 1,
@@ -69,8 +76,6 @@ sub pop_environment {
 sub register_include {
     my ($filename, $include_filename, $env_list) = @_;
 
-    return if $include_filename !~ m/\.adoc$/; # skip attributes.txt
-
     foreach my $e (@$env_list) {
 	$fileinfo->{include}->{$e}->{$filename}->{$include_filename} = 1;
     }
@@ -89,6 +94,42 @@ sub register_blockid {
     }
 }
 
+sub register_title {
+    my ($filename, $env, $doctype, $title, $blockid) = @_;
+
+    # fixme: what about other macros?
+    $title =~ s/\{pve\}/Proxmox VE/g;
+    $title =~ s!http://\S+\[(.*?)\]!$1!g;
+
+    # register document title (onyl once)
+    if (!defined($fileinfo->{titles}->{$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});
+	}
+    } elsif (!defined($doctype)) {
+	# change title via :title: attribute
+	$fileinfo->{titles}->{$env}->{$filename} = $title;
+    }
+
+    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;
+    }
+}
+
 sub scan_adoc_file {
     my ($filename) = @_;
 
@@ -100,6 +141,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*$/) {
@@ -119,21 +161,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/^=====+$/) {
-		$fileinfo->{titles}->{$e}->{$filename} = $env_last_line->{$e};
-		$fileinfo->{doctype}->{$e}->{$filename} = 0;
+		register_title($filename, $e, 0, $env_last_line->{$e},
+			       $env_last_blockid->{$e});
 	    } elsif ($line =~ m/^-----+$/) {
-		$fileinfo->{titles}->{$e}->{$filename} = $env_last_line->{$e};
-		$fileinfo->{doctype}->{$e}->{$filename} = 1;
+		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.*?)( +=)?$/) {
-		$fileinfo->{titles}->{$e}->{$filename} = $1;
-		$fileinfo->{doctype}->{$e}->{$filename} = 0;
+		register_title($filename, $e, 0, $1, $env_last_blockid->{$e});
 	    } elsif ($line =~ m/^== +(\S.*?)( +==)?$/) {
-		$fileinfo->{titles}->{$e}->{$filename} = $1;
-		$fileinfo->{doctype}->{$e}->{$filename} = 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;
@@ -143,13 +190,17 @@ sub scan_adoc_file {
 	if ($line =~ m/^:(\S+?):\s*(.*\S)?\s*$/) {
 	    my ($key, $value) = ($1, $2);
 	    if ($key eq 'pve-toplevel') {
-		
+
 		foreach my $e (@{$env_stack->[-1]}) {
 		    my $title = $fileinfo->{titles}->{$e}->{$filename};
 		    die "not title for toplevel file '$filename' (env=$e)\n"
 			if !defined($title);
 		    $fileinfo->{toplevel}->{$e}->{$filename} = 1;
 		}
+	    } elsif ($key eq 'title') {
+		foreach my $e (@{$env_stack->[-1]}) {
+		    register_title($filename, $e, undef, $value);
+		}
 	    }
 	}
 
@@ -158,7 +209,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/\[\[\[([^\]]*)\]\]\]/) {
@@ -189,6 +250,8 @@ sub resolve_link_target {
 	$repeat = 0;
 	foreach my $fn (keys %$include_hash) {
 	    if ($include_hash->{$fn}->{$filename}) {
+		next if ($fn eq 'pve-admin-guide.adoc') &&
+		    $fileinfo->{outfile}->{$env}->{$filename};
 		$filename = $fn;
 		$repeat = 1;
 		last;
@@ -199,6 +262,45 @@ 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";
+	    }
+	    $realfn = "$realfn-plain.html";
+	    $fileinfo->{outfile}->{$e}->{$fn} = $realfn;
+	} elsif ($e eq 'manvolnum') {
+	    my $realfn = $fn;
+	    $realfn =~ s/\.adoc$//;
+	    die "toplevel file '$fn' is not marked as manual page!" if !$mansection;
+	    $realfn .= ".$mansection";
+	    $fileinfo->{outfile}->{$e}->{$fn} = $realfn;
+	} elsif ($e eq 'default') {
+	    my $realfn = $fn;
+	    $realfn =~ s/\.adoc$//;
+	    if (defined($mansection) && ($mansection == 5)) {
+		$realfn .= ".$mansection";
+		$realfn = "$realfn.html";
+	    } else {
+		if (($fn ne 'pve-admin-guide.adoc') &&
+		    $fileinfo->{doctype}->{$e}->{$fn} == 0) {
+		    $realfn = "chapter-$realfn.html";
+		} else {
+		    $realfn = "$realfn.html";
+		}
+	    }
+	    $fileinfo->{outfile}->{$e}->{$fn} = $realfn;
+	}
+    }
+}
+
 # now resolve blockids
 foreach my $e (@$start_env) {
     my $blockid_hash = $fileinfo->{blockid}->{$e};
@@ -206,15 +308,123 @@ foreach my $e (@$start_env) {
 	my $fn = resolve_link_target($e, $blockid_hash->{$blockid});
 	if ($e eq 'wiki') {
 	    my $title = $fileinfo->{titles}->{$e}->{$fn};
-	    $title =~ s/\{pve\}/Proxmox VE/g;
 	    $title =~ s/\s/_/g;
 	    die "found not title for '$fn' in env '$e'" if !$title;
 	    $fileinfo->{blockid_target}->{$e}->{$blockid} = "link:/wiki/$title#$blockid";
-	} else {
+
+	    # 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 = $fileinfo->{outfile}->{$e}->{$fn} ||
+		die "no output file mapping for '$fn'\n";
+	    $fileinfo->{blockid_target}->{$e}->{$blockid} = "link:/pve-docs/$realfn#$blockid";
+	} 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;
 	}
     }
 }
 
+if ($generate_depends) {
+
+    my $tmpfilename = "${generate_depends}.tmp";
+    my $outfh = IO::File->new($tmpfilename, "w") ||
+	die "unable to open temporary file '$tmpfilename'\n";
+
+    my $depends = {};
+    foreach my $e (@$start_env) {
+	my $env_data = $fileinfo->{include}->{$e};
+	foreach my $fn (keys %$env_data) {
+	    foreach my $dep (keys %{$env_data->{$fn}}) {
+		$depends->{$fn}->{$dep} = 1;
+	    }
+	}
+    }
+
+    my $res = '';
+
+    my $depend_varname_hash = {};
+
+    foreach my $fn (sort keys %$depends) {
+	my $basename = uc($fn);
+	$basename =~s/\.adoc$//i;
+	$basename =~s/[^A-Za-z0-9]/_/g;
+
+	my $var1text = "${basename}_ADOCSOURCES =";
+	my $var2text = "${basename}_ADOCDEPENDS = \$\{${basename}_ADOCSOURCES\}";
+	$depend_varname_hash->{$fn} = "${basename}_ADOCDEPENDS";
+
+	foreach my $dep (sort keys %{$depends->{$fn}}) {
+	    if ($dep =~ m/-(opts|synopsis).adoc$/) {
+		$var2text .= " \\\n\t$dep";
+	    } else {
+		$var1text .= " \\\n\t$dep";
+	    }
+	}
+	$res .= "$var1text\n\n";
+	$res .= "$var2text\n\n";
+    }
+
+    my $man_sources_hash = {};
+    foreach my $e (@$start_env) {
+	my $filelist = $fileinfo->{outfile}->{$e};
+	foreach my $sourcefile (sort keys %$filelist) {
+	    my $varname = $depend_varname_hash->{$sourcefile};
+	    my $target = $filelist->{$sourcefile};
+	    $res .= "$target: \$\{$varname\}\n\n";
+
+	    if ($e eq 'manvolnum') {
+		$man_sources_hash->{$sourcefile} = 1;
+
+		$res .= "$target.html: \$\{$varname\}\n\n";
+		$res .= "$target-plain.html: \$\{$varname\}\n\n";
+	    }
+	}
+    }
+
+    my $varname = "MANUAL_SOURCES";
+    $res .= "$varname =";
+    foreach my $sourcefile (sort keys %$man_sources_hash) {
+	$res .= " \\\n\t$sourcefile";
+    }
+    $res .= "\n\n";
+
+    $varname = "CHAPTER_LIST";
+    $res .= "$varname =";
+    my $filelist = $fileinfo->{outfile}->{default};
+    foreach my $sourcefile (sort keys %$filelist) {
+	my $target = $filelist->{$sourcefile};
+	$res .= " \\\n\t$target";
+    }
+    $res .= "\n\n";
+
+    $varname = "MANUAL_PAGES";
+    $res .= "$varname =";
+    $filelist = $fileinfo->{outfile}->{manvolnum};
+    foreach my $manpage (sort keys %$filelist) {
+	my $target = $filelist->{$manpage};
+	$res .= " \\\n\t$target";
+    }
+    $res .= "\n\n";
+
+    $varname = "WIKI_IMPORTS";
+    $res .= "$varname =";
+    $filelist = $fileinfo->{outfile}->{wiki};
+    foreach my $sourcefile (sort keys %$filelist) {
+	my $target = $filelist->{$sourcefile};
+	$res .= " \\\n\t$target";
+    }
+    $res .= "\n\n";
+
+    print $outfh $res;
+    close($outfh);
+
+    rename($tmpfilename, $generate_depends) ||
+	die "rename failed - $!";
+}
 
-print to_json($fileinfo, { pretty => 1 } );
+print to_json($fileinfo, { pretty => 1,  canonical => 1 } );