← Back to branch summary

~bzr/ubuntu/lucid/bzr/beta-ppa

« back to all changes in this revision

Viewing changes to tools/prepare_for_latex.py

  • Committer: Martin Pool
  • Date: 2010-07-02 07:29:40 UTC
  • mfrom: (129.1.7 packaging-karmic)
  • Revision ID: mbp@sourcefrog.net-20100702072940-hpzq5elg8wjve8rh
http://bugs.debian.org/452024
http://bugs.debian.org/464688
http://bugs.debian.org/523595
http://bugs.debian.org/526233
http://bugs.debian.org/537708
http://bugs.debian.org/555336
http://bugs.debian.org/555343
https://launchpad.net/bugs/249452
https://launchpad.net/bugs/385074
* PPA rebuild.
* PPA rebuild for Karmic.
* PPA rebuild for Jaunty.
* PPA rebuild for Hardy.
* From postinst, actually remove the example bash completion scripts.
  (LP: #249452)
* New upstream release.
* New upstream release.
* New upstream release.
* Revert change to Build-depends: Dapper does not have python-central.
  Should be python-support..
* Target ppa..
* Target ppa..
* Target ppa..
* Target ppa..
* New upstream release.
* Switch to dpkg-source 3.0 (quilt) format.
* Bump standards version to 3.8.4.
* Remove embedded copy of python-configobj. Closes: #555336
* Remove embedded copy of python-elementtree. Closes: #555343
* Change section from 'Devel' to 'Vcs'..
* Change section from 'Devel' to 'Vcs'..
* Change section from 'Devel' to 'Vcs'..
* Change section from 'Devel' to 'Vcs'..
* Change section from 'Devel' to 'Vcs'..
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* debian/control: Fix obsolete-relation-form-in-source
  lintian warning. 
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Split out docs into bzr-doc package.
* New upstream release.
* Added John Francesco Ferlito to Uploaders.
* Fix install path to quick-reference guide
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Fix FTBFS due to path changes, again.
* Fix FTBFS due to doc paths changing
* New upstream release.
* Fix FTBFS due to path changes, again.
* Fix FTBFS due to doc paths changing
* New upstream release.
* Fix FTBFS due to path changes, again.
* Fix FTBFS due to doc paths changing
* New upstream release.
* Fix FTBFS due to path changes, again, again.
* Fix FTBFS due to path changes, again.
* Fix FTBFS due to path changes.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Bump standards version to 3.8.3.
* Remove unused patch system.
* New upstream release.
* New upstream release.
* New upstream release.
* Fix copy and paste tab error in .install file
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
 + Fixes compatibility with Python 2.4. Closes: #537708
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream version.
* Bump standards version to 3.8.2.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Add python-pyrex to build-deps to ensure C extensions are always build.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Split documentation into bzr-doc package. ((LP: #385074)
* Multiple packaging changes to make us more linitan clean.
* New upstream release.
* Split documentation into bzr-doc package. ((LP: #385074)
* Multiple packaging changes to make us more linitan clean.
* New upstream release.
* Split documentation into bzr-doc package. ((LP: #385074)
* Multiple packaging changes to make us more linitan clean.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Fix API compatibility version. (Closes: #526233)
* New upstream release.
  + Fixes default format for upgrade command. (Closes: #464688)
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Add missing dependency on zlib development library. (Closes:
  #523595)
* Add zlib build-depends.
* Add zlib build-depends.
* Add zlib build-depends.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Move to section vcs.
* Bump standards version to 3.8.1.
* New upstream release.
* Remove temporary patch for missing .c files from distribution
* New upstream release.
* Remove temporary patch for missing .c files from distribution
* New upstream release.
* Remove temporary patch for missing .c files from distribution
* Add temporary patch for missing .c files from distribution
* Add temporary patch for missing .c files from distribution
* Add temporary patch for missing .c files from distribution
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Recommend ca-certificates. (Closes: #452024)
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Update watch file. bazaar now uses launchpad to host its sources.
* Remove patch for inventory root revision copy, applied upstream.
* New upstream release.
* New upstream release.
* New upstream release
* Force removal of files installed in error to /etc/bash_completion.d/
  (LP: #249452)
* New upstream release.
* New upstream release
* New upstream release.
* Bump standards version.
* Include patch for inventory root revision copy, required for bzr-svn.
* New upstream release.
* Remove unused lintian overrides.
* Correct the package version not to be native.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* New upstream release.
* Final 1.5 release.
* New upstream release.
* New upstream release.
* New upstream release.
* Add myself as a co-maintainer.
* Add a Dm-Upload-Allowed: yes header.
* New upstream bugfix release.
* New upstream release.
* Final 1.3 release.
* New upstream release.
* First release candidate of the upcoming 1.3 release.
* Rebuild to fix the problem caused by a build with a broken python-central.
* New upstream release.
* Rebuild for dapper PPA.
* Apply Lamont's patches to fix build-dependencies on dapper.
  (See: https://bugs.launchpad.net/bzr/+bug/189915)

Show diffs side-by-side

added added

removed removed

Lines of Context:
tools/prepare_for_latex.py
 
1
#!/usr/bin/python
 
2
#
 
3
# Modify reStructuredText 'image' directives by adding a percentage 'width'
 
4
# attribute so that the images are scaled to fit on the page when the document
 
5
# is renderd to LaTeX, and add a center alignment.
 
6
#
 
7
# Also convert references to PNG images to use PDF files generated from SVG
 
8
# files if available.
 
9
#
 
10
# Without the explicit size specification, the images are ridiculously huge and
 
11
# most extend far off the right side of the page.
 
12
#
 
13
# Copyright (C) 2009 Colin D Bennett
 
14
#
 
15
# This program is free software; you can redistribute it and/or modify
 
16
# it under the terms of the GNU General Public License as published by
 
17
# the Free Software Foundation; either version 2 of the License, or
 
18
# (at your option) any later version.
 
19
#
 
20
# This program is distributed in the hope that it will be useful,
 
21
# but WITHOUT ANY WARRANTY; without even the implied warranty of
 
22
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
23
# GNU General Public License for more details.
 
24
#
 
25
# You should have received a copy of the GNU General Public License
 
26
# along with this program; if not, write to the Free Software
 
27
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 
28
 
 
29
import os
 
30
import re
 
31
import shutil
 
32
import sys
 
33
from sys import argv
 
34
from subprocess import call
 
35
 
 
36
verbose = False
 
37
 
 
38
IMAGE_DIRECTIVE_PATTERN = re.compile(ur'^..\s+image::\s+(.*)\s+$')
 
39
DIRECTIVE_ELEMENT_PATTERN = re.compile(ur'^\s+:[^:]+:\s+')
 
40
 
 
41
class Converter(object):
 
42
    def __init__(self, srcdir, destdir):
 
43
        self.srcdir = srcdir
 
44
        self.destdir = destdir
 
45
 
 
46
    # Process .txt files in sourcedir, generating output in destdir.
 
47
    def process_files(self):
 
48
        for filename in os.listdir(self.srcdir):
 
49
            # Process all text files in the current directory.
 
50
            if filename.endswith('.txt'):
 
51
                inpath = os.path.join(self.srcdir, filename)
 
52
                outpath = os.path.join(self.destdir, filename)
 
53
                self._process_file(inpath, outpath)
 
54
 
 
55
    def _process_file(self, inpath, outpath):
 
56
        infile = open(inpath, 'r')
 
57
        outfile = open(outpath, 'w')
 
58
        foundimg = False
 
59
        for line in infile:
 
60
            if foundimg and DIRECTIVE_ELEMENT_PATTERN.match(line) is None:
 
61
                if verbose:
 
62
                    print('Fixing image directive')
 
63
                # The preceding image directive has no elements.
 
64
                outfile.write(' :width: 85%\n')
 
65
                outfile.write(' :align: center\n')
 
66
            foundimg = False
 
67
 
 
68
            image_fixer = ImageFixer(self.srcdir, self.destdir)
 
69
            image_fixer_lambda = lambda match: image_fixer.substitute_pdf_image(match)
 
70
            line = IMAGE_DIRECTIVE_PATTERN.sub(image_fixer_lambda, line)
 
71
            directive_match = IMAGE_DIRECTIVE_PATTERN.match(line)
 
72
            if directive_match is not None:
 
73
                image_src = directive_match.group(1)
 
74
                if verbose:
 
75
                    print('Image ' + image_src + ' in ' + filename
 
76
                          + ': ' + line.strip())
 
77
 
 
78
                foundimg = True
 
79
            outfile.write(line)
 
80
        outfile.close()
 
81
        infile.close()
 
82
 
 
83
class ImageFixer(object):
 
84
    def __init__(self, srcdir, destdir):
 
85
        self.srcdir = srcdir
 
86
        self.destdir = destdir
 
87
 
 
88
    def substitute_pdf_image(self, match):
 
89
        prefix = match.string[:match.start(1)]
 
90
        newname = self.convert_image_to_pdf(match.group(1))
 
91
        suffix = match.string[match.end(1):]
 
92
        return prefix + newname + suffix
 
93
 
 
94
    def replace_extension(self, path, newext):
 
95
        if path.endswith(newext):
 
96
            raise Exception("File '" + path + "' already has extension '"
 
97
                            + newext +"'")
 
98
        dot = path.rfind('.')
 
99
        if dot == -1:
 
100
            return path + newext
 
101
        else:
 
102
            return path[:dot] + newext
 
103
 
 
104
    # Possibly use an SVG alternative to a PNG image, converting the SVG image
 
105
    # to a PDF first.  Whether or not a conversion is made, the image to use is
 
106
    # written to the destination directory and the path to use in the RST #
 
107
    # source is returned.
 
108
    def convert_image_to_pdf(self, filename):
 
109
        # Make the directory structure for the image in the destination dir.
 
110
        image_dirname = os.path.dirname(filename)
 
111
        if image_dirname:
 
112
            image_dirpath = os.path.join(self.destdir, image_dirname)
 
113
            if not os.path.exists(image_dirpath):
 
114
                os.mkdir(image_dirpath)
 
115
 
 
116
        # Decide how to handle this image.
 
117
        if filename.endswith('.png'):
 
118
            # See if there is a vector alternative.
 
119
            svgfile = self.replace_extension(filename, '.svg')
 
120
            svgpath = os.path.join(self.srcdir, svgfile)
 
121
            if os.path.exists(svgpath):
 
122
                if verbose:
 
123
                    print('Using SVG alternative to PNG')
 
124
                # Convert SVG to PDF with Inkscape.
 
125
                pdffile = self.replace_extension(filename, '.pdf')
 
126
                pdfpath = os.path.join(self.destdir, pdffile)
 
127
                if call(['/usr/bin/inkscape',
 
128
                         '--export-pdf=' + pdfpath, svgpath]) != 0:
 
129
                    raise Exception("Conversion to pdf failed")
 
130
                return pdffile
 
131
 
 
132
        # No conversion, just copy the file.
 
133
        srcpath = os.path.join(self.srcdir, filename)
 
134
        destpath = os.path.join(self.destdir, filename)
 
135
        shutil.copyfile(srcpath, destpath)
 
136
        return filename
 
137
 
 
138
if __name__ == '__main__':
 
139
    IN_DIR_OPT = '--in-dir='
 
140
    OUT_DIR_OPT = '--out-dir='
 
141
    srcdir = None
 
142
    destdir = None
 
143
 
 
144
    if len(argv) < 2:
 
145
        print('Usage: ' + argv[0] + ' ' + IN_DIR_OPT + 'INDIR '
 
146
              + OUT_DIR_OPT + 'OUTDIR')
 
147
        print
 
148
        print('This will convert all .txt files in INDIR into file in OUTDIR')
 
149
        print('while adjusting the use of images and possibly converting SVG')
 
150
        print('images to PDF files so LaTeX can include them.')
 
151
        sys.exit(1)
 
152
 
 
153
    for arg in argv[1:]:
 
154
        if arg == '-v' or arg == '--verbose':
 
155
            verbose = True
 
156
        elif arg.startswith(IN_DIR_OPT):
 
157
            srcdir = arg[len(IN_DIR_OPT):]
 
158
        elif arg.startswith(OUT_DIR_OPT):
 
159
            destdir = arg[len(OUT_DIR_OPT):]
 
160
        else:
 
161
            print('Invalid argument ' + arg)
 
162
            sys.exit(1)
 
163
 
 
164
    if srcdir is None or destdir is None:
 
165
        print('Please specify the ' + IN_DIR_OPT + ' and '
 
166
              + OUT_DIR_OPT + ' options.')
 
167
        sys.exit(1)
 
168
 
 
169
    if not os.path.exists(destdir):
 
170
        os.mkdir(destdir)
 
171
    Converter(srcdir, destdir).process_files()
 
172
 
 
173
# vim: set ts=4 sw=4 et: