diff --git a/doc/build/builder/builders.py b/doc/build/builder/builders.py index f65678ce2d..a7fb45998b 100644 --- a/doc/build/builder/builders.py +++ b/doc/build/builder/builders.py @@ -122,10 +122,24 @@ class PopupSQLFormatter(HtmlFormatter): for t, v in _strip_trailing_whitespace(HtmlFormatter._format_lines(self, iter(buf))): yield t, v +class PopupLatexFormatter(LatexFormatter): + def _filter_tokens(self, tokensource): + for ttype, value in apply_filters(tokensource, [StripDocTestFilter()]): + if ttype in Token.Sql: + if ttype is not Token.Sql.Link and ttype is not Token.Sql.Open: + yield Token.Literal, re.sub(r'(?:[{stop}|\n]*)$', '', value) + else: + continue + else: + yield ttype, value + + def format(self, tokensource, outfile): + LatexFormatter.format(self, self._filter_tokens(tokensource), outfile) + def setup(app): app.add_lexer('pycon+sql', PyConWithSQLLexer()) app.add_lexer('python+sql', PythonWithSQLLexer()) PygmentsBridge.html_formatter = PopupSQLFormatter - #PygmentsBridge.latex_formatter = LatexFormatter + PygmentsBridge.latex_formatter = PopupLatexFormatter \ No newline at end of file diff --git a/doc/build/index.rst b/doc/build/index.rst index ed33dfbe59..f576324cdd 100644 --- a/doc/build/index.rst +++ b/doc/build/index.rst @@ -1,11 +1,7 @@ Table of Contents ================= -Main Documentation ------------------- - .. toctree:: - :glob: intro ormtutorial @@ -14,8 +10,19 @@ Main Documentation session dbengine metadata - reference/index - + +API Documentation +----------------- + +.. toctree:: + :glob: + :maxdepth: 3 + + reference/sqlalchemy/index + reference/orm/index + reference/ext/index + reference/dialects/index + Indices and tables ------------------ diff --git a/doc/build/reference/sqlalchemy/connections.rst b/doc/build/reference/sqlalchemy/connections.rst index 877b73231c..2f861816c3 100644 --- a/doc/build/reference/sqlalchemy/connections.rst +++ b/doc/build/reference/sqlalchemy/connections.rst @@ -10,7 +10,7 @@ Creating Engines .. autoclass:: sqlalchemy.engine.url.URL :members: - + Connectables ------------ diff --git a/lib/sqlalchemy/engine/url.py b/lib/sqlalchemy/engine/url.py index e00efd6c01..5d5ce0bd0f 100644 --- a/lib/sqlalchemy/engine/url.py +++ b/lib/sqlalchemy/engine/url.py @@ -102,14 +102,13 @@ class URL(object): used as the keys by default. Unset or false attributes are omitted from the final dictionary. - :param \**kw: Optional, alternate key names for url - attributes:: + :param \**kw: Optional, alternate key names for url attributes:: - # return 'username' as 'user' - username='user' + # return 'username' as 'user' + username='user' - # omit 'database' - database=None + # omit 'database' + database=None :param names: Deprecated. Same purpose as the keyword-based alternate names, but correlates the name to the original positionally.