use JSON;
+my $verbose;
+my $keep_artifacts;
+
my $release = '@RELEASE@';
my $clicmd = shift or
my $prepared_files = {};
+my $man_target_html = 0;
my $env_stack = [];
my $env_skip = 0;
+sub debug {
+ my $msg = shift;
+
+ return if !$verbose;
+
+ print STDERR "asciidoc-pve: $msg\n";
+}
+
sub push_environment {
my ($env, $skip) = @_;
}
}
+my $files_for_cleanup = [];
+
sub cleanup {
- # TODO: anything ?
+ return if $keep_artifacts;
+
+ foreach my $file (@$files_for_cleanup) {
+ unlink $file;
+ }
}
sub replace_wiki_xref {
$text = $reftext if !length($text);
- die "xref: no text for '$blockid'\n" if !$text;
+ die "xref: no text for wiki link '$blockid'\n" if !$text;
return "$link\[$text\]";
}
-sub prepare_adoc_file {
- my ($filename, $attributes) = @_;
+sub replace_default_xref {
+ my ($blockid, $text) = @_;
+
+ my $link = $fileinfo->{blockid_target}->{default}->{$blockid};
+ my $reftext = $fileinfo->{reftext}->{default}->{$blockid};
+
+ die "unable to resolve chapter link (xref:$blockid)\n"
+ if !defined($link);
+
+ $text = $reftext if !length($text);
+
+ die "xref: no text for chapter link '$blockid'\n" if !$text;
+
+ return "$link\[$text\]";
+}
+
+sub replace_man_xref {
+ my ($blockid, $text) = @_;
+
+ my $link = $fileinfo->{blockid_target}->{manvolnum}->{$blockid};
+ my $reftext = $fileinfo->{reftext}->{manvolnum}->{$blockid};
+
+ die "unable to resolve man page link (xref:$blockid)\n"
+ if !defined($link);
+
+ $text = $reftext if !length($text);
+
+ die "xref: no text for man page link '$blockid'\n" if !$text;
+
+ my $section = $fileinfo->{mansection}->{manvolnum}->{$link};
+ die "link target is not a manual page" if !defined($section);
+
+ if (0 && $man_target_html) {
+ my $target = $link;
+ $target =~ s/\.adoc//;
+ $target .= ".$section";
+ return "link:${target}.html#${blockid}\[$text\]";
+ } else {
+ my $command = $link;
+ $command =~ s/\.adoc//;
+ return "\*${text}\* (man \*${command}\*($section))";
+ }
+}
- return if $prepared_files->{$filename};
+sub replace_xref {
+ my ($env, $blockid, $text) = @_;
+
+ if ($env eq 'wiki') {
+ return replace_wiki_xref($blockid, $text);
+ } elsif ($env eq 'manvolnum') {
+ return replace_man_xref($blockid, $text);
+ } elsif ($env eq 'default') {
+ return replace_default_xref($blockid, $text);
+ } else {
+ die "internal error";
+ }
+}
+
+sub prepare_adoc_file {
+ my ($target_env, $filename, $attributes) = @_;
- print "PREPARE $filename\n";
+ return $prepared_files->{$filename} if defined($prepared_files->{$filename});
- $prepared_files->{$filename} = 1;
+ debug("prepare $filename");
my $dirname = dirname($filename);
my $basename = basename($filename);
my $outfilename = "$dirname/${tmpprefix}$basename";
+ $prepared_files->{$filename} = $outfilename;
+
my $fh = IO::File->new("$filename", "r") or
die "unable to open file '$filename' - $!\n";
my $outfh = IO::File->new("$outfilename", "w") or
die "unable to open temporary file '$outfilename'\n";
+ push @$files_for_cleanup, $outfilename;
+
while (defined (my $line = <$fh>)) {
+ chomp $line;
if ($line =~ m/^if(n?)def::(\S+)\[(.*)\]\s*$/) {
my ($not, $env, $text) = ($1, $2, $3);
die "unsuported ifdef usage - implement me" if $text;
if ($line =~ m/^include::(\S+)(\[.*\]\s*)$/) {
my ($fn, $rest) = ($1, $2);
- print "INCLUDE: $fn\n";
- my $new_fn = prepare_adoc_file($fn, $attributes);
- $line = "include::${new_fn}$rest\n";
+ debug("include $fn");
+ my $new_fn = prepare_adoc_file($target_env, $fn, $attributes);
+
+ print $outfh "include::${new_fn}$rest\n";
+ next;
}
# fix xrefs
- $line =~ s/xref:([^\s\[\]]+)\[([^\]]*)\]/replace_wiki_xref($1,$2)/ge;
+ $line =~ s/xref:([^\s\[\]]+)\[([^\]]*)\]/replace_xref(${target_env},$1,$2)/ge;
- $line =~ s/<<([^\s,\[\]]+)(?:,(.*?))?>>/replace_wiki_xref($1,$2)/ge;
+ $line =~ s/<<([^\s,\[\]]+)(?:,(.*?))?>>/replace_xref(${target_env},$1,$2)/ge;
- print $outfh $line;
+ print $outfh $line . "\n";
}
return $outfilename;
}
-sub compile_wiki {
+sub compile_asciidoc {
+ my ($env) = @_;
- my $verbose;
my $outfile;
- my $target_env;
GetOptions ("outfile=s" => \$outfile,
+ "keep-artifacts" => \$keep_artifacts,
"verbose" => \$verbose) or
die("Error in command line arguments\n");
scalar(@ARGV) == 0 or
die "too many arguments...\n";
- my $env = 'wiki';
-
+ defined($fileinfo->{titles}->{$env}) ||
+ die "unknown environment '$env'";
my $title = $fileinfo->{titles}->{$env}->{$infile} or
- die "unable to get title for '$infile'\n";
+ die "unable to get title for '$infile'$env\n";
-
- print "compile: $title\n";
+ debug("compile $title");
my $leveloffset = 0;
- my $doctype = $fileinfo->{doctype}->{$env}->{$infile} // 0;
+ my $doctype = $fileinfo->{doctype}->{$env}->{$infile};
+
+ die "unable to get document type for '$infile'\n"
+ if !defined($doctype);
+
$leveloffset = - $doctype;
my $date = `date`;
my $attributes = {
$env => undef,
- icons => undef,
- 'data-uri' => undef,
- date => $date,
leveloffset => $leveloffset,
- revnumber => $release,
};
- my $cmd = ['asciidoc', '-s'];
+ my $mansection = $fileinfo->{mansection}->{$env}->{$infile};
- foreach my $key (keys %$attributes) {
- my $value = $attributes->{$key};
- if (defined($value)) {
- push @$cmd, '-a', "$key=$value";
- } else {
- push @$cmd, '-a', $key;
- }
+ if ($env eq 'wiki') {
+ } elsif ($env eq 'manvolnum') {
+ die "undefined man section" if !defined($mansection);
+ $attributes->{manvolnum} = $mansection;
+ } elsif ($env eq 'default') {
+ die "$infile: wrong doctype\n" if $doctype != 0;
+ $attributes->{toc} = undef;
}
- push @$cmd, '--verbose' if $verbose;
-
if (!defined($outfile)) {
$outfile = $infile;
$outfile =~ s/\.adoc$//;
- $outfile .= ".html";
+ if ($env eq 'manvolnum') {
+ if ($man_target_html) {
+ $outfile .= ".$mansection.html";
+ } else {
+ $outfile .= ".$mansection";
+ }
+ } else {
+ $outfile .= ".html";
+ }
}
- push @$cmd, '--out-file', $outfile;
+ if (($env eq 'manvolnum') && !$man_target_html) {
+
+ # asciidoc /etc/asciidoc/docbook-xsl/manpage.xsl skip REFERENCES
+ # section like footnotes, so we cannot use a2x.
+ # We use xmlto instead.
+
+ my $cmd = ['asciidoc', '-dmanpage', '-bdocbook', '-a', 'docinfo1'];
+
+ foreach my $key (keys %$attributes) {
+ my $value = $attributes->{$key};
+ if (defined($value)) {
+ push @$cmd, '-a', "$key=$value";
+ } else {
+ push @$cmd, '-a', $key;
+ }
+ }
+
+ push @$cmd, '--verbose' if $verbose;
+
+ my $tmpxmlfile = "${outfile}.xml.tmp";
+
+ push @$cmd, '--out-file', $tmpxmlfile;
+
+ push @$files_for_cleanup, $tmpxmlfile;
+
+ my $new_infile = prepare_adoc_file($env, $infile, $attributes);
+
+ push @$cmd, $new_infile;
+
+ debug("run " . join(' ', @$cmd));
+
+ system(@$cmd) == 0 or
+ die "aciidoc error";
+
+ $cmd = ['xmlto', 'man', $tmpxmlfile];
+
+ push @$cmd, '-v' if $verbose;
+
+ debug("run " . join(' ', @$cmd));
+
+ system(@$cmd) == 0 or
+ die "xmlto error";
+
+ } else {
+
+ $attributes->{icons} = undef;
+ $attributes->{'data-uri'} = undef;
+ $attributes->{revnumber} = $release;
+
+ my $cmd = ['asciidoc'];
+
+ push @$cmd, '-s' if $env eq 'wiki';
+
+ foreach my $key (keys %$attributes) {
+ my $value = $attributes->{$key};
+ if (defined($value)) {
+ push @$cmd, '-a', "$key=$value";
+ } else {
+ push @$cmd, '-a', $key;
+ }
+ }
+
+ push @$cmd, '--verbose' if $verbose;
+
+ push @$cmd, '--out-file', $outfile;
- my $new_infile = prepare_adoc_file($infile, $attributes);
+ my $new_infile = prepare_adoc_file($env, $infile, $attributes);
- push @$cmd, $new_infile;
+ push @$cmd, $new_infile;
- print "RUN " . join(' ', @$cmd) . "\n";
+ debug("run " . join(' ', @$cmd));
- system(@$cmd) == 0 or
- die "aciidoc error";
+ system(@$cmd) == 0 or
+ die "aciidoc error";
+ }
}
if ($clicmd eq 'compile-wiki') {
- eval { compile_wiki(); };
+ eval { compile_asciidoc('wiki'); };
+ my $err = $@;
+
+ cleanup();
+
+ die $err if $err;
+
+} elsif ($clicmd eq 'compile-chapter') {
+
+ eval { compile_asciidoc('default'); };
+ my $err = $@;
+
+ cleanup();
+
+ die $err if $err;
+
+} elsif ($clicmd eq 'compile-man-html') {
+
+ $man_target_html = 1;
+
+ eval { compile_asciidoc('manvolnum'); };
+ my $err = $@;
+
+ cleanup();
+
+ die $err if $err;
+
+} elsif ($clicmd eq 'compile-man') {
+
+ eval { compile_asciidoc('manvolnum'); };
my $err = $@;
cleanup();