]>
git.proxmox.com Git - pve-docs.git/blob - asciidoc-pve.in
b578556cda41883b12f0f47d8e1f8d4d41e03f04
12 my $release = '@RELEASE@';
15 die "no command specified\n";
18 while (<main
::DATA
>) { $data_str .= $_; }
20 my $fileinfo = decode_json
($data_str);
22 my $tmpprefix = ".asciidoc-pve-tmp_";
24 my $adoc_source_dir = "/usr/share/pve-doc-generator";
26 # inside pve-docs source dir?
27 if (-f
"attributes.txt" && -f
"pve-admin-guide.adoc") {
28 $adoc_source_dir = "."
31 my $prepared_files = {};
36 sub push_environment
{
37 my ($env, $skip) = @_;
39 $skip = 1 if $env_skip;
40 $skip = 0 if !defined($skip);
42 push @$env_stack, [$env, $skip];
50 my $last_stack_entry = pop @$env_stack;
51 die "unable to pop env '$env'" if !defined($last_stack_entry);
53 my ($last_env, $skip) = @$last_stack_entry;
54 die "environment missmatch (${last_env} != $env)\n" if $last_env ne $env;
56 if (!scalar(@$env_stack)) {
59 my (undef, $skip) = @{$env_stack->[-1]};
69 sub replace_wiki_xref
{
70 my ($blockid, $text) = @_;
72 my $link = $fileinfo->{blockid_target
}->{wiki
}->{$blockid};
73 my $reftext = $fileinfo->{reftext
}->{wiki
}->{$blockid};
75 die "unable to resolve wiki link (xref:$blockid)\n"
78 $text = $reftext if !length($text);
80 die "xref: no text for '$blockid'\n" if !$text;
82 return "$link\[$text\]";
86 my ($env, $blockid, $text) = @_;
89 return replace_wiki_xref
($blockid, $text);
95 sub prepare_adoc_file
{
96 my ($target_env, $filename, $attributes) = @_;
98 return if $prepared_files->{$filename};
100 print "PREPARE $filename\n";
102 $prepared_files->{$filename} = 1;
104 my $dirname = dirname
($filename);
105 my $basename = basename
($filename);
107 my $outfilename = "$dirname/${tmpprefix}$basename";
109 my $fh = IO
::File-
>new("$filename", "r") or
110 die "unable to open file '$filename' - $!\n";
112 my $outfh = IO
::File-
>new("$outfilename", "w") or
113 die "unable to open temporary file '$outfilename'\n";
115 while (defined (my $line = <$fh>)) {
116 if ($line =~ m/^if(n?)def::(\S+)\[(.*)\]\s*$/) {
117 my ($not, $env, $text) = ($1, $2, $3);
118 die "unsuported ifdef usage - implement me" if $text;
120 my $skip = !exists($attributes->{$env}) ?
1 : 0;
121 $skip = ($skip ?
0 : 1 ) if $not;
123 push_environment
($env, $skip);
125 } elsif ($line =~ m/^endif::(\S+)\[(.*)\]\s*$/) {
126 my ($env, $text) = ($1, $2);
127 die "unsuported ifdef usage - implement me" if $text;
128 pop_environment
($env);
134 if ($line =~ m/^include::(\S+)(\[.*\]\s*)$/) {
135 my ($fn, $rest) = ($1, $2);
136 print "INCLUDE: $fn\n";
137 my $new_fn = prepare_adoc_file
($target_env, $fn, $attributes);
138 $line = "include::${new_fn}$rest\n";
142 $line =~ s/xref:([^\s\[\]]+)\[([^\]]*)\]/replace_xref(${target_env},$1,$2)/ge;
144 $line =~ s/<<([^\s,\[\]]+)(?:,(.*?))?>>/replace_xref(${target_env},$1,$2)/ge;
152 sub compile_asciidoc
{
158 GetOptions
("outfile=s" => \
$outfile,
159 "verbose" => \
$verbose) or
160 die("Error in command line arguments\n");
162 my $infile = shift(@ARGV) or
163 die "no input file specified\n";
165 scalar(@ARGV) == 0 or
166 die "too many arguments...\n";
168 if ($env eq 'wiki') {
172 die "unknown environment '$env'";
175 my $title = $fileinfo->{titles
}->{$env}->{$infile} or
176 die "unable to get title for '$infile'\n";
178 print "compile: $title\n";
182 my $doctype = $fileinfo->{doctype
}->{$env}->{$infile} // 0;
183 $leveloffset = - $doctype;
193 leveloffset
=> $leveloffset,
194 revnumber
=> $release,
197 if (!($env eq 'wiki') || ($env ne 'manvolnum')) {
198 $attributes->{toc
} = undef;
201 my $cmd = ['asciidoc', '-s'];
203 foreach my $key (keys %$attributes) {
204 my $value = $attributes->{$key};
205 if (defined($value)) {
206 push @$cmd, '-a', "$key=$value";
208 push @$cmd, '-a', $key;
212 push @$cmd, '--verbose' if $verbose;
214 if (!defined($outfile)) {
216 $outfile =~ s/\.adoc$//;
220 push @$cmd, '--out-file', $outfile;
222 my $new_infile = prepare_adoc_file
($env, $infile, $attributes);
224 push @$cmd, $new_infile;
226 print "RUN " . join(' ', @$cmd) . "\n";
228 system(@$cmd) == 0 or
233 if ($clicmd eq 'compile-wiki') {
235 eval { compile_asciidoc
('wiki'); };
244 die "unknown command '$clicmd'\n";