{"action":"closed","issue":{"url":"https://api.github.com/repos/italia/sphinx_italia_theme/issues/8","repository_url":"https://api.github.com/repos/italia/sphinx_italia_theme","labels_url":"https://api.github.com/repos/italia/sphinx_italia_theme/issues/8/labels{/name}","comments_url":"https://api.github.com/repos/italia/sphinx_italia_theme/issues/8/comments","events_url":"https://api.github.com/repos/italia/sphinx_italia_theme/issues/8/events","html_url":"https://github.com/italia/sphinx_italia_theme/issues/8","id":263133166,"number":8,"title":"conf.py snippet is not enough to use this theme","user":{"login":"alexrj","id":594957,"avatar_url":"https://avatars2.githubusercontent.com/u/594957?v=4","gravatar_id":"","url":"https://api.github.com/users/alexrj","html_url":"https://github.com/alexrj","followers_url":"https://api.github.com/users/alexrj/followers","following_url":"https://api.github.com/users/alexrj/following{/other_user}","gists_url":"https://api.github.com/users/alexrj/gists{/gist_id}","starred_url":"https://api.github.com/users/alexrj/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/alexrj/subscriptions","organizations_url":"https://api.github.com/users/alexrj/orgs","repos_url":"https://api.github.com/users/alexrj/repos","events_url":"https://api.github.com/users/alexrj/events{/privacy}","received_events_url":"https://api.github.com/users/alexrj/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":1,"created_at":"2017-10-05T13:52:17Z","updated_at":"2018-02-14T17:27:00Z","closed_at":"2018-02-14T17:27:00Z","author_association":"OWNER","body":"README instructs users to add the following lines to the project's conf.py:\r\n\r\n```ruby\r\nimport sphinx_rtd_theme\r\nhtml_theme = \"sphinx_rtd_theme\"\r\nhtml_theme_path = [sphinx_rtd_theme.get_html_theme_path()]\r\n```\r\n\r\nHowever this only applies to local builds, while RTD builds lack the `<link>` tags for the theme stylesheets. It looks like the following code is needed as well (see the [design-doc conf.py](https://github.com/italia/design-doc/blob/238ff56d7186a0a32431780e8ed8110c2855c69c/conf.py#L84-L94)):\r\n\r\n```ruby\r\nif not on_rtd:  # only import and set the theme if we're building docs locally\r\n    html_theme = 'sphinx_italia_theme'\r\n    html_theme_path = [\"_themes\", ]\r\nelse:\r\n    # Override default css to get a larger width for ReadTheDoc build\r\n    html_context = {\r\n        'css_files': [\r\n            '_static/css/theme.css',\r\n            '_static/css/custom.css',\r\n        ],\r\n    }\r\n```\r\n\r\nA sample conf.py should be included in this repository (like in the newer https://github.com/italia/docs-italia-theme) and/or the README should be updated."}}
{"actor":{"display_login":"pdavide"}}