{"action":"created","issue":{"url":"https://api.github.com/repos/TEIC/TEI/issues/1431","repository_url":"https://api.github.com/repos/TEIC/TEI","labels_url":"https://api.github.com/repos/TEIC/TEI/issues/1431/labels{/name}","comments_url":"https://api.github.com/repos/TEIC/TEI/issues/1431/comments","events_url":"https://api.github.com/repos/TEIC/TEI/issues/1431/events","html_url":"https://github.com/TEIC/TEI/issues/1431","id":131032660,"number":1431,"title":"clarify how to encode short-form citations","user":{"login":"kshawkin","id":538464,"avatar_url":"https://avatars.githubusercontent.com/u/538464?v=3","gravatar_id":"","url":"https://api.github.com/users/kshawkin","html_url":"https://github.com/kshawkin","followers_url":"https://api.github.com/users/kshawkin/followers","following_url":"https://api.github.com/users/kshawkin/following{/other_user}","gists_url":"https://api.github.com/users/kshawkin/gists{/gist_id}","starred_url":"https://api.github.com/users/kshawkin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kshawkin/subscriptions","organizations_url":"https://api.github.com/users/kshawkin/orgs","repos_url":"https://api.github.com/users/kshawkin/repos","events_url":"https://api.github.com/users/kshawkin/events{/privacy}","received_events_url":"https://api.github.com/users/kshawkin/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":4,"created_at":"2016-02-03T13:53:58Z","updated_at":"2016-02-03T17:37:30Z","closed_at":null,"body":"The Guidelines say that you should \"distinguish between a bibliographic reference, which is a self-sufficient description of a bibliographic item, and a bibliographic pointer, which is a short-form citation (e.g. Baxter, 1983)\" ( http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CO.html#COBITY ).  Just before this statement, the Guidelines give an example of such a short-form citation:\r\n\r\n```\r\n<bibl>Baxter, 1983</bibl>\r\n```\r\n\r\nBut then the Guidelines go on to say, \"The usual encoding of short-form references such as Baxter, 1983 is not as bibl elements but as cross-references to such elements; see section 3.11.3 Bibliographic Pointers below.\"  In that section ( http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CO.html#COBIXR ), there are examples using ptr and ref.  Here's one that involves a page range:\r\n\r\n```\r\nNelson claims (<ref target=\"#NEL80\">Nelson [1980]</ref> pages 13–37)\r\n```\r\n\r\nUnfortunately, the page range here is not tagged.  However, as explained in a posting on TEI-L ( https://listserv.brown.edu/archives/cgi-bin/wa?A2=TEI-L;4eddd8d3.1602 ), there is a use case for being able to extract the page range.\r\n\r\nTo confuse things more, the element specification for citedRange ( http://www.tei-c.org/release/doc/tei-p5-doc/en/html/ref-citedRange.html ) gives the following example:\r\n\r\n```\r\n<bibl>\r\n <ptr target=\"#mueller01\"/>, <citedRange target=\"http://example.com/mueller3.xml#page4\">vol. 3, pp.\r\n   4-5</citedRange>\r\n</bibl>\r\n```\r\n\r\nThe Guidelines should be clearer on the recommended way to accomplish this.  In particular:\r\n\r\na) Should the whole short-form citation be wrapped in a bibl?\r\nb) Should citedRange be used for the page range?"},"comment":{"url":"https://api.github.com/repos/TEIC/TEI/issues/comments/179365353","html_url":"https://github.com/TEIC/TEI/issues/1431#issuecomment-179365353","issue_url":"https://api.github.com/repos/TEIC/TEI/issues/1431","id":179365353,"user":{"login":"laurentromary","id":5230831,"avatar_url":"https://avatars.githubusercontent.com/u/5230831?v=3","gravatar_id":"","url":"https://api.github.com/users/laurentromary","html_url":"https://github.com/laurentromary","followers_url":"https://api.github.com/users/laurentromary/followers","following_url":"https://api.github.com/users/laurentromary/following{/other_user}","gists_url":"https://api.github.com/users/laurentromary/gists{/gist_id}","starred_url":"https://api.github.com/users/laurentromary/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/laurentromary/subscriptions","organizations_url":"https://api.github.com/users/laurentromary/orgs","repos_url":"https://api.github.com/users/laurentromary/repos","events_url":"https://api.github.com/users/laurentromary/events{/privacy}","received_events_url":"https://api.github.com/users/laurentromary/received_events","type":"User","site_admin":false},"created_at":"2016-02-03T17:37:30Z","updated_at":"2016-02-03T17:37:30Z","body":"I have the feeling that enforcing `<bibl>` where`<ref>` used to be used is quite a break in backward compatibility. I would suggest to focus on better documenting (exemples) `<citeRange>`"}}