Package: python-sqlparse
Version: 0.1.4-1
Severity: minor
User: [email protected]
Usertags: broken-sphinx-search

If you open file:///usr/share/doc/python-sqlparse/html/search.html?q=example in your browser, you will be shown the following results:

Analyzing the Parsed Statement
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> <html xmlns="http://www.w3.org/1999/xhtml";> <head> 
<meta http-equiv="Content-Type" content="text/html; chars...
Introduction
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> <html xmlns="http://www.w3.org/1999/xhtml";> <head> 
<meta http-equiv="Content-Type" content="text/html; chars...
User Interfaces
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";> <html xmlns="http://www.w3.org/1999/xhtml";> <head> 
<meta http-equiv="Content-Type" content="text/html; chars...

The context in which they are show is bogus (it's the source of search.html itself). This is because of the following line in search.html:

      URL_ROOT:    '#',

Sphinx doesn't support URL_ROOT's containing fragments, and in fact won't normally generate HTML that would contain it[0]. However, sqlparse uses a custom theme that doesn't ensure that # won't be used.

Since the agogo theme (i.e., the theme sqlparse) has been included in Sphinx proper since 1.0, I'd recommend to just remove the whole docs/agogo/ directory in debian/rules and let Sphinx use the built-in agogo theme.


[0] 
https://bitbucket.org/birkenfeld/sphinx/src/1.1.3/sphinx/themes/basic/layout.html#cl-20

--
Jakub Wilk



--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]

Reply via email to