{"action":"created","issue":{"url":"https://api.github.com/repos/astropy/astropy/issues/4734","repository_url":"https://api.github.com/repos/astropy/astropy","labels_url":"https://api.github.com/repos/astropy/astropy/issues/4734/labels{/name}","comments_url":"https://api.github.com/repos/astropy/astropy/issues/4734/comments","events_url":"https://api.github.com/repos/astropy/astropy/issues/4734/events","html_url":"https://github.com/astropy/astropy/pull/4734","id":143322323,"number":4734,"title":"[WIP] Add gallery of examples to documentation","user":{"login":"adrn","id":583379,"avatar_url":"https://avatars.githubusercontent.com/u/583379?v=3","gravatar_id":"","url":"https://api.github.com/users/adrn","html_url":"https://github.com/adrn","followers_url":"https://api.github.com/users/adrn/followers","following_url":"https://api.github.com/users/adrn/following{/other_user}","gists_url":"https://api.github.com/users/adrn/gists{/gist_id}","starred_url":"https://api.github.com/users/adrn/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adrn/subscriptions","organizations_url":"https://api.github.com/users/adrn/orgs","repos_url":"https://api.github.com/users/adrn/repos","events_url":"https://api.github.com/users/adrn/events{/privacy}","received_events_url":"https://api.github.com/users/adrn/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/astropy/astropy/labels/Docs","name":"Docs","color":"02d7e1"},{"url":"https://api.github.com/repos/astropy/astropy/labels/Experimental","name":"Experimental","color":"fbca04"}],"state":"open","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/astropy/astropy/milestones/26","html_url":"https://github.com/astropy/astropy/milestones/v1.2.0","labels_url":"https://api.github.com/repos/astropy/astropy/milestones/26/labels","id":1114049,"number":26,"title":"v1.2.0","description":"","creator":{"login":"astrofrog","id":314716,"avatar_url":"https://avatars.githubusercontent.com/u/314716?v=3","gravatar_id":"","url":"https://api.github.com/users/astrofrog","html_url":"https://github.com/astrofrog","followers_url":"https://api.github.com/users/astrofrog/followers","following_url":"https://api.github.com/users/astrofrog/following{/other_user}","gists_url":"https://api.github.com/users/astrofrog/gists{/gist_id}","starred_url":"https://api.github.com/users/astrofrog/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/astrofrog/subscriptions","organizations_url":"https://api.github.com/users/astrofrog/orgs","repos_url":"https://api.github.com/users/astrofrog/repos","events_url":"https://api.github.com/users/astrofrog/events{/privacy}","received_events_url":"https://api.github.com/users/astrofrog/received_events","type":"User","site_admin":false},"open_issues":49,"closed_issues":95,"state":"open","created_at":"2015-05-17T16:11:47Z","updated_at":"2016-05-10T21:18:36Z","due_on":null,"closed_at":null},"comments":10,"created_at":"2016-03-24T18:19:29Z","updated_at":"2016-05-10T21:27:00Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/astropy/astropy/pulls/4734","html_url":"https://github.com/astropy/astropy/pull/4734","diff_url":"https://github.com/astropy/astropy/pull/4734.diff","patch_url":"https://github.com/astropy/astropy/pull/4734.patch"},"body":"*Work in progress*\r\n\r\nThis is the result of [discussions at Python in Astronomy 2016](https://docs.google.com/document/d/1oY9iuMiWp15XCYCx5PEUnPGD5W3ge9X8aiqxofiWVHw/edit) about the state of [astropy-tutorials](https://github.com/astropy/astropy-tutorials). We decided to implement a trial version of a [sphinx-gallery](https://github.com/sphinx-gallery/sphinx-gallery) of examples in the astropy documentation similar to the scikit-learn [examples gallery](http://scikit-learn.org/stable/auto_examples/index.html). \r\n\r\n[Here's a live demo of the gallery in the astropy docs](http://adrian.pw/astropy/auto_examples/index.html)\r\n\r\nOutstanding issues / tasks:\r\n\r\n- [x] organize the examples by subpackage\r\n- [ ] look through the astropy documentation and see if anything should be pulled out into the example gallery:\r\n    - [x] http://docs.astropy.org/en/stable/io/fits/appendix/faq.html#how-do-i-create-a-multi-extension-fits-file-from-scratch\r\n    - [x] http://docs.astropy.org/en/stable/io/fits/appendix/faq.html#how-do-i-open-a-very-large-image-that-won-t-fit-in-memory\r\n    - [x] http://docs.astropy.org/en/stable/coordinates/observing-example.html\r\n    - [x] http://docs.astropy.org/en/stable/coordinates/sgr-example.html\r\n    - [ ] One of the simple model-fitting examples from astropy.modeling main page\r\n\r\nSome strange issues with sphinx-gallery:\r\n\r\n- [x] There seems to be extra indentation for the first line of code when output has multiple lines (see: sphinx-gallery/sphinx-gallery#109 (~~opened~~ merged a PR to fix: sphinx-gallery/sphinx-gallery#111) \r\n- [x] ~~Mouseover for gallery thumbnails doesn't always show the name of the example (not going to be fixed before this PR is merged)~~ (seems to be resolved)\r\n- [x] There doesn't seem to be a way to choose the thumbnail image for an example that generates multiple figures sphinx-gallery/sphinx-gallery#110 (~~opened~~ merged a PR to fix: sphinx-gallery/sphinx-gallery#114)\r\n\r\nTODO items to be handled after this PR:\r\n\r\n- When sphinx-gallery 0.1.3 or 0.2 is released, use the new thumbnail image selection feature to show the 2nd plot from the observing example.\r\n- Replace the default sphinx-gallery placeholder image (this requires adding the functionality to sphinx-gallery)\r\n- Some functions resolve automatically to API links, some don't...This is a known issue and needs to be fixed in sphinx-gallery (sphinx-gallery/sphinx-gallery#113) \r\n\r\ncc @kelle "},"comment":{"url":"https://api.github.com/repos/astropy/astropy/issues/comments/218296952","html_url":"https://github.com/astropy/astropy/pull/4734#issuecomment-218296952","issue_url":"https://api.github.com/repos/astropy/astropy/issues/4734","id":218296952,"user":{"login":"adrn","id":583379,"avatar_url":"https://avatars.githubusercontent.com/u/583379?v=3","gravatar_id":"","url":"https://api.github.com/users/adrn","html_url":"https://github.com/adrn","followers_url":"https://api.github.com/users/adrn/followers","following_url":"https://api.github.com/users/adrn/following{/other_user}","gists_url":"https://api.github.com/users/adrn/gists{/gist_id}","starred_url":"https://api.github.com/users/adrn/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/adrn/subscriptions","organizations_url":"https://api.github.com/users/adrn/orgs","repos_url":"https://api.github.com/users/adrn/repos","events_url":"https://api.github.com/users/adrn/events{/privacy}","received_events_url":"https://api.github.com/users/adrn/received_events","type":"User","site_admin":false},"created_at":"2016-05-10T21:26:59Z","updated_at":"2016-05-10T21:26:59Z","body":"Oh right - sorry I thought I remembered seeing a 1.1.3 release. oops!"}}