Problem with sphinxcontrib.bibtex and EPUB target

49 views
Skip to first unread message

Mathias Weidner

unread,
Feb 2, 2019, 12:59:57 PM2/2/19
to sphinx-users
Hi all,

I am trying to generate an EPUB with sphinx that contains a bibliography generated with sphinxcontrib.bibtex.

When I check the EPUB with epubcheck I get the following error message:

Validating using EPUB version 3.0.1 rules.
ERROR
(RSC-005): build/epub/FehlersuchebeiIKEv2IPsecVPN.epub/anhang/anhang.xhtml(17,66): Error while parsing file 'element "dl" not allowed here; expected the element end-tag, text or element "a", "abbr", "area", "audio", "b", "bdi", "bdo", "br", "button", "canvas", "cite", "code", "command", "datalist", "del", "dfn", "em", "embed", "epub:switch", "i", "iframe", "img", "input", "ins", "kbd", "keygen", "label", "link", "map", "mark", "meta", "meter", "ns1:math", "ns2:svg", "object", "output", "progress", "q", "ruby", "s", "samp", "script", "select", "small", "span", "strong", "sub", "sup", "textarea", "time", "u", "var", "video" or "wbr" (with xmlns:ns1="http://www.w3.org/1998/Math/MathML" xmlns:ns2="http://www.w3.org/2000/svg")'.

Looking into the XHTML file I find the following:

--- anhang/anhang.xhtml ---
 16 <h1>Literaturverzeichnis</h1>
 17 <p id="bibtex-bibliography-anhang/
anhang-0"><dl class="citation">
 18 <dt class="
label" id="ikev2parameters"><span class="brackets">IKE</span></dt>

The source file that generates this output is:

--- anhang/anhang.rst ---
  1
 
2 Literaturverzeichnis
 
3 ====================
 
4
 
5 .. bibliography:: troubleshoot-ipsec.bib
 
6    :all:

My configuration regarding extensions is:

--- conf.py ---
extensions = [
   
'sphinxcontrib.bibtex',
   
'sphinx.ext.todo',
   
'sphinx.ext.autosectionlabel',
]

I am using

Python 2.7.15rc1
Sphinx==1.7.3
sphinxcontrib-bibtex==0.4.0

Do you have any hints what I could do to get a clean EPUB.

Thanks,

Mathias

Komiya Takeshi

unread,
Feb 3, 2019, 3:10:49 AM2/3/19
to sphinx...@googlegroups.com
Hi Mathias,

It might be a bug of Sphinx itself. And it was already fixed in master branch.
Could you try an unreleased version of Sphinx?
You can use it via "pip install git+https://github.com/sphinx-doc/sphinx" ?

Thanks,
Takeshi KOMIYA

2019年2月3日(日) 2:59 Mathias Weidner <goo...@mamawe.net>:
> --
> You received this message because you are subscribed to the Google Groups "sphinx-users" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to sphinx-users...@googlegroups.com.
> To post to this group, send email to sphinx...@googlegroups.com.
> Visit this group at https://groups.google.com/group/sphinx-users.
> For more options, visit https://groups.google.com/d/optout.

Mathias Weidner

unread,
Feb 4, 2019, 2:18:00 AM2/4/19
to sphinx-users
Hi Takeshi,

I tested this with newer versions of Python, Sphinx, and sphinxcontrib-bibtex.

Using these I got the same error message from epubcheck:

Python 3.6.7
Sphinx==2.0.0.dev20190204
sphinxcontrib
-bibtex==0.4.2

Is there anything else that I could do?

Thanks,
Mathias

Komiya Takeshi

unread,
Feb 6, 2019, 11:43:09 AM2/6/19
to sphinx...@googlegroups.com
My bad. It's my wrong. if so, it might a bug of bibtex extension.

Thanks,
Takeshi KOMIYA

2019年2月4日(月) 16:18 Mathias Weidner <goo...@mamawe.net>:
Reply all
Reply to author
Forward
0 new messages