Skip to content

Homepage Update - #314

Open
JohannesSeikowsky wants to merge 41 commits into
devfrom
homepage-update
Open

Homepage Update#314
JohannesSeikowsky wants to merge 41 commits into
devfrom
homepage-update

Conversation

@JohannesSeikowsky

@JohannesSeikowsky JohannesSeikowsky commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

Homepage design update. See Screenshots in the comments.

The goal was to make the page cleaner, nicer, less wordy, more modern and most importantly much better at leading users into the experience of actively browsing for books on PG.

Many things have been updated. Some of the more important:

  • Slogan and Sub-slogan tightened - shorter and punchier.
  • trust badges added - 100% free / No registration / No app required
  • Nicer design for Most Popular and New Releases carousels.
  • Most Popular carousel comes first. Homepage should be good at converting people who stumble upon PG randomly into active users. "Most Popular" books are just way more powerful at signalling that we have some genuinely good stuff. "New Releases" still very visible just not top position.
  • Categories shown as an icon grid (inline SVGs, no emoji)
  • Collapsed the old wall of link lists (Get Help, Get Involved, Audio Books, Special Areas) into a single accordion. much more efficient and much less ugly.
  • lead statement card added about Project Gutenberg with Learn more / Donate buttons.
  • Follow Us redesigned as labelled social buttons (Facebook, Mastodon, Bluesky). Tidier and more usable.

Notes:

  • Only two files changed: site/index.md and gutenberg/gutenberg-globals.css.
  • Tablet and mobile are handled
  • CSS changes are scoped to the homepage

@JohannesSeikowsky

Copy link
Copy Markdown
Contributor Author
Screenshot_2026-06-25_16-37-14

@JohannesSeikowsky

Copy link
Copy Markdown
Contributor Author
Screenshot_2026-06-25_16-37-23

@JohannesSeikowsky

Copy link
Copy Markdown
Contributor Author
Screenshot_2026-06-25_16-37-34

@eshellman

Copy link
Copy Markdown
Collaborator

There are some good ideas here, easy to adopt, as well as other changes that user will DETEST! Is it possible to segment this PR into a few manageable pieces? Even if everything is eventually adopted, gradual change is easier for users to accept.

For example, putting New Releases below the fold will alienate regular users, who return to the homepage mostly to see new releases.

It is VERY important that the word "library" appears in the "slogan". We do not want to look like a run-of-the-mill pirate free ebook site.

@tangledhelix

Copy link
Copy Markdown
Member

Suggestion: share also mobile screenshots. The world is increasingly mobile first as people continue to shift away from desktops and laptops and toward phones and tablets.

@JohannesSeikowsky

Copy link
Copy Markdown
Contributor Author

At 435px screen width:

Screenshot_2026-06-26_00-46-25 Screenshot_2026-06-26_00-46-34 Screenshot_2026-06-26_00-46-44 Screenshot_2026-06-26_00-46-53 Screenshot_2026-06-26_00-47-06

@JohannesSeikowsky

JohannesSeikowsky commented Jun 25, 2026

Copy link
Copy Markdown
Contributor Author

Putting "Library" into the slogan sounds fine to me. In the spirit of more graduality we could ship the first version with "New Releases" still as the first carousel. I'll adjust the PR with these changes once I find the time. I don't think more segmentation is necessary - all other parts of this update are clear and unsurprising and in my opinion plainly better in terms of UI/UX than the status quo.

I'd then suggest to switch the carousels in a few weeks time so that "Most Popular" goes first. Yes, some people will dislike it. However one of the most important jobs of a homepage is to convert/attract web users that somehow land on the page. Getting new users that is. And having those people see "Moby Dick, "Frankenstein", "Alice in Wonderland" etc. in the top carousel is just WAY more powerful than a few books that usually only few people have ever heard of ("New Releases"). The "New Releases" will be one scroll away for the others. Not a big price to pay for that benefit.

@JohannesSeikowsky

Copy link
Copy Markdown
Contributor Author

Updated.
Screenshot_2026-06-28_20-12-06

@JohannesSeikowsky

Copy link
Copy Markdown
Contributor Author

added background for carousels back in. better that way. color lighter and nicer than status quo.

Screenshot_2026-06-29_00-18-48

@eshellman

Copy link
Copy Markdown
Collaborator

It would not be hard to have an exact number instead of "78,000+", since the book panels are generated from autocat3, which does a count query on a timer.

@JohannesSeikowsky

JohannesSeikowsky commented Jun 30, 2026

Copy link
Copy Markdown
Contributor Author

I like that idea. will give it a try. If it's easy, we can include it right away. If it turns out to be fiddly, I suggest we do it as a separate follow up PR, so we can start testing this PR earlier rather than later on dev

@JohannesSeikowsky

Copy link
Copy Markdown
Contributor Author

Implemented ebook counter as suggested using the same pattern as the cover shelves (committed placeholder + CI copy + gitignored prod-generated file). Remaining work is in autocat3 — coming up soon.

@eshellman

Copy link
Copy Markdown
Collaborator

iirc, to call to autocat3 is done in the (dev|prod)-jekyll.sh script (I think it's ins ebookconverter)

@eshellman

eshellman commented Jul 3, 2026

Copy link
Copy Markdown
Collaborator

First, a general comment about the purpose of our homepage.

  1. we don't run ads, so the type of user we want to design for is the user who come back on a regular basis. Those are the users who support us, who pay for our expenses. To do that, we need to present a page that is new every day, a page that rewards the returning user immediately. That's why the "new releases" carousel is the most important for us to show up top, "above the fold". It's also why the running count will be great to have in the slogan.
  2. The purpose of the organization is "to preserve and distribute public domain books". And that mission applies broadly, not just to the top 100 books. The first text that a user reads needs to express that. If a user don't want to read old books, we can't help them much. We get enough support questions like "Could you add Harry Potter in Translation?" as it is.

Now, a point by point review of the changes:

Slogan and Sub-slogan tightened - shorter and punchier.

"79,123" will be punchier than "over 75,000" - good change.
I like removing "eBook and Kindle".
"with focus on older works for which U.S. copyright has expired." is a bit wordy, but the info should remain.
"diligently" always bothered me

trust badges added - 100% free / No registration / No app required

These "trust badges" are all negative attributes. The way we had them before is appropriately down the page.
"No app required" will be dissonant with the message we will be emphasizing later in the year: "available in apps!"
Also, regular users are already sold on this, no need pound it in. the "trust badges" push the most dynamic content below the fold on smaller screens (like mine!)

Nicer design for Most Popular and New Releases carousels.

This is a good improvement

Most Popular carousel comes first. Homepage should be good at converting people who stumble upon PG randomly into active users. "Most Popular" books are just way more powerful at signalling that we have some genuinely good stuff. "New Releases" still very visible just not top position.

See discussion above.

Categories shown as an icon grid (inline SVGs, no emoji)

I like the icon grid.
The "Categories Browse All" heading seems unconnected to the icon grid (I'm using a phone)

Collapsed the old wall of link lists (Get Help, Get Involved, Audio Books, Special Areas) into a single accordion. much more efficient and much less ugly.

I like this idea.

lead statement card added about Project Gutenberg with Learn more / Donate buttons.
I find the centered text harder to read. Otherwise nice.

I will rewrite the statement

Follow Us redesigned as labelled social buttons (Facebook, Mastodon, Bluesky). Tidier and more usable.

I like this.

I see that much of the text has switched to relative sizes, which will help with accessibility, though it makes the design task a bit more challenging.

Thanks for this work! I apologize for taking so long to do a proper review.

@JohannesSeikowsky

Copy link
Copy Markdown
Contributor Author

I think it's a mistake to not actively care about getting new users and designing that appropriately into the page (homepage and other parts). Tomorrow's regular users are today's new users. Plus, Mission statement reads "To encourage the creation and distribution of eBooks", new users are clearly part of distribution

@JohannesSeikowsky

Copy link
Copy Markdown
Contributor Author

PRs added in autocat and ebookconverter to make the ebook counter work.

@tangledhelix

Copy link
Copy Markdown
Member

I agree with Eric on the new releases being more important than the top books list. I suspect* most readers wouldn't care much about the top list. It rarely changes, and the few books at the very top (which would be what's in the carousel) are ones everyone's already heard of. New releases are (IMHO) far more interesting and indicative of the huge variety that PG has to offer.

A lot of the amazing stuff at PG is in the long tail, and the new releases carousel would make them more prominent.

Just my 2¢, but I may be an atypical reader. I've never had any motivation at all to read our most popular book (Moby Dick), if I'm being honest. But we have a lot of titles nobody's ever heard of that have been fascinating to me.

I'll leave a handful of examples of off-the-beaten-path books that, for me, are better than the most popular list.

  • 77157 - a history of the infallibility of the Catholic Popes, fascinating and not at all what I was raised to assume...
  • 74357 - a poem with a provocative name, a very sad story by a woman whose name we will never know; but PG has made sure the pointed jabs she left for those who wronged her will be preserved.
  • 73547 - I grew up reading everything H.P. Lovecraft had written and I was sure I had read it all, until this novel (his only novel-length story), published posthumously, appeared on PG.
  • 24721, 23210, 29492, 73595 - four stories by Frank Herbert not set in the Dune universe, which I suspect most readers of Frank Herbert don't know exist...

* I say suspect because I don't have data. Do we have any data to inform any of these opinions? Honest question, since I don't know.

@JohannesSeikowsky

JohannesSeikowsky commented Jul 4, 2026

Copy link
Copy Markdown
Contributor Author

"New Releases" is already back up at the top. One thing I would add though is that as of now our "New Releases" still dont have summaries. That's really not good! If any new visitor goes to the page and clicks any of those New Releases, he/she may be left with the impression that PG books just don't have summaries ... We're leading with our least well processed books in the most prominent place on the page.

@JohannesSeikowsky

JohannesSeikowsky commented Jul 15, 2026

Copy link
Copy Markdown
Contributor Author

For convenience here the latest status on larger Screens. The tablet and mobile versions look pretty much exactly how one would imagine them based on this - the top four sections compression horizontally, the parts shown in the last Screenshot align vertically in relation to each other.

Screenshot_2026-07-15_14-14-42 Screenshot_2026-07-15_14-14-50 Screenshot_2026-07-15_14-15-00

@eshellman eshellman left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. please fix conflicts!
  2. As I said previously, there is a lot to like about this design but doing a major change means that we can't gloss over the rough edges a bit at a time.
  3. I have not yet reviewed issued on small screens



/*------------------------------------*\
HOMEPAGE REDESIGN (scoped under .pgx)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I assume these 400 lines obsolete some old css?
Please clean up the file. File bloat is technical debt.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no, they are not obsolete. There is stuff that can be tightened though - I will do that as the last step once the design is actually finalized.

Comment thread site/index.md Outdated
<h1 id="slogan">A library of {% include book_count.html %} free eBooks</h1>

<p id="sub-slogan"> Choose among free epub and Kindle eBooks, download them or read them online. You will find the world's great literature here, with focus on older works for which U.S. copyright has expired. Thousands of volunteers digitized and diligently proofread the eBooks, for you to enjoy. </p>
<p class="pgx-mission">Choose free eBooks to download or read online. You will find great literature here with a focus on older works whose U.S. copyright has expired. Thousands of Project Gutenberg volunteers have digitized these books for you. </p>

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. resolve conflicts
  2. keep the existing text

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. done
  2. done, except some klunkly formulation in sub-slogan removed

Comment thread site/index.md Outdated
</div>
</div>
</div>
<ul class="pgx-trust">

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove this. It's clutter, and it moves more important stuff below the fold on mobile.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok. I don't think they're clutter, but we have bigger fish to fry here.

Comment thread site/index.md Outdated
<div class="pgx-shelf-titles">
<span class="pgx-shelf-title">New Releases</span>
</div>
<a class="pgx-shelf-more" href="/ebooks/search/?sort_order=release_date" id="more_recent" title="find more recent releases">Browse all <span aria-hidden="true">&rarr;</span></a>

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The placement of this text is confusing when the book carousel is not full width; not clear whether browse all moves the scroll box or launches a new page. maybe better to use a right arrow or a more link as the last element of the scroll.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll experiment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

better. that was a good idea.
Screenshot_2026-08-03_16-10-11

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe remove the arrow? when there's a scrollbar, the user expects more scrolling

Comment thread site/index.md Outdated
<div class="pgx-shelf-titles">
<span class="pgx-shelf-title">Categories</span>
</div>
<a class="pgx-shelf-more" href="/ebooks/categories.html" title="Browse all categories">Browse all <span aria-hidden="true">&rarr;</span></a>

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

again, the arrow is confusing because "categories" is left out of the anchor text.

Comment thread site/index.md Outdated
<p class="pgx-lead-text"><strong>Project Gutenberg is the world's oldest digital library.</strong> Michael Hart started the Project in 1971. Today it is a nonprofit sustained entirely by volunteers who digitize and proofread works of literature as they enter the public domain, keeping them free for everyone, everywhere. We charge nothing, run no ads and never will. Donations are what keep our servers running.</p>
<div class="pgx-lead-links">
<a class="pgx-btn pgx-btn-secondary" href="/about/">Learn more</a>
<a class="pgx-btn pgx-btn-secondary pgx-btn-donate" href="/donate/">Donate</a>

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why is this donate button different from the donate button at the top?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

doesnt need to be. I'll check how it look if it's the same as in the header.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

gave it the same style as the one in the header. work better imo.

Comment thread site/index.md
<div class="pgx-card pgx-card--lead pgx-lead-wide">
<p class="pgx-lead-text"><strong>Project Gutenberg is the world's oldest digital library.</strong> Michael Hart started the Project in 1971. Today it is a nonprofit sustained entirely by volunteers who digitize and proofread works of literature as they enter the public domain, keeping them free for everyone, everywhere. We charge nothing, run no ads and never will. Donations are what keep our servers running.</p>
<div class="pgx-lead-links">
<a class="pgx-btn pgx-btn-secondary" href="/about/">Learn more</a>

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Learn more" is terribly vague. and could you articulate for us why it is buttonized ?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Learn more" is directly after a text about PG and leads to the "about" page - what's vague about that?
doesn't need to be buttonized but looks better

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is there any sort of sort of content does "Learn More" exclude?

Comment thread site/index.md
<img src="/gutenberg/b_news_icon.png" alt="Bluesky icon" >
</a></li>
</ul>
<div class="pgx-cards-row pgx-cards-row--outro">

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suggest stacking 'follow us' and 'newsletter ' in a 30% right column and put the other cards in a 70% left column. I suggest demoting the audio books by one outline level and merging it with "special areas". And of course, think of a better heading for "special areas".

For wide screens leave the cards open!

see if we can have the content of each card be in markdown by moving the html to a template; We'll need to edit these from time to time and the html is quite verbose.

@JohannesSeikowsky JohannesSeikowsky Aug 2, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

in my opinion this is the only actual real substantial problem. I'll look into it.

Comment thread site/index.md
Comment thread site/index.md
</div>

<div class="pgx-card pgx-card--social">
<h2 class="pgx-social-title">Follow Us</h2>

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this card is much much better than existing

JohannesSeikowsky and others added 22 commits August 2, 2026 17:17
@JohannesSeikowsky

JohannesSeikowsky commented Aug 3, 2026

Copy link
Copy Markdown
Contributor Author

just worked through all the comments. In my view the one substantial thing left is the bottom part of the page (below the second carousel) on large screens. On mobile it's good, but on larger screens there is the problem that we're collapsing 4 not unsubstantial sections into one accordeon that gets "only" a third of the screen width in terms of real estate. That's something to think about. Here the latest status in Screenshots for convenience:

@JohannesSeikowsky

Copy link
Copy Markdown
Contributor Author
Screenshot_2026-08-03_17-28-47 Screenshot_2026-08-03_17-28-56 Screenshot_2026-08-03_17-29-05

@eshellman

Copy link
Copy Markdown
Collaborator

From https://webaim.org/techniques/textlayout/

Long blocks of centered text result in each new line beginning in a slightly different location. This can introduce overhead when reading.

The centered block of text will not survive a11y review,

@JohannesSeikowsky

JohannesSeikowsky commented Aug 3, 2026

Copy link
Copy Markdown
Contributor Author

it's a "should have" not a "must have". let's focus on real problems.

@JohannesSeikowsky

JohannesSeikowsky commented Aug 3, 2026

Copy link
Copy Markdown
Contributor Author

as mentioned before, the bottom part of the page below the second carousel is the main thing that needs work anyway (on larger screens). Maybe left-aligned text will fit more naturally in whatever the eventual design of it will be. I suspect there's a good chance of that, but not sure until we've tried. We'll see ...

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants