X-Git-Url: https://git.mdrn.pl/librarian.git/blobdiff_plain/fe763827605d48b2ad27d313cbcd84b588066070..88f39c4f90a67164b2c3da7c7a41df420f3b17ab:/src/librarian/epub.py diff --git a/src/librarian/epub.py b/src/librarian/epub.py index fc5ee16..7dbfc49 100644 --- a/src/librarian/epub.py +++ b/src/librarian/epub.py @@ -1,161 +1,14 @@ -# -*- 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. +# Copyright © Fundacja Wolne Lektury. See NOTICE for more information. # -from __future__ import print_function, unicode_literals - -import os -import os.path import re -import subprocess -import six from copy import deepcopy -from mimetypes import guess_type - -from ebooklib import epub from lxml import etree -from tempfile import mkdtemp, NamedTemporaryFile -from shutil import rmtree - -from librarian import RDFNS, WLNS, DCNS, OutputFile -from librarian.cover import make_cover - -from librarian import functions, get_resource - -from librarian.hyphenator import Hyphenator - -functions.reg_person_name() - - -def squeeze_whitespace(s): - return re.sub(b'\\s+', b' ', s) - - -def set_hyph_language(source_tree): - bibl_lng = etree.XPath('//dc:language//text()', - namespaces={'dc': str(DCNS)})(source_tree) - short_lng = functions.lang_code_3to2(bibl_lng[0]) - try: - return Hyphenator(get_resource('res/hyph-dictionaries/hyph_' + - short_lng + '.dic')) - except: - pass - - -def hyphenate_and_fix_conjunctions(source_tree, hyph): - texts = etree.XPath('/utwor/*[2]//text()')(source_tree) - for t in texts: - parent = t.getparent() - if hyph is not None: - newt = '' - wlist = re.compile(r'\w+|[^\w]', re.UNICODE).findall(t) - for w in wlist: - newt += hyph.inserted(w, u'\u00AD') - else: - newt = t - newt = re.sub(r'(?<=\s\w)\s+', u'\u00A0', newt) - if t.is_text: - parent.text = newt - elif t.is_tail: - parent.tail = newt - -def inner_xml(node): - """ returns node's text and children as a string +from librarian import WLNS - >>> print(inner_xml(etree.fromstring('xyz'))) - xyz - """ - - nt = node.text if node.text is not None else '' - return ''.join( - [nt] + [etree.tostring(child, encoding='unicode') for child in node] - ) - - -def set_inner_xml(node, text): - """ sets node's text and children from a string - >>> e = etree.fromstring('bxx') - >>> set_inner_xml(e, 'xyz') - >>> print(etree.tostring(e, encoding='unicode')) - xyz - """ - - p = etree.fromstring('%s' % text) - node.text = p.text - node[:] = p[:] - - -def node_name(node): - """ Find out a node's name - - >>> print(node_name(etree.fromstring('XYZ'))) - XYZ - """ - - tempnode = deepcopy(node) - - for p in ('pe', 'pa', 'pt', 'pr', 'motyw'): - for e in tempnode.findall('.//%s' % p): - t = e.tail - e.clear() - e.tail = t - etree.strip_tags(tempnode, '*') - return tempnode.text - - -def xslt(xml, sheet, **kwargs): - if isinstance(xml, etree._Element): - xml = etree.ElementTree(xml) - with open(sheet) as xsltf: - transform = etree.XSLT(etree.parse(xsltf)) - params = dict( - (key, transform.strparam(value)) - for key, value in kwargs.items() - ) - return transform(xml, **params) - - -def replace_characters(node): - def replace_chars(text): - if text is None: - return None - return text.replace(u"\ufeff", u"")\ - .replace("---", u"\u2014")\ - .replace("--", u"\u2013")\ - .replace(",,", u"\u201E")\ - .replace('"', u"\u201D")\ - .replace("'", u"\u2019") - if node.tag in ('uwaga', 'extra'): - t = node.tail - node.clear() - node.tail = t - node.text = replace_chars(node.text) - node.tail = replace_chars(node.tail) - for child in node: - replace_characters(child) - - -def find_annotations(annotations, source, part_no): - for child in source: - if child.tag in ('pe', 'pa', 'pt', 'pr'): - annotation = deepcopy(child) - number = str(len(annotations) + 1) - annotation.set('number', number) - annotation.set('part', str(part_no)) - annotation.tail = '' - annotations.append(annotation) - tail = child.tail - child.clear() - child.tail = tail - child.text = number - if child.tag not in ('extra', 'uwaga'): - find_annotations(annotations, child, part_no) - - -class Stanza(object): +class Stanza: """ Converts / verse endings into verse elements in a stanza. @@ -234,542 +87,3 @@ def replace_by_verse(tree): stanzas = tree.findall('.//' + WLNS('strofa')) for stanza in stanzas: Stanza(stanza).versify() - - -def used_chars(element): - """ Lists characters used in an ETree Element """ - chars = set((element.text or '') + (element.tail or '')) - for child in element: - chars = chars.union(used_chars(child)) - return chars - - -def chop(main_text): - """ divide main content of the XML file into chunks """ - - # prepare a container for each chunk - part_xml = etree.Element('utwor') - etree.SubElement(part_xml, 'master') - main_xml_part = part_xml[0] # master - - last_node_part = False - - # The below loop are workaround for a problem with epubs - # in drama ebooks without acts. - is_scene = False - is_act = False - for one_part in main_text: - name = one_part.tag - if name == 'naglowek_scena': - is_scene = True - elif name == 'naglowek_akt': - is_act = True - - for one_part in main_text: - name = one_part.tag - if is_act is False and is_scene is True: - if name == 'naglowek_czesc': - yield part_xml - last_node_part = True - main_xml_part[:] = [deepcopy(one_part)] - elif not last_node_part and name == "naglowek_scena": - yield part_xml - main_xml_part[:] = [deepcopy(one_part)] - else: - main_xml_part.append(deepcopy(one_part)) - last_node_part = False - else: - if name == 'naglowek_czesc': - yield part_xml - last_node_part = True - main_xml_part[:] = [deepcopy(one_part)] - elif (not last_node_part - and name in ( - "naglowek_rozdzial", "naglowek_akt", "srodtytul" - )): - yield part_xml - main_xml_part[:] = [deepcopy(one_part)] - else: - main_xml_part.append(deepcopy(one_part)) - last_node_part = False - yield part_xml - - -def transform_chunk(chunk_xml, chunk_no, annotations, empty=False, - _empty_html_static=[]): - """ - Transforms one chunk, returns a HTML string, a TOC object - and a set of used characters. - """ - - toc = [] - for element in chunk_xml[0]: - if element.tag == "naglowek_czesc": - toc.append( - ( - epub.Link( - "part%d.xhtml#book-text" % chunk_no, - node_name(element), - "part%d-text" % chunk_no - ), - [] - ) - ) - elif element.tag in ("naglowek_rozdzial", "naglowek_akt", "srodtytul"): - toc.append( - ( - epub.Link( - "part%d.xhtml" % chunk_no, - node_name(element), - "part%d" % chunk_no - ), - [] - ) - ) - elif element.tag in ('naglowek_podrozdzial', 'naglowek_scena'): - if not toc: - toc.append( - ( - epub.Link( - "part%d.xhtml" % chunk_no, - " ", - "part%d" % chunk_no - ), - [] - ) - ) - - subnumber = len(toc[-1][1]) - toc[-1][1].append( - epub.Link( - "part%d.xhtml#sub%d" % (chunk_no, subnumber), - node_name(element), - "part%d-sub%d" % (chunk_no, subnumber) - ) - ) - element.set('sub', six.text_type(subnumber)) - if empty: - if not _empty_html_static: - with open(get_resource('epub/emptyChunk.xhtml')) as f: - _empty_html_static.append(f.read()) - chars = set() - output_html = _empty_html_static[0] - else: - find_annotations(annotations, chunk_xml, chunk_no) - replace_by_verse(chunk_xml) - html_tree = xslt(chunk_xml, get_resource('epub/xsltScheme.xsl')) - chars = used_chars(html_tree.getroot()) - output_html = etree.tostring( - html_tree, pretty_print=True, xml_declaration=True, - encoding="utf-8", - doctype='' - ) - return output_html, toc, chars - - -def remove_empty_lists_from_toc(toc): - for i, e in enumerate(toc): - if isinstance(e, tuple): - if e[1]: - remove_empty_lists_from_toc(e[1]) - else: - toc[i] = e[0] - - -def transform(wldoc, verbose=False, style=None, - sample=None, cover=None, flags=None, hyphenate=False, - ilustr_path='', output_type='epub'): - """ produces a EPUB file - - sample=n: generate sample e-book (with at least n paragraphs) - cover: a cover.Cover factory or True for default - flags: less-advertising, without-fonts, working-copy - """ - - def transform_file(wldoc, chunk_counter=1, first=True, sample=None): - """ processes one input file and proceeds to its children """ - - replace_characters(wldoc.edoc.getroot()) - - hyphenator = set_hyph_language( - wldoc.edoc.getroot() - ) if hyphenate else None - hyphenate_and_fix_conjunctions(wldoc.edoc.getroot(), hyphenator) - - # every input file will have a TOC entry, - # pointing to starting chunk - toc = [ - ( - epub.Link( - "part%d.xhtml" % chunk_counter, - wldoc.book_info.title, - "path%d-start" % chunk_counter - ), - [] - ) - ] - chars = set() - if first: - # write book title page - html_tree = xslt(wldoc.edoc, get_resource('epub/xsltTitle.xsl'), - outputtype=output_type) - chars = used_chars(html_tree.getroot()) - html_string = etree.tostring( - html_tree, pretty_print=True, xml_declaration=True, - encoding="utf-8", - doctype='' - ) - item = epub.EpubItem( - uid="titlePage", - file_name="title.xhtml", - media_type="application/xhtml+xml", - content=squeeze_whitespace(html_string) - ) - spine.append(item) - output.add_item(item) - # add a title page TOC entry - toc[-1][1].append( - epub.Link( - "title.xhtml", - "Strona tytułowa", - "title", - ) - ) - - item = epub.EpubNav() - toc[-1][1].append( - epub.Link( - "nav.xhtml", - "Spis treści", - "nav" - ) - ) - output.add_item(item) - spine.append(item) - - elif wldoc.book_info.parts: - # write title page for every parent - if sample is not None and sample <= 0: - chars = set() - html_string = open( - get_resource('epub/emptyChunk.xhtml')).read() - else: - html_tree = xslt(wldoc.edoc, - get_resource('epub/xsltChunkTitle.xsl')) - chars = used_chars(html_tree.getroot()) - html_string = etree.tostring( - html_tree, pretty_print=True, xml_declaration=True, - encoding="utf-8", - doctype='' - ) - item = epub.EpubItem( - uid="part%d" % chunk_counter, - file_name="part%d.xhtml" % chunk_counter, - media_type="application/xhtml+xml", - content=squeeze_whitespace(html_string) - ) - output.add_item(item) - spine.append(item) - - chunk_counter += 1 - - if len(wldoc.edoc.getroot()) > 1: - # rdf before style master - main_text = wldoc.edoc.getroot()[1] - else: - # rdf in style master - main_text = wldoc.edoc.getroot()[0] - if main_text.tag == RDFNS('RDF'): - main_text = None - - if main_text is not None: - for chunk_xml in chop(main_text): - empty = False - if sample is not None: - if sample <= 0: - empty = True - else: - sample -= len(chunk_xml.xpath( - '//strofa|//akap|//akap_cd|//akap_dialog' - )) - chunk_html, chunk_toc, chunk_chars = transform_chunk( - chunk_xml, chunk_counter, annotations, empty) - - toc[-1][1].extend(chunk_toc) - chars = chars.union(chunk_chars) - item = epub.EpubItem( - uid="part%d" % chunk_counter, - file_name="part%d.xhtml" % chunk_counter, - media_type="application/xhtml+xml", - content=squeeze_whitespace(chunk_html) - ) - output.add_item(item) - spine.append(item) - chunk_counter += 1 - - for child in wldoc.parts(): - child_toc, chunk_counter, chunk_chars, sample = transform_file( - child, chunk_counter, first=False, sample=sample) - toc[-1][1].extend(child_toc) - chars = chars.union(chunk_chars) - - return toc, chunk_counter, chars, sample - - document = deepcopy(wldoc) - del wldoc - - if flags: - for flag in flags: - document.edoc.getroot().set(flag, 'yes') - - document.clean_ed_note() - document.clean_ed_note('abstrakt') - - # add editors info - editors = document.editors() - if editors: - document.edoc.getroot().set('editors', u', '.join(sorted( - editor.readable() for editor in editors))) - if document.book_info.funders: - document.edoc.getroot().set('funders', u', '.join( - document.book_info.funders)) - if document.book_info.thanks: - document.edoc.getroot().set('thanks', document.book_info.thanks) - - output = epub.EpubBook() - output.set_identifier(six.text_type(document.book_info.url)) - output.set_language(functions.lang_code_3to2(document.book_info.language)) - output.set_title(document.book_info.title) - for author in document.book_info.authors: - output.add_author( - author.readable(), - file_as=six.text_type(author) - ) - for translator in document.book_info.translators: - output.add_author( - translator.readable(), - file_as=six.text_type(translator), - role='translator' - ) - for publisher in document.book_info.publisher: - output.add_metadata("DC", "publisher", publisher) - output.add_metadata("DC", "date", document.book_info.created_at) - - output.guide.append({ - "type": "text", - "title": "Początek", - "href": "part1.xhtml" - }) - - output.add_item(epub.EpubNcx()) - - spine = output.spine - - functions.reg_mathml_epub(output) - - if os.path.isdir(ilustr_path): - ilustr_elements = set(ilustr.get('src') - for ilustr in document.edoc.findall('//ilustr')) - for i, filename in enumerate(os.listdir(ilustr_path)): - if filename not in ilustr_elements: - continue - file_path = os.path.join(ilustr_path, filename) - with open(file_path, 'rb') as f: - output.add_item( - epub.EpubItem( - uid='image%s' % i, - file_name=filename, - media_type=guess_type(file_path)[0], - content=f.read() - ) - ) - - # write static elements - - with open(get_resource('res/wl-logo-small.png'), 'rb') as f: - output.add_item( - epub.EpubItem( - uid="logo_wolnelektury.png", - file_name="logo_wolnelektury.png", - media_type="image/png", - content=f.read() - ) - ) - with open(get_resource('res/jedenprocent.png'), 'rb') as f: - output.add_item( - epub.EpubItem( - uid="jedenprocent", - file_name="jedenprocent.png", - media_type="image/png", - content=f.read() - ) - ) - - if not style: - style = get_resource('epub/style.css') - with open(style, 'rb') as f: - output.add_item( - epub.EpubItem( - uid="style", - file_name="style.css", - media_type="text/css", - content=f.read() - ) - ) - - if cover: - if cover is True: - cover = make_cover - - cover_file = six.BytesIO() - bound_cover = cover(document.book_info) - bound_cover.save(cover_file) - cover_name = 'cover.%s' % bound_cover.ext() - - output.set_cover( - file_name=cover_name, - content=cover_file.getvalue(), - ) - spine.append('cover') - output.guide.append({ - "type": "cover", - "href": "cover.xhtml", - "title": "Okładka", - }) - - del cover_file - - if bound_cover.uses_dc_cover: - if document.book_info.cover_by: - document.edoc.getroot().set('data-cover-by', - document.book_info.cover_by) - if document.book_info.cover_source: - document.edoc.getroot().set('data-cover-source', - document.book_info.cover_source) - - annotations = etree.Element('annotations') - - toc, chunk_counter, chars, sample = transform_file(document, sample=sample) - output.toc = toc[0][1] - - if len(toc) < 2: - output.toc.append( - epub.Link( - "part1.xhtml", - "Początek utworu", - "part1" - ) - ) - - # Last modifications in container files and EPUB creation - if len(annotations) > 0: - output.toc.append( - epub.Link( - "annotations.xhtml", - "Przypisy", - "annotations" - ) - ) - replace_by_verse(annotations) - html_tree = xslt(annotations, get_resource('epub/xsltAnnotations.xsl')) - chars = chars.union(used_chars(html_tree.getroot())) - - item = epub.EpubItem( - uid="annotations", - file_name="annotations.xhtml", - media_type="application/xhtml+xml", - content=etree.tostring( - html_tree, pretty_print=True, xml_declaration=True, - encoding="utf-8", - doctype='' - ) - ) - output.add_item(item) - spine.append(item) - - output.toc.append( - epub.Link( - "support.xhtml", - "Wesprzyj Wolne Lektury", - "support" - ) - ) - with open(get_resource('epub/support.xhtml'), 'rb') as f: - html_string = f.read() - chars.update(used_chars(etree.fromstring(html_string))) - item = epub.EpubItem( - uid="support", - file_name="support.xhtml", - media_type="application/xhtml+xml", - content=squeeze_whitespace(html_string) - ) - output.add_item(item) - spine.append(item) - - output.toc.append( - epub.Link( - "last.xhtml", - "Strona redakcyjna", - "last" - ) - ) - html_tree = xslt(document.edoc, get_resource('epub/xsltLast.xsl'), - outputtype=output_type) - chars.update(used_chars(html_tree.getroot())) - item = epub.EpubItem( - uid="last", - file_name="last.xhtml", - media_type="application/xhtml+xml", - content=squeeze_whitespace(etree.tostring( - html_tree, pretty_print=True, xml_declaration=True, - encoding="utf-8", - doctype='' - )) - ) - output.add_item(item) - spine.append(item) - - if not flags or 'without-fonts' not in flags: - # strip fonts - tmpdir = mkdtemp('-librarian-epub') - try: - cwd = os.getcwd() - except OSError: - cwd = None - - os.chdir(os.path.join(os.path.dirname(os.path.realpath(__file__)), - 'font-optimizer')) - for fname in ('DejaVuSerif.ttf', 'DejaVuSerif-Bold.ttf', - 'DejaVuSerif-Italic.ttf', 'DejaVuSerif-BoldItalic.ttf'): - optimizer_call = ['perl', 'subset.pl', '--chars', - ''.join(chars).encode('utf-8'), - get_resource('fonts/' + fname), - os.path.join(tmpdir, fname)] - env = {"PERL_USE_UNSAFE_INC": "1"} - if verbose: - print("Running font-optimizer") - subprocess.check_call(optimizer_call, env=env) - else: - dev_null = open(os.devnull, 'w') - subprocess.check_call(optimizer_call, stdout=dev_null, - stderr=dev_null, env=env) - with open(os.path.join(tmpdir, fname), 'rb') as f: - output.add_item( - epub.EpubItem( - uid=fname, - file_name=fname, - media_type="font/ttf", - content=f.read() - ) - ) - rmtree(tmpdir) - if cwd is not None: - os.chdir(cwd) - - remove_empty_lists_from_toc(output.toc) - - output_file = NamedTemporaryFile(prefix='librarian', suffix='.epub', - delete=False) - output_file.close() - epub.write_epub(output_file.name, output, {'epub3_landmark': False}) - return OutputFile.from_filename(output_file.name)