{"action":"created","issue":{"url":"https://api.github.com/repos/choderalab/opentis/issues/122","labels_url":"https://api.github.com/repos/choderalab/opentis/issues/122/labels{/name}","comments_url":"https://api.github.com/repos/choderalab/opentis/issues/122/comments","events_url":"https://api.github.com/repos/choderalab/opentis/issues/122/events","html_url":"https://github.com/choderalab/opentis/pull/122","id":55391262,"number":122,"title":"[WIP] Additional Documentation and Utils","user":{"login":"jhprinz","id":5091934,"avatar_url":"https://avatars.githubusercontent.com/u/5091934?v=3","gravatar_id":"","url":"https://api.github.com/users/jhprinz","html_url":"https://github.com/jhprinz","followers_url":"https://api.github.com/users/jhprinz/followers","following_url":"https://api.github.com/users/jhprinz/following{/other_user}","gists_url":"https://api.github.com/users/jhprinz/gists{/gist_id}","starred_url":"https://api.github.com/users/jhprinz/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jhprinz/subscriptions","organizations_url":"https://api.github.com/users/jhprinz/orgs","repos_url":"https://api.github.com/users/jhprinz/repos","events_url":"https://api.github.com/users/jhprinz/events{/privacy}","received_events_url":"https://api.github.com/users/jhprinz/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-01-25T01:11:07Z","updated_at":"2015-01-25T01:47:21Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/choderalab/opentis/pulls/122","html_url":"https://github.com/choderalab/opentis/pull/122","diff_url":"https://github.com/choderalab/opentis/pull/122.diff","patch_url":"https://github.com/choderalab/opentis/pull/122.patch"},"body":"Added a sphinx extension that allows to import a markdown file at any place in the documentation.\r\nSimply use\r\n```\r\n.. markdown: [markdown_file.md]\r\n```\r\nand the file will be converted using pandoc intop rst and then added to the documentation"},"comment":{"url":"https://api.github.com/repos/choderalab/opentis/issues/comments/71346505","html_url":"https://github.com/choderalab/opentis/pull/122#issuecomment-71346505","issue_url":"https://api.github.com/repos/choderalab/opentis/issues/122","id":71346505,"user":{"login":"jhprinz","id":5091934,"avatar_url":"https://avatars.githubusercontent.com/u/5091934?v=3","gravatar_id":"","url":"https://api.github.com/users/jhprinz","html_url":"https://github.com/jhprinz","followers_url":"https://api.github.com/users/jhprinz/followers","following_url":"https://api.github.com/users/jhprinz/following{/other_user}","gists_url":"https://api.github.com/users/jhprinz/gists{/gist_id}","starred_url":"https://api.github.com/users/jhprinz/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jhprinz/subscriptions","organizations_url":"https://api.github.com/users/jhprinz/orgs","repos_url":"https://api.github.com/users/jhprinz/repos","events_url":"https://api.github.com/users/jhprinz/events{/privacy}","received_events_url":"https://api.github.com/users/jhprinz/received_events","type":"User","site_admin":false},"created_at":"2015-01-25T01:47:21Z","updated_at":"2015-01-25T01:47:21Z","body":"Hi... Why are you awake? Isn't it like in the middle of the night?\r\nBut...\r\n\r\nYes, I just used the nice template from mdtraj for including ipython notebooks nicely. This uses pandoc and just calls it to convert a file and kind of then assumes that this .rst code is independent of the code and include it. You cannot really connect to things in the code yet. I would need to figure out on how to do the linking correctly although I assume it is trivial once I know how to do it.\r\n\r\nConcerning your question: The name is right now independent is always assumes that it is markdown, but it can easily extended to use all types of documents that are supported by pandoc, which apparently is a lot. I think there is also a way to use equations. It says it supports mediawiki markdown, etc...\r\n\r\nWhat about changing the syntax to the way you suggested\r\n```\r\n.. pandoc: markdown xyz.md\r\n.. pandoc: mediawiki \r\n```\r\nThat would make it usable very general"}}