Pagelist plugin for print edition page numbers

[Doitsu]

Originally Posted by Terry Brown

Is there something else I need to do to make the page numbers show up?

AFAIK, printed page numbers only work in epub3 books. If your book is an epub2 book, you'll have to convert it to an epub3 book with the ePub3-itizer plugin.

If your book is an epub3 book, maybe the pagelist section in the Nav doc is missing, doesn't contain pagelist entries or the page number definitions point to the wrong target ids.

You might want to check your book with my EPUBCheck plugin, if you haven't already done so.

If EPUBCheck doesn't report any broken links, download this very simple MR epub3 book with a working pagelist section and compare the pagelist section and the page target definitions with your book.

[tastytea]

Hi, thanks for your plugin!
I have a book that records page numbers like this:

<span role="doc-pagebreak" id="pg_13" aria-label="13">

Changing PageList.json to:

{
  "tag": "span",
  "attribute": "role",
  "value": "doc-pagebreak"
}

did not suffice, I also had to change plugin.py like this:

diff --git a/plugin.py b/plugin.py
index 9bf6b68..26a6863 100644
--- a/plugin.py
+++ b/plugin.py
@@ -143,6 +143,8 @@ def run(bk):
             # title has priority over string
             if page_number.has_attr('title'):
                 title = page_number['title']
+            elif page_number.has_attr('aria-label'):
+                title = page_number['aria-label']
             else:
                 title = page_number.string

Could you add that to your plugin?

[Doitsu]

Originally Posted by tastytea

Could you add that to your plugin?

Thanks for the suggestion! I added the two lines to plugin.py and attached a new version to the first post.

[m8cb0y]

Hello, I tried your plugin on an epub I have. The <pageList> section is getting added to the ncx file but is empty. Here is what is getting added to my ncx file (python modified slightly to match existing file indentation):

  <pageList>
    <navLabel>
      <text>Paper Edition Page Mapping</text>
    </navLabel>
  </pageList>

The ebook already had anchor tags present so I did not modify the json file. Here is an example page number from my ebook:

<span epub:type="pagebreak" title="Page_8" id="Page_8" class="page-number" xmlns:epub="http://www.idpf.org/2007/ops">Page 8</span>

The plugin is identifying page number targets in the file and has found over 900 targets. However, it is not writing out the details in the pageList.

Thoughts?

[KevinH]

If epub3, the pagelist should be written to the nav.

[Doitsu]

Originally Posted by m8cb0y

Hello, I tried your plugin on an epub I have. The <pageList> section is getting added to the ncx file but is empty. Here is what is getting added to my ncx file (python modified slightly to match existing file indentation):

  <pageList>
    <navLabel>
      <text>Paper Edition Page Mapping</text>
    </navLabel>
  </pageList>

I was able to reproduce the bug and'll release an updated version soon.

[m8cb0y]

Originally Posted by Doitsu

I was able to reproduce the bug and'll release an updated version soon.

Thank you!

I can understand python just enough to recognize data structures and follow the logic, but only just. If I had more time I might be able to understand better what you are using. Probably would help better if I were more familiar with Python library functions

[m8cb0y]

Originally Posted by Doitsu

I was able to reproduce the bug and'll release an updated version soon.

I just tested the updated plugin on my eBook, worked perfectly.

My ebook uses "Page_x" for its anchor points so I needed to do a quick find/replace in the <pageList> section to remove the "Page_" from the <text> tags.

Thank you so much

[Doitsu]

I've attached an updated plugin version to the first post.

However, since the plugin will use the title attribute value instead of the string value by default, it'll write the following page list entry to the NCX file:

<pageTarget id="Page_8" type="normal" value="Page_8">
	<navLabel>
		<text>Page_8</text>
	</navLabel>
	<content src="Text/Section0001.xhtml#Page_8"/>
</pageTarget>

If you want the plugin to write the string value instead, change the following lines:

            # title has priority over string
            if page_number.has_attr('title'):
                title = page_number['title']
            elif page_number.has_attr('aria-label'):
                title = page_number['aria-label']
            else:
                title = page_number.string

to:

            # title has priority over string
            title = page_number.string

(There need to be exactly 12 spaces before each line.)

BTW, page list entries in Epub2 NCX files are usually ignored by Epub2 apps. The plugin only adds them, because some some Calibre converters will use them.
(Epub3 apps only use the NAV pagelist entries.)