Pressbooks 5: Developer Guide

No, keep using <h1> elements for section headings within your chapters. That is correct. See:

http://oreillymedia.github.io/HTMLBook/#_sections

1 Like

We will only be importing users into the Contributor list if they have write permissions within the book. So if you have subscribers, they will not be added to the contributor list.

2 Likes

@colomet:

For reference, here’s the markup a chapter will have in HTMLBook:

<section class="chapter" data-type="chapter">
  <header>
    <h1>Loomings</h1>
    <p class="author" data-type="author">Herman Melville</p>
    <p class="subtitle" data-type="subtitle">The First Chapter</p>
  </header>
  <p>Call me Ishmael.</p>
</section> 
1 Like

Thanks for the details, I assume that it may be possible to make a custom change “Preview Changes in Web” back to “Preview” ?

status-visibility

Cheers,
Steve

Possible, but the reason we changed this is to reflect that the preview we can show is of the webbook version (not PDF/EPUB output). We’ve had some user feedback that the old “Preview” button was confusing; many users of Pressbooks use it for PDF and Ebook production only and so clarifying the type of preview was a request we were responding to.

Thanks,
Preview will work better for us as it is consistent with WordPress and is an intuitive button within a web browser context. The interface for the current PB has been excellent and intuitive for blogger / e-authors. Hence, a surprise to see such a major shift in the user interface design.
cheers,
steve

Addendum - Could ‘profiles’ be used as a way to provide alternative UI (e.g. WP versus PB) ? Perhaps an extreme accommodation of divergent UI for a plugin/framework on WordPress.

Thanks for writing this all up, Ned. I’ve just finished reading it carefully, and it all looks terrific. We’re very excited for 5.0’s release. Will there be anything similar forthcoming to describe some of the planned changes to Pressbooks Themes? Your diagram in the Slack channel was invaluable,


and having a short prose narrative/documentation document like this for the theme changes would be really helpful for us. I’m happy to help contribute to documentation and contribute writing/editing skills if they’d be of use …

Hi Steel, I’m planning on writing up and sharing something about themes next week!

2 Likes

Excellent. I’m looking forward to it.

Should those hosting PB themselves expect any new dependencies to support PB 5.0? Will there be any requirements on the server or db side to support the major version change? I didn’t see this in the write-up, and so assume not – but it’s worth asking!

Etienne

The only new requirement will be that if you are using Luther (the book theme in Pressbooks Book 1.x) you will need to install it from https://github.com/pressbooks/pressbooks-luther to continue using it when you upgrade. But I will write more about this in the discussion of themes next week.

Now, looks like we have several places for the creation of people under different categories, but all of them are contributors. Is a little complicate at first.

maybe by having just one place for the creation of Contributors and then, to be able to use it from any place…

Those buttons all link to the same place.

I know. that´s the issue. Looks like we have several categories of people. Not just one.

Context: someone wants to add a new person to the “Reviewer” list. Do we make them scroll up to the top of the page to find the one link they have to use to manage all contributors, or make them use the “Contributors” sidebar menu link? The idea with having a button by each category was ease of access to the contributor list no matter what you’re currently editing. Is it too confusing? The goal was convenience.

I understand the situation. Maybe to have the same buttom name all the time, I like Contributor, as is the name of the taxonomy. So the people would understan all of them are one taxonomy. Or maybe having a neutral name…

Okay. Can you open an “Ideas” ticket about this? Thanks.

1 Like

Hi,

I’m new to this forum, but we have been using Pressbooks and developed a custom theme with it. We followed the documentation creating the scaffolding and building from there, but when we upgraded to 5 and followed the upgrade instructions the styles to our front page are no longer loaded. It looks like on read pages the compiled stylesheet now stored in the new pressbooks folder in the uploads directory gets called, but not on the front page. Also it looks like some of the icons like the eyeball for increasing reading size as well as the javascript file for toc.js is no longer being loaded. We also see some various errors in the book.js file. Is there a web page that talks about any new styling caveats that are present with this new release of Pressbooks? If not can anyone help point me in the direction of what we would need to get the styles also called on the front page of the book?

@kirkj I’ve moved your question into a new thread, and will follow up with you there: Issues with custom theme and Pressbooks 5