diff --git a/doc/_themes/odoodoc/github.py b/doc/_themes/odoodoc/github.py index 2e07b67e57a..0591a4203cc 100644 --- a/doc/_themes/odoodoc/github.py +++ b/doc/_themes/odoodoc/github.py @@ -3,53 +3,54 @@ import importlib import os.path from urlparse import urlunsplit -# FIXME: better way to handle this? -_app = None def setup(app): - global _app - _app = app app.add_config_value('github_user', None, 'env') app.add_config_value('github_project', None, 'env') + app.connect('html-page-context', add_doc_link) -def linkcode_resolve(domain, info): - # TODO: js? - if domain != 'py': - return None + def linkcode_resolve(domain, info): + """ Resolves provided object to corresponding github URL + """ + # TODO: js? + if domain != 'py': + return None + if not (app.config.github_user and app.config.github_project): + return None - module, fullname = info['module'], info['fullname'] - # TODO: attributes/properties don't have modules, maybe try to look them - # up based on their cached host object? - if not module: - return None + module, fullname = info['module'], info['fullname'] + # TODO: attributes/properties don't have modules, maybe try to look + # them up based on their cached host object? + if not module: + return None - obj = importlib.import_module(module) - for item in fullname.split('.'): - obj = getattr(obj, item, None) + obj = importlib.import_module(module) + for item in fullname.split('.'): + obj = getattr(obj, item, None) - if obj is None: - return None + if obj is None: + return None - # get original from decorated methods - try: obj = getattr(obj, '_orig') - except AttributeError: pass + # get original from decorated methods + try: obj = getattr(obj, '_orig') + except AttributeError: pass - try: - obj_source_path = inspect.getsourcefile(obj) - _, line = inspect.getsourcelines(obj) - except (TypeError, IOError): - # obj doesn't have a module, or something - return None + try: + obj_source_path = inspect.getsourcefile(obj) + _, line = inspect.getsourcelines(obj) + except (TypeError, IOError): + # obj doesn't have a module, or something + return None - import openerp - project_root = os.path.join(os.path.dirname(openerp.__file__), '..') - return make_github_link( - os.path.relpath(obj_source_path, project_root), - line) + import openerp + project_root = os.path.join(os.path.dirname(openerp.__file__), '..') + return make_github_link( + app, + os.path.relpath(obj_source_path, project_root), + line) + app.config.linkcode_resolve = linkcode_resolve -def make_github_link(path, line=None, mode="blob"): - config = _app.config - if not (config.github_user and config.github_project): - return None +def make_github_link(app, path, line=None, mode="blob"): + config = app.config urlpath = "/{user}/{project}/{mode}/{branch}/{path}".format( user=config.github_user, @@ -66,6 +67,18 @@ def make_github_link(path, line=None, mode="blob"): '' if line is None else 'L%d' % line )) -def github_doc_link(pagename, mode='blob'): - return make_github_link( - 'doc/%s%s' % (pagename, _app.config.source_suffix), mode=mode) +def add_doc_link(app, pagename, templatename, context, doctree): + """ Add github_link function linking to the current page on github """ + if not app.config.github_user and app.config.github_project: + return + + def github_doc_link(mode='blob'): + """ returns the github URL for the current page + + :param str mode: 'edit' for edition view + """ + return make_github_link( + app, + 'doc/%s%s' % (pagename, app.config.source_suffix), + mode=mode) + context['github_link'] = github_doc_link diff --git a/doc/_themes/odoodoc/layout.html b/doc/_themes/odoodoc/layout.html index a803f913c96..efa9ff76b10 100644 --- a/doc/_themes/odoodoc/layout.html +++ b/doc/_themes/odoodoc/layout.html @@ -14,6 +14,12 @@ {%- endblock -%} +{%- block extrahead -%} + {%- if canonical -%} + + {%- endif -%} +{%- endblock -%} + {%- block content -%}