Answers.Body: <p>I am looking at the excellent book EPUB 3 BEST PRACTICES by Matt Garrish and Markus Grylling in the section "Page Numbering." </p>
  
  <p>First, we need to describe what the function of the <code>&lt;nav epub:type="page-list" ..&gt;</code> element is supposed to do. Some reading systems  (specifically Readium) have the ability to search specifically by page number (presumably printed page number). IN Garrish's book this feature is called  "page jump functionality." </p>
  
  <p>Only if a reading system provides this functionality, then it would be helpful to include an ordered list within the nav "page-list" type. So nav epub.page-list is an optional method for providing an alternate navigation/search method. </p>
  
  <p><strong>Important:</strong> the only constraint on page-list type is that it must contain an ordered list. For this reason, the semantics for LI are interchangeable; there's no special requirements or constraints on the value. If the writers of the standard wanted to constrain the values of the ordered list items, they would have created an additional unique element with the nav page-list element.   </p>
  
  <p>So yes, these references are arbitrary -- you could use letters of the alphabet, Roman numerals; it does not matter. </p>
  
  <p>Later the book mentions providing anchors for page numbering. </p>
  
  <pre><code>&lt;span
           epub:type="pagebreak"
           id="page24"
           title="24"/&gt;
     …
  </code></pre>
  
  <p>Presumably for the example you used, you would switch <strong>id=page752</strong> on the georgia.xhtml page. </p>
  
  <p>(The book also describes the pros and cons of using css to show/hide these page indicators throughout the text). </p>
  
  <p>A few things worth noting: First, I don't even know which reading systems support this feature of search by page number. Second, I am skeptical about whether this is implemented on Kindles (I could be wrong...) Third, I suspect the ideal way  to implement references to printed pages is by letting a tool like Adobe Indesign auto-generate these things. </p>
  
Answers.ContentLicense: CC BY-SA 3.0
Answers.CreationDate: 2016-08-31T05:07:02.980Z
Answers.LastActivityDate: 2016-08-31T05:07:02.980Z
Answers.UserDisplayName: idiotprogrammer
Body: <p>In the <a href="http://www.daisy.org/z3986/2005/Z3986-2005.html#li_392a" rel="nofollow">epub2 spec for page numbers</a>, the <code>pageList</code> element is supposed to contain some <code>pageTarget</code> elements that have, among other attributes, a <code>value</code> that is supposed to be a positive integer.</p>
  
  <p>The epub3 equivalent seems to be the <code>page-list</code> element (<a href="https://idpf.github.io/a11y-guidelines/content/nav/pagelist.html" rel="nofollow">example</a>, <a href="http://www.idpf.org/epub/301/spec/epub-contentdocs.html#sec-xhtml-nav-def-types-pagelist" rel="nofollow">spec</a>). But I don't see any guidelines as to what to expect in the <code>page-list</code>. The example lists something like this:</p>
  
  <pre><code>&lt;nav epub:type="page-list"&gt;
   &lt;ol&gt;
    &lt;li&gt;&lt;a href="georgia.xhtml#page752"&gt;752&lt;/a&gt;&lt;/li&gt; 
   &lt;/ol&gt;
  &lt;/nav&gt;
  </code></pre>
  
  <p>Should the content of the <code>a</code> element in the <code>li</code> be expected to be numeric? If so, where is this documented? If not, are there any constraints? Should it be expected to correspond to what one would see in the corner of a print page, i.e. either a number or a roman numeral in preface content? If so, where is this documented?</p>
  
Tags: <epub><page-break>
Title: What is the expected content of a child of a page-list in epub3?
UserDisplayName: Tom Hamming
ThreadText: # What is the expected content of a child of a page-list in epub3?
  
  (Asked by: username_0 on 2016-08-29)
  
  In the epub2 spec for page numbers, the pageList element is supposed to contain some pageTarget elements that have, among other attributes, a value that is supposed to be a positive integer.
  The epub3 equivalent seems to be the page-list element (example, spec). But I don't see any guidelines as to what to expect in the page-list. The example lists something like this:
  
   
    752 
   
  
  
  Should the content of the a element in the li be expected to be numeric? If so, where is this documented? If not, are there any constraints? Should it be expected to correspond to what one would see in the corner of a print page, i.e. either a number or a roman numeral in preface content? If so, where is this documented?
  
  **Tags:** epub, page-break
  
  
  ---
  
  ## 1 answers
  
  ### Answer by username_1 on 2016-08-31. Score: 2
  
  I am looking at the excellent book EPUB 3 BEST PRACTICES by Matt Garrish and Markus Grylling in the section "Page Numbering." 
  First, we need to describe what the function of the  element is supposed to do. Some reading systems  (specifically Readium) have the ability to search specifically by page number (presumably printed page number). IN Garrish's book this feature is called  "page jump functionality." 
  Only if a reading system provides this functionality, then it would be helpful to include an ordered list within the nav "page-list" type. So nav epub.page-list is an optional method for providing an alternate navigation/search method. 
  Important: the only constraint on page-list type is that it must contain an ordered list. For this reason, the semantics for LI are interchangeable; there's no special requirements or constraints on the value. If the writers of the standard wanted to constrain the values of the ordered list items, they would have created an additional unique element with the nav page-list element.   
  So yes, these references are arbitrary -- you could use letters of the alphabet, Roman numerals; it does not matter. 
  Later the book mentions providing anchors for page numbering. 
  
     …
  
  Presumably for the example you used, you would switch id=page752 on the georgia.xhtml page. 
  (The book also describes the pros and cons of using css to show/hide these page indicators throughout the text). 
  A few things worth noting: First, I don't even know which reading systems support this feature of search by page number. Second, I am skeptical about whether this is implemented on Kindles (I could be wrong...) Third, I suspect the ideal way  to implement references to printed pages is by letting a tool like Adobe Indesign auto-generate these things.
  
  
  ---
  
  