{"action":"created","issue":{"url":"https://api.github.com/repos/jgm/pandoc/issues/1720","labels_url":"https://api.github.com/repos/jgm/pandoc/issues/1720/labels{/name}","comments_url":"https://api.github.com/repos/jgm/pandoc/issues/1720/comments","events_url":"https://api.github.com/repos/jgm/pandoc/issues/1720/events","html_url":"https://github.com/jgm/pandoc/issues/1720","id":46820991,"number":1720,"title":"(enhancement) proposal for footnotes","user":{"login":"ousia","id":203767,"avatar_url":"https://avatars.githubusercontent.com/u/203767?v=3","gravatar_id":"","url":"https://api.github.com/users/ousia","html_url":"https://github.com/ousia","followers_url":"https://api.github.com/users/ousia/followers","following_url":"https://api.github.com/users/ousia/following{/other_user}","gists_url":"https://api.github.com/users/ousia/gists{/gist_id}","starred_url":"https://api.github.com/users/ousia/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ousia/subscriptions","organizations_url":"https://api.github.com/users/ousia/orgs","repos_url":"https://api.github.com/users/ousia/repos","events_url":"https://api.github.com/users/ousia/events{/privacy}","received_events_url":"https://api.github.com/users/ousia/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/jgm/pandoc/labels/enhancement","name":"enhancement","color":"d7e102"},{"url":"https://api.github.com/repos/jgm/pandoc/labels/More%20discussion%20needed","name":"More discussion needed","color":"009800"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2014-10-25T19:24:30Z","updated_at":"2015-04-10T02:47:54Z","closed_at":null,"body":"Similar to #1612, I think it would be interesting that the user were able to place footnotes in the document.\r\n\r\nMy proposal doesn’t intend to change the default way footnotes are handled. It is an improvement, optional for the user to deploy.\r\n\r\nRight now, footnotes in HTML documents are placed at the end of the first level section, such as in:\r\n\r\n```\r\n---\r\ntitle: Footnotes\r\n...\r\n\r\n# Chapter One\r\n\r\n^[footnote one]\r\n\r\n# Chapter Two\r\n\r\n^[footnote two]\r\n\r\n# Chapter Three\r\n\r\n^[footnote three]\r\n\r\n# Chapter Four\r\n\r\n^[footnote four]\r\n\r\n# Chapter Five\r\n\r\n^[footnote five]\r\n```\r\n\r\nHow about being able to add a first–level title that places all footnotes in the document at the given location?\r\n\r\nA minimal sample would be:\r\n\r\n```\r\n# footnotes\r\n```\r\n\r\nSimilar to the table of contents, harcoding a title for footnotes should be avoided. The ttitle for footnotes could be specified as a YAML field, such as in:\r\n\r\n```\r\n---\r\nfootnotes: Notas\r\n....\r\n```\r\n\r\nAnother way to implement it would be to use a first–level title that contains an special identifier, such as in:\r\n\r\n```\r\n# Notas {#footnotes #notas .hidden}\r\n```\r\n\r\nTwo important remarks for both approaches:\r\n\r\n1. Other attributes than the `#footnotes` identifier should be allowed in the title for footnotes.\r\n\r\n1. If there is some text—whatever it comes before the next first–level title—in the section for footnotes, it should be placed after the title and before the footnotes themselves. Sometimes these passages are useful to explain relevant information about the footnotes.\r\n"},"comment":{"url":"https://api.github.com/repos/jgm/pandoc/issues/comments/91409974","html_url":"https://github.com/jgm/pandoc/issues/1720#issuecomment-91409974","issue_url":"https://api.github.com/repos/jgm/pandoc/issues/1720","id":91409974,"user":{"login":"lierdakil","id":7275622,"avatar_url":"https://avatars.githubusercontent.com/u/7275622?v=3","gravatar_id":"","url":"https://api.github.com/users/lierdakil","html_url":"https://github.com/lierdakil","followers_url":"https://api.github.com/users/lierdakil/followers","following_url":"https://api.github.com/users/lierdakil/following{/other_user}","gists_url":"https://api.github.com/users/lierdakil/gists{/gist_id}","starred_url":"https://api.github.com/users/lierdakil/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lierdakil/subscriptions","organizations_url":"https://api.github.com/users/lierdakil/orgs","repos_url":"https://api.github.com/users/lierdakil/repos","events_url":"https://api.github.com/users/lierdakil/events{/privacy}","received_events_url":"https://api.github.com/users/lierdakil/received_events","type":"User","site_admin":false},"created_at":"2015-04-10T02:47:54Z","updated_at":"2015-04-10T02:47:54Z","body":"Relevant pandoc-discuss thread: <https://groups.google.com/forum/#!topic/pandoc-discuss/HxmpFK-Ydus>"}}