stephrieger
Level 1 (0 points)

Q: Reserved words in .ncx navmap?

Hello,

Is there documentation somewhere regarding reserved words that cannot be used in the .ncx navmap declaration. We've noticed that if any of the navpoint text strings includes the words "contents" or "cover" iBooks doesn't display them at all (it skips that navpoint item and moves onto the next).

 

Are there any other words that the platform will skip over if used?

iBook

Posted on Dec 23, 2012 5:56 AM

Close
stephrieger

Q: Reserved words in .ncx navmap?

  • All replies
  • Helpful answers

  • by Read Along Publishing,

    Read Along Publishing Read Along Publishing Jan 2, 2013 4:51 AM in response to stephrieger
    Level 1 (5 points)
    Jan 2, 2013 4:51 AM in response to stephrieger

    Hi Stephrieger,

     

    That's an interesting problem that isn't covered in the documentation. I'm also curious to know if any other words are reserved by the system.

     

    It's best practice to avoid using reserved words in most if not all programming languages to avoid "unexpected" behavior.

     

    Simple solution would be to prefix all pages with "pg_" then the name you want to assign them.

     

    Do let us know if you find out the list of reserved words.

     

    Seb

  • by stephrieger,

    stephrieger stephrieger Jan 2, 2013 4:58 AM in response to Read Along Publishing
    Level 1 (0 points)
    Jan 2, 2013 4:58 AM in response to Read Along Publishing

    Thanks for the reply.

     

    Sadly (I wasn't specific enough) the words are not in mark-up, they are the ones that users can see...the actual <text> string used to generate the words in the menu. So prefacing them with pg_ would confuse users. :-(

     

    Will update the thread further if I figure out a workaround!

  • by Read Along Publishing,

    Read Along Publishing Read Along Publishing Jan 2, 2013 2:27 PM in response to stephrieger
    Level 1 (5 points)
    Jan 2, 2013 2:27 PM in response to stephrieger

    I understand now.

     

    I have done a few tests and can see your problem, where reserved words are used the entire navpoint is hidden. I tried wrapping the text in a CDATA tag to see if that would help eg. <text><![CDATA["Contents"]]></text> as the parser should ignore what's inside, however rather than the navpoint disappearing it's there but now blank.

     

    Let us know if you come across a workaround it would be good to know.

     

    Seb