From 16f5b38828d7734fd3e9a72aa1b000384296f7cc Mon Sep 17 00:00:00 2001 From: Jared Beck Date: Tue, 11 May 2021 19:06:38 -0400 Subject: [PATCH] Docs: troubleshooting template: Word found unreadable content (#113) --- README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.md b/README.md index 9cdbb05..85b718c 100644 --- a/README.md +++ b/README.md @@ -221,8 +221,16 @@ report = ODFReport::Report.new(io: @template.attachment.read) do |r| #### TROUBLESHOOTING +##### Placeholder not replaced + If your placeholder is not being replaced, the problem might come from OpenOffice/LibreOffice which, when a placeholder is edited, add some markup that prevents odf-report from identifying the placeholder. The golden rule is: NEVER edit the placeholders. If you want to change one, delete it an write again, including the [] Example: if you have, say, [USER] in your template and you want to change to [USERNAME], you should not edit and type NAME. Delete the PLACEHOLDER [USER] and type [USERNAME]. + +##### Word found unreadable content + +- Symptom: You prepare your template file in eg. LibreOffice, and when you open the template in Word it says "Word found unreadable content" +- Solution: Open your template in LibreOffice, save as `.docx`, quit LibreOffice. Open the `.docx` in LibreOffice, save as `.odt`. +- Hypothesis: Word does not support all ODT features. Saving as `.docx` removes those features of the document.