Bug 14309

Summary: Broken image in bitbake manual CSS for versions 1.6.x
Product: [Documentation] BitBake User Manual Reporter: Michael Opdenacker <michael.opdenacker>
Component: bitbake-manualAssignee: Michael Opdenacker <michael.opdenacker>
Status: CLOSED WONTFIX QA Contact:
Severity: minor    
Priority: Medium CC: mhalstead, michael.opdenacker, ndec13, randy.macleod
Version: unspecified   
Target Milestone: 4.1 M1   
Hardware: x86   
OS: Multiple   
Whiteboard:
OS type for building Yocto: --- Type of Regression: ---
Verified: Documentation change: Yes (doc changes required)

Description Michael Opdenacker 2021-03-19 14:13:47 UTC 
Hello,

We probably don't care about such old versions, but you get broken links in the CSS of old versions of the bitbake manual by scanning the YP documentation:

URL        `figures/yocto-project-bw.png'
Parent URL https://docs.yoctoproject.org/1.6/bitbake-user-manual/bitbake-user-manual-style.css, line 692, col 24
Real URL   https://docs.yoctoproject.org/1.6/bitbake-user-manual/figures/yocto-project-bw.png
Check time 0.615 seconds
Size       178B
Result     Error: 404 Not Found

URL        `figures/yocto-project-bw.png'
Parent URL https://docs.yoctoproject.org/1.6.1/bitbake-user-manual/bitbake-user-manual-style.css, line 692, col 24
Real URL   https://docs.yoctoproject.org/1.6.1/bitbake-user-manual/figures/yocto-project-bw.png
Check time 0.708 seconds
Size       178B
Result     Error: 404 Not Found

URL        `figures/yocto-project-bw.png'
Parent URL https://docs.yoctoproject.org/1.6.2/bitbake-user-manual/bitbake-user-manual-style.css, line 692, col 24
Real URL   https://docs.yoctoproject.org/1.6.2/bitbake-user-manual/figures/yocto-project-bw.png
Check time 0.637 seconds
Size       178B
Result     Error: 404 Not Found

URL        `figures/yocto-project-bw.png'
Parent URL https://docs.yoctoproject.org/1.6.3/bitbake-user-manual/bitbake-user-manual-style.css, line 692, col 24
Real URL   https://docs.yoctoproject.org/1.6.3/bitbake-user-manual/figures/yocto-project-bw.png
Check time 0.618 seconds
Size       178B
Result     Error: 404 Not Found

A quick fix would be to remove the below line from bitbake-user-manual-style.css:
  background-image: url("figures/yocto-project-bw.png");

If there's a way to manually fix this on the website, that wouldn't change anybody's life, but at least this would eliminate the 404 errors in my broken link checker runs...

Don't hesitate to close this bug if we don't care...
Comment 1 Michael Opdenacker 2021-03-26 09:44:05 UTC 
How was the documentation for versions 1.6.x generated? 

If such documentation was just generated once, then all we have to do is modify the 4 instances of bitbake-user-manual-style.css manual.

If there's a script to rebuild such docs, like in the case we suddenly have a significant number of broken links that could hurt our SEO ranking, I'd be happy to add a postprocessing step!
Comment 2 Michael Opdenacker 2021-10-29 14:48:19 UTC 
There's nothing I can do about this bug.
Reassigning it to Michael Halstead.
Feel free to assign it to somebody else if needed.
Comment 3 Randy MacLeod 2022-05-05 14:54:00 UTC 
Richard says that Michael O. can patch the tarball in the build scripts.
Comment 4 Michael Opdenacker 2022-05-20 16:46:35 UTC 
Now I understand what I could do to fix this.
However, I don't want to add complexity to the run-docs-build script for a tiny issue in documents we don't maintain any more.

Closing this bug.
Thanks for the guidelines anyway.
Comment 5 Michael Opdenacker 2022-05-20 16:47:11 UTC 
Closing this bug