mirror of
https://github.com/BookStackApp/BookStack.git
synced 2026-02-11 19:06:22 +03:00
PDF Export not exporting images #3849
Open
opened 2026-02-05 07:39:52 +03:00 by OVERLORD
·
17 comments
No Branch/Tag Specified
development
l10n_development
release
llm_only
vectors
v25-11
docker_env
drawio_rendering
user_permissions
ldap_host_failover
svg_image
prosemirror
captcha_example
fix/video-export
v25.12.3
v25.12.2
v25.12.1
v25.12
v25.11.6
v25.11.5
v25.11.4
v24.11.4
v25.11.3
v25.11.2
v25.11.1
v25.11
v25.07.3
v25.07.2
v25.07.1
v25.07
v25.05.2
v25.05.1
v25.05
v25.02.5
v25.02.4
v25.02.3
v25.02.2
v25.02.1
v25.02
v24.12.1
v24.12
v24.10.3
v24.10.2
v24.10.1
v24.10
v24.05.4
v24.05.3
v24.05.2
v24.05.1
v24.05
v24.02.3
v24.02.2
v24.02.1
v24.02
v23.12.3
v23.12.2
v23.12.1
v23.12
v23.10.4
v23.10.3
v23.10.2
v23.10.1
v23.10
v23.08.3
v23.08.2
v23.08.1
v23.08
v23.06.2
v23.06.1
v23.06
v23.05.2
v23.05.1
v23.05
v23.02.3
v23.02.2
v23.02.1
v23.02
v23.01.1
v23.01
v22.11.1
v22.11
v22.10.2
v22.10.1
v22.10
v22.09.1
v22.09
v22.07.3
v22.07.2
v22.07.1
v22.07
v22.06.2
v22.06.1
v22.06
v22.04.2
v22.04.1
v22.04
v22.03.1
v22.03
v22.02.3
v22.02.2
v22.02.1
v22.02
v21.12.5
v21.12.4
v21.12.3
v21.12.2
v21.12.1
v21.12
v21.11.3
v21.11.2
v21.11.1
v21.11
v21.10.3
v21.10.2
v21.10.1
v21.10
v21.08.6
v21.08.5
v21.08.4
v21.08.3
v21.08.2
v21.08.1
v21.08
v21.05.4
v21.05.3
v21.05.2
v21.05.1
v21.05
v21.04.6
v21.04.5
v21.04.4
v21.04.3
v21.04.2
v21.04.1
v21.04
v0.31.8
v0.31.7
v0.31.6
v0.31.5
v0.31.4
v0.31.3
v0.31.2
v0.31.1
v0.31.0
v0.30.7
v0.30.6
v0.30.5
v0.30.4
v0.30.3
v0.30.2
v0.30.1
v0.30.0
v0.29.3
v0.29.2
v0.29.1
v0.29.0
v0.28.3
v0.28.2
v0.28.1
v0.28.0
v0.27.5
v0.27.4
v0.27.3
v0.27.2
v0.27.1
v0.27
v0.26.4
v0.26.3
v0.26.2
v0.26.1
v0.26.0
v0.25.5
v0.25.4
v0.25.3
v0.25.2
v0.25.1
v0.25.0
v0.24.3
v0.24.2
v0.24.1
v0.24.0
v0.23.2
v0.23.1
v0.23.0
v0.22.0
v0.21.0
v0.20.3
v0.20.2
v0.20.1
v0.20.0
v0.19.0
v0.18.5
v0.18.4
v0.18.3
v0.18.2
v0.18.1
v0.18.0
v0.17.4
v0.17.3
v0.17.2
v0.17.1
v0.17.0
v0.16.3
v0.16.2
v0.16.1
v0.16.0
v0.15.3
v0.15.2
v0.15.1
v0.15.0
v0.14.3
v0.14.2
v0.14.1
v0.14.0
v0.13.1
v0.13.0
v0.12.2
v0.12.1
v0.12.0
v0.11.2
v0.11.1
v0.11.0
v0.10.0
v0.9.3
v0.9.2
v0.9.1
v0.9.0
v0.8.2
v0.8.1
v0.8.0
v0.7.6
v0.7.5
v0.7.4
v0.7.3
0.7.2
v.0.7.1
v0.7.0
v0.6.3
v0.6.2
v0.6.1
v0.6.0
v0.5.0
Labels
Clear labels
🎨 Design
📖 Docs Update
🐛 Bug
🐛 Bug
:cat2:🐈 Possible duplicate
💿 Database
☕ Open to discussion
💻 Front-End
🐕 Support
🚪 Authentication
🌍 Translations
🔌 API Task
🏭 Back-End
⛲ Upstream
🔨 Feature Request
🛠️ Enhancement
🛠️ Enhancement
🛠️ Enhancement
❤️ Happy feedback
🔒 Security
🔍 Pending Validation
💆 UX
📝 WYSIWYG Editor
🌔 Out of scope
🔩 API Request
:octocat: Admin/Meta
🖌️ View Customization
❓ Question
🚀 Priority
🛡️ Blocked
🚚 Export System
♿ A11y
🔧 Maintenance
> Markdown Editor
pull-request
Mirrored from GitHub Pull Request
No Label
🐛 Bug
Milestone
No items
No Milestone
Projects
Clear projects
No project
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: starred/BookStack#3849
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @mariusdill on GitHub (Jun 13, 2023).
Describe the Bug
When I export a page as PDF the PDF does not include the images. It only contains the name and link of the image. Behind the name it states "Image not found or type unkown".
The weird thing about this problem is that it works for recently created pages. I cant tell since when it doesnt work but a few month ago I could export the old pages correctly.
eistik-updateanleitung.pdf
Steps to Reproduce
Export Page -> PDF
Expected Behaviour
Exported PDF includes all images
Screenshots or Additional Context
Browser Details
Chrome 114 on Windows 10
Exact BookStack Version
23.05.2
PHP Version
8.2.6
Hosting Environment
Ubuntu 22.04 VM
Docker Compose Setup from Linuxserver.io
@ssddanbrown commented on GitHub (Jun 13, 2023):
This will usually occur if BookStack can't trace the image file to a local resource based upon the URL.
Have you perhaps changed the base URL at some point? Even if to just
https://fromhttp://?Otherwise, could possibly be due to image file access permissions, and existence/permissions upon the page the images were originally uploaded to, but I haven't fully validated that as I haven't been in that part of the code for a while.
@mariusdill commented on GitHub (Jun 14, 2023):
If I remember correcly I had the APP_URL not set at my initial setup because it didnt work if I set it to the right URL. But I changed it to the right URL like a year ago.
@mariusdill commented on GitHub (Jun 14, 2023):
The URL of the image is correct, I can open it in boostack.
@ssddanbrown commented on GitHub (Jun 14, 2023):
But does the start of it, when copied into a text editor (Not when opened via browser) exactly match the configured
APP_URLvalue? Including startinghttps://orhttp://component?@mariusdill commented on GitHub (Jun 14, 2023):
Yes
http://bookstack/uploads/images/gallery/2022-02/eisitk-net-update.png
APP_URL= http://bookstack
@mariusdill commented on GitHub (Jul 12, 2023):
We use the PDF export as a backup. It's very important for my department that these manuals are available when our system is down.
Is there any other way to do this? The case scenario would be to use it offline from a USB stick.
@cdieterich-nj commented on GitHub (Jul 21, 2023):
The thing BookStack generated isn't a "portable document format" document because it does not encapsulate the images - just points to external URLs.
I suppose this is useful in some cases, like keeping images secure.
I have a work-around that I think works... first Export your page or book as HTML (which will have URLs), then open the HTML document in a browser and export that as .pdf
at least I think that works... I am running on an isolated secure computer, so I have to put the file on a thumb drive (no e-mail for me) and take it to an outside computer. So far I think it works.
I see that Stackoverflow has a topic on "adding an image with dompdf" so I know it's possible to export portable documents directly if BookStack wants this.
An option to include the image's filename under the image might be nice too.
@mariusdill commented on GitHub (Oct 13, 2023):
Thanks for your tip. When I export the pages in HTML the images are all there. Very weird issue but at least I have a working offline backup now :)
@crashmaster18 commented on GitHub (Oct 15, 2023):
For what it's worth, Dan, I think an option (in the admin-cli perhaps?) to validate and perhaps correct media URLs would be helpful. We've also seen this issue, and we hacked around it (to create HTML then PDF) but in our case government regulators require PDF and we can't provide HTML. So something an end user should be able to accomplish has to go to help desk. Not urgent of course, we have workarounds...
@otherjoel commented on GitHub (Oct 15, 2023):
Modern browser’s native print functionality can save the results as a PDF file. This is something most users should be able to handle.
@mariusdill commented on GitHub (Oct 16, 2023):
Sure you can but when you save important infomation in bookstack that needs do be available in case of an outage you need a offline backup. And the only way for this is to export all books with a script.
@mdezzi commented on GitHub (Dec 11, 2023):
@mariusdill Are you using the WYSIWYG Docx Import Hack when creating pages? I am getting the "image not found or type unknown" error when exporting to PDF for a bunch of pages. The common theme is that they were created from docx files, so that import seems to break something on the export. I notized that if I edit the page, and click on each image and click the "Add/Edit Image" option to bring up the edit image window and then close it, it fixes the problem.
EDIT: And in my case, it appears because the import is dropping two returns into the alt text of the image:

Any of the image entries with the line returns are the ones that do not export.

@ssddanbrown is there a way to mass update all tables to find/replace these line returns and remove them?
@mariusdill commented on GitHub (Dec 12, 2023):
No but we copied a lot of images from word documents so it could be the same problem.
@cdieterich-nj commented on GitHub (Dec 12, 2023):
in our shop all images come directly from capture by cell phone cameras to bookstack.
On December 11, 2023 4:10:42 PM EST, mariusdill @.***> wrote:
@itsTurnip commented on GitHub (Feb 20, 2024):
As @mdezzi mentioned I used WYSIWYG Docx Import Hack too so now I got problem exporting pdf. So I went searching database for the pages records and I found out that images had an

alttag which was broken with CRLF breaks.Removing such breaks repairs PDF exporting. I think it's probably caused by mammoth.js library which uses auto generated .docx alt descriptions for image inserting.
@shaiksohail11 commented on GitHub (Apr 22, 2024):
@ssddanbrown I am facing an issue after exporting the document in pdf format, the images goes disappear, and showing unknown type and also giving the reference to the image, when opened image is visible. Can you look into this issue.

after clicking on the text showing actual image.

@ssddanbrown look into the issue, waiting for your help.
Iam using UbuntuOS
with apache2
@maks2199 commented on GitHub (Oct 9, 2024):
We have the same issue. The observations we made: