summaryrefslogtreecommitdiff
path: root/doc/doc-docbook/Tidytxt
blob: 296cdad6a78e5a91ec65726cea17232207cb8ba0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
#! /usr/bin/perl

use strict;
use warnings;
use Getopt::Long;


# For now we can't rely on a perl >= 5.14 on
# the build sites, thus we throw away all unicode
# awareness and do the matching byte by byte
binmode STDIN;
binmode STDOUT;

GetOptions(
    'u|utf8!' => \my $want_utf8,	# do not replace unicode characters
) or die "Usage: $0 [-u|--utf8]\n";

# Script to tidy up the output of w3m when it makes a text file. First we
# convert sequences of blank lines into a single blank line, to get everything
# uniform. Then we go through and insert blank lines before chapter and
# sections, also converting chapter titles to uppercase.

# We also have to do some character translation in the first pass. It seems
# that xmlto now generates Unicode in its HTML pages. This gives three problems:
# (1) It inserts the byte sequence C2 A0 (U+00A0) as a fixed-width space;
# (2) It uses U+25CF as its bullet character.
# (3) It inserts a whole slew of "box drawing" characters round the heading.

my @lines = <>;
my $lastwasblank = 0;

foreach my $line (@lines)
  {
  # (1) non-break space -> normal space
  $line =~ s/\x{c2}\x{a0}/ /g;

  unless ($want_utf8)
    {
    # (2) bullet -> asterisk
    $line =~ s/\x{e2}\x{97}\x{8f}/*/g;
    $line =~ s/\x{e2}\x{80}\x{a2}/*/g; # OpenSUSE
    $line =~ s/\x{e2}\x{96}\x{a1}/*/g; # OpenSUSE
    # (3a) horizontal box drawing -> hyphen
    $line =~ s/\x{e2}\x{94}[\x{80}\x{81}\x{84}\x{85}\x{88}\x{89}]/-/g;
    $line =~ s/\x{e2}\x{95}[\x{8c}\x{8d}\x{90}]/-/g;
    $line =~ s/\x{e2}\x{95}[\x{b4}\x{b6}\x{b8}\x{ba}\x{bc}\x{be}]/-/g;
    # (3b) vertical box drawing -> bar
    $line =~ s/\x{e2}\x{94}[\x{82}\x{83}\x{86}\x{87}\x{8a}\x{8b}]/|/g;
    $line =~ s/\x{e2}\x{95}[\x{8e}\x{8f}\x{91}]/|/g;
    $line =~ s/\x{e2}\x{95}[\x{b5}\x{b7}\x{b9}\x{bb}\x{bd}\x{bf}]/|/g;
    # (3c) corner box drawing -> plus
    $line =~ s/\x{e2}\x{94}[\x{8c}-\x{bf}]/+/g;
    $line =~ s/\x{e2}\x{95}[\x{80}-\x{8b}\x{92}-\x{b0}]/+/g;
    # other
    $line =~ s/\x{e2}\x{95}\x{b1}/\//g;
    $line =~ s/\x{e2}\x{95}\x{b2}/\\/g;
    $line =~ s/\x{e2}\x{95}\x{b3}/X/g;
    }

  # w3m rendering issue apparently only seen by pdp
  # affects section numbers after the ToC, some info on spool-file -lines, etc
  # always appears to be a spurious extra character, safely just dropped.
  $line =~ s/\x{c2}//g;

  if ($line =~ /^\s*$/)
    {
    $line = "" if $lastwasblank;
    $lastwasblank = 1;
    next;
    }
  $lastwasblank = 0;
  }

# Find start of TOC, uppercasing its title

my $i = 0;
for ($i = 0; $i < scalar @lines; $i++)
  {
  $lines[$i] = "TABLE OF CONTENTS\n" if $lines[$i] =~ /^Table of Contents/;
  last if $lines[$i] =~ /^1\. /;
  }

# Find start of first chapter

for ($i++; $i < scalar @lines; $i++)
  { last if $lines[$i] =~ /^1\. /; }

# Process the body. We can detect the starts of chapters and sections by
# looking for preceding and following blank lines, and then matching against
# the numbers.

my $chapter = 0;
my $section;
for (; $i < scalar @lines; $i++)
  {
  next if $lines[$i-1] !~ /^$/ || $lines[$i+1] !~ /^$/;

  # Start of chapter

  if ($lines[$i] =~ /^(\d+)\. / && $1 == $chapter + 1)
    {
    $chapter++;
    $section = 0;
    $lines[$i] = "\n\n" . ("=" x 79) . "\n" . uc($lines[$i]);
    }

  # Start of next section

  elsif ($lines[$i] =~ /^(\d+)\.(\d+) / && $1 == $chapter && $2 == $section + 1)
    {
    $section++;
    $lines[$i] = "\n$lines[$i]" . "-" x (length($lines[$i]) - 1) . "\n";
    }
  }

print @lines;

# End