X-Git-Url: https://git.mdrn.pl/librarian.git/blobdiff_plain/2ada86c7bb585d419b95c95ce42d5b7a9fa45475..fefdce4e24f9e397df5538fe6e7f54b5ece4d841:/src/librarian/pdf.py diff --git a/src/librarian/pdf.py b/src/librarian/pdf.py new file mode 100644 index 0000000..e6d897d --- /dev/null +++ b/src/librarian/pdf.py @@ -0,0 +1,378 @@ +# -*- coding: utf-8 -*- +# +# This file is part of Librarian, licensed under GNU Affero GPLv3 or later. +# Copyright © Fundacja Nowoczesna Polska. See NOTICE for more information. +# +"""PDF creation library. + +Creates one big XML from the book and its children, converts it to LaTeX +with TeXML, then runs it by XeLaTeX. + +""" +from __future__ import print_function, unicode_literals + +import os +import os.path +import shutil +from tempfile import mkdtemp, NamedTemporaryFile +import re +from copy import deepcopy +from subprocess import call, PIPE +from itertools import chain + +from Texml.processor import process +from lxml import etree +from lxml.etree import XMLSyntaxError, XSLTApplyError +import six + +from librarian.dcparser import Person +from librarian.parser import WLDocument +from librarian import ParseError, DCNS, get_resource, OutputFile, RDFNS +from librarian import functions +from librarian.cover import make_cover +from .sponsor import sponsor_logo + + +functions.reg_substitute_entities() +functions.reg_strip() +functions.reg_starts_white() +functions.reg_ends_white() +functions.reg_texcommand() + +STYLESHEETS = { + 'wl2tex': 'pdf/wl2tex.xslt', +} + +# CUSTOMIZATIONS = [ +# 'nofootnotes', +# 'nothemes', +# 'defaultleading', +# 'onehalfleading', +# 'doubleleading', +# 'nowlfont', +# ] + + +def insert_tags(doc, split_re, tagname, exclude=None): + """ inserts for every occurence of `split_re' in text nodes in the `doc' tree + + >>> t = etree.fromstring('A-B-CX-Y-Z') + >>> insert_tags(t, re.compile('-'), 'd') + >>> print(etree.tostring(t, encoding='unicode')) + ABCXYZ + """ + + for elem in doc.iter(tag=etree.Element): + if exclude and elem.tag in exclude: + continue + if elem.text: + chunks = split_re.split(elem.text) + while len(chunks) > 1: + ins = etree.Element(tagname) + ins.tail = chunks.pop() + elem.insert(0, ins) + elem.text = chunks.pop(0) + if elem.tail: + chunks = split_re.split(elem.tail) + parent = elem.getparent() + ins_index = parent.index(elem) + 1 + while len(chunks) > 1: + ins = etree.Element(tagname) + ins.tail = chunks.pop() + parent.insert(ins_index, ins) + elem.tail = chunks.pop(0) + + +def substitute_hyphens(doc): + insert_tags(doc, + re.compile("(?<=[^-\s])-(?=[^-\s])"), + "dywiz", + exclude=[DCNS("identifier.url"), DCNS("rights.license"), "meta"] + ) + + +def fix_hanging(doc): + insert_tags(doc, + re.compile("(?<=\s\w)\s+"), + "nbsp", + exclude=[DCNS("identifier.url"), DCNS("rights.license")] + ) + + +def fix_tables(doc): + for kol in doc.iter(tag='kol'): + if kol.tail is not None: + if not kol.tail.strip(): + kol.tail = None + for table in chain(doc.iter(tag='tabela'), doc.iter(tag='tabelka')): + if table.get('ramka') == '1' or table.get('ramki') == '1': + table.set('_format', '|' + 'X|' * len(table[0])) + else: + table.set('_format', 'X' * len(table[0])) + + +def mark_subauthors(doc): + root_author = ', '.join(elem.text for elem in doc.findall('./' + RDFNS('RDF') + '//' + DCNS('creator_parsed'))) + last_author = None + # jeśli autor jest inny niż autor całości i niż poprzedni autor + # to wstawiamy jakiś znacznik w rdf? + for subutwor in doc.xpath('/utwor/utwor'): + author = ', '.join(elem.text for elem in subutwor.findall('.//' + DCNS('creator_parsed'))) + if author not in (last_author, root_author): + subutwor.find('.//' + RDFNS('RDF')).append(etree.Element('use_subauthor')) + last_author = author + + +def move_motifs_inside(doc): + """ moves motifs to be into block elements """ + for master in doc.xpath('//powiesc|//opowiadanie|//liryka_l|//liryka_lp|' + '//dramat_wierszowany_l|//dramat_wierszowany_lp|//dramat_wspolczesny'): + for motif in master.xpath('motyw'): + for sib in motif.itersiblings(): + if sib.tag not in ('sekcja_swiatlo', 'sekcja_asterysk', 'separator_linia', + 'begin', 'end', 'motyw', 'extra', 'uwaga'): + # motif shouldn't have a tail - it would be untagged text + motif.tail = None + motif.getparent().remove(motif) + sib.insert(0, motif) + break + + +def hack_motifs(doc): + """ dirty hack for the marginpar-creates-orphans LaTeX problem + see http://www.latex-project.org/cgi-bin/ltxbugs2html?pr=latex/2304 + + moves motifs in stanzas from first verse to second + and from next to last to last, then inserts negative vspace before them + """ + for motif in doc.findall('//strofa//motyw'): + # find relevant verse-level tag + verse, stanza = motif, motif.getparent() + while stanza is not None and stanza.tag != 'strofa': + verse, stanza = stanza, stanza.getparent() + breaks_before = sum(1 for i in verse.itersiblings('br', preceding=True)) + breaks_after = sum(1 for i in verse.itersiblings('br')) + if (breaks_before == 0 and breaks_after > 0) or breaks_after == 1: + move_by = 1 + if breaks_after == 2: + move_by += 1 + moved_motif = deepcopy(motif) + motif.tag = 'span' + motif.text = None + moved_motif.tail = None + moved_motif.set('moved', str(move_by)) + + for br in verse.itersiblings('br'): + if move_by > 1: + move_by -= 1 + continue + br.addnext(moved_motif) + break + + +def parse_creator(doc): + """Generates readable versions of creator and translator tags. + + Finds all dc:creator and dc.contributor.translator tags + and adds *_parsed versions with forenames first. + """ + for person in doc.xpath("|".join('//dc:' + tag for tag in ('creator', 'contributor.translator')), + namespaces={'dc': str(DCNS)})[::-1]: + if not person.text: + continue + p = Person.from_text(person.text) + person_parsed = deepcopy(person) + person_parsed.tag = person.tag + '_parsed' + person_parsed.set('sortkey', person.text) + person_parsed.text = p.readable() + person.getparent().insert(0, person_parsed) + + +def get_stylesheet(name): + return get_resource(STYLESHEETS[name]) + + +def package_available(package, args='', verbose=False): + """ check if a verion of a latex package accepting given args is available """ + tempdir = mkdtemp('-wl2pdf-test') + fpath = os.path.join(tempdir, 'test.tex') + f = open(fpath, 'w') + f.write(""" + \\documentclass{wl} + \\usepackage[%s]{%s} + \\begin{document} + \\end{document} + """ % (args, package)) + f.close() + if verbose: + p = call(['xelatex', '-output-directory', tempdir, fpath]) + else: + p = call(['xelatex', '-interaction=batchmode', '-output-directory', tempdir, fpath], stdout=PIPE, stderr=PIPE) + shutil.rmtree(tempdir) + return p == 0 + + +def transform(wldoc, verbose=False, save_tex=None, morefloats=None, + cover=None, flags=None, customizations=None, ilustr_path='', latex_dir=False): + """ produces a PDF file with XeLaTeX + + wldoc: a WLDocument + verbose: prints all output from LaTeX + save_tex: path to save the intermediary LaTeX file to + morefloats (old/new/none): force specific morefloats + cover: a cover.Cover factory or True for default + flags: less-advertising, + customizations: user requested customizations regarding various formatting parameters (passed to wl LaTeX class) + """ + + # Parse XSLT + try: + book_info = wldoc.book_info + document = load_including_children(wldoc) + root = document.edoc.getroot() + + if cover: + if cover is True: + cover = make_cover + bound_cover = cover(book_info, width=1200) + root.set('data-cover-width', str(bound_cover.width)) + root.set('data-cover-height', str(bound_cover.height)) + if bound_cover.uses_dc_cover: + if book_info.cover_by: + root.set('data-cover-by', book_info.cover_by) + if book_info.cover_source: + root.set('data-cover-source', book_info.cover_source) + if flags: + for flag in flags: + root.set('flag-' + flag, 'yes') + + # check for LaTeX packages + if morefloats: + root.set('morefloats', morefloats.lower()) + elif package_available('morefloats', 'maxfloats=19'): + root.set('morefloats', 'new') + + # add customizations + if customizations is not None: + root.set('customizations', u','.join(customizations)) + + # add editors info + editors = document.editors() + if editors: + root.set('editors', u', '.join(sorted( + editor.readable() for editor in editors))) + if document.book_info.funders: + root.set('funders', u', '.join(document.book_info.funders)) + if document.book_info.thanks: + root.set('thanks', document.book_info.thanks) + + # hack the tree + move_motifs_inside(document.edoc) + hack_motifs(document.edoc) + parse_creator(document.edoc) + substitute_hyphens(document.edoc) + fix_hanging(document.edoc) + fix_tables(document.edoc) + mark_subauthors(document.edoc) + + # wl -> TeXML + style_filename = get_stylesheet("wl2tex") + style = etree.parse(style_filename) + functions.reg_mathml_latex() + + # TeXML -> LaTeX + temp = mkdtemp('-wl2pdf') + + for ilustr in document.edoc.findall("//ilustr"): + shutil.copy(os.path.join(ilustr_path, ilustr.get("src")), temp) + + for sponsor in book_info.sponsors: + ins = etree.Element("data-sponsor", name=sponsor) + logo = sponsor_logo(sponsor) + if logo: + fname = 'sponsor-%s' % os.path.basename(logo) + shutil.copy(logo, os.path.join(temp, fname)) + ins.set('src', fname) + root.insert(0, ins) + + if book_info.sponsor_note: + root.set("sponsor-note", book_info.sponsor_note) + + texml = document.transform(style) + + if cover: + with open(os.path.join(temp, 'cover.png'), 'w') as f: + bound_cover.save(f, quality=80) + + del document # no longer needed large object :) + + tex_path = os.path.join(temp, 'doc.tex') + fout = open(tex_path, 'wb') + process(six.BytesIO(texml), fout, 'utf-8') + fout.close() + del texml + + if save_tex: + shutil.copy(tex_path, save_tex) + + # LaTeX -> PDF + shutil.copy(get_resource('pdf/wl.cls'), temp) + shutil.copy(get_resource('res/wl-logo.png'), temp) + + if latex_dir: + return temp + + try: + cwd = os.getcwd() + except OSError: + cwd = None + os.chdir(temp) + + # some things work better when compiled twice + # (table of contents, [line numbers - disabled]) + for run in range(2): + if verbose: + p = call(['xelatex', tex_path]) + else: + p = call(['xelatex', '-interaction=batchmode', tex_path], stdout=PIPE, stderr=PIPE) + if p: + raise ParseError("Error parsing .tex file") + + if cwd is not None: + os.chdir(cwd) + + output_file = NamedTemporaryFile(prefix='librarian', suffix='.pdf', delete=False) + pdf_path = os.path.join(temp, 'doc.pdf') + shutil.move(pdf_path, output_file.name) + shutil.rmtree(temp) + return OutputFile.from_filename(output_file.name) + + except (XMLSyntaxError, XSLTApplyError) as e: + raise ParseError(e) + + +def load_including_children(wldoc=None, provider=None, uri=None): + """ Makes one big xml file with children inserted at end. + + Either wldoc or provider and URI must be provided. + """ + + if uri and provider: + f = provider.by_uri(uri) + text = f.read().decode('utf-8') + f.close() + elif wldoc is not None: + text = etree.tostring(wldoc.edoc, encoding='unicode') + provider = wldoc.provider + else: + raise ValueError('Neither a WLDocument, nor provider and URI were provided.') + + text = re.sub(r"([\u0400-\u04ff]+)", r"\1", text) + + document = WLDocument.from_bytes(text.encode('utf-8'), parse_dublincore=True, provider=provider) + document.swap_endlines() + + for child_uri in document.book_info.parts: + child = load_including_children(provider=provider, uri=child_uri) + document.edoc.getroot().append(child.edoc.getroot()) + return document