fix(guide): 1. resolve guide missing chapter cover images after mdbook build. 2. make intro title visible

[Ander-Index]

Corrected the background-image path from ../ to ./ to fix the broken asset URL in the mdbook build.

And adds color: white; to the intro header in guide/custom.css so the title is visible on the black background.

[klembot]

Hi, I don't see a broken image or invisible text on https://klembot.github.io/chapbook/guide/, which I think is where the CSS changes are you're referencing. Could you post screenshots of the problems you're seeing?

[Ander-Index]

Hi, I don't see a broken image or invisible text on https://klembot.github.io/chapbook/guide/, which I think is where the CSS changes are you're referencing. Could you post screenshots of the problems you're seeing?

1

Check out latest develop branch (a09a37b)

2 Build

cd /Volumes/Storage/Repositories/chapbook/guide
mdbook build

3 result

open /Volumes/Storage/Repositories/chapbook/dist/guide/index.html

4

macOS Chrome: 142.0.7444.176 (without any plug-in)

[Ander-Index]

mdbook v0.5.2 (from Homebrew)

[klembot]

Looked into this further and I think I understand what is going on.

• background-image path was a hack I did because the guide is hosted at /chapbook/guide/ and not /guide/, which I think mdbook assumes. However, I noticed that https://klembot.github.io/chapbook/guide/modifiers-and-inserts/index.html has a broken image right now but https://klembot.github.io/chapbook/guide/index.html does not. We need a way to specify a base URL, I think, in mdbook. I will try to look into it; curious if you have any suggestions as well.

• The white color on headers is set here. But it looks like mdbook's output has changed so that headers are no longer linked. I think we should remove that declaration as well.

I wish we could specify a mdbook version somehow to eliminate the possibility of these kind of unexpected changes :-/