Skip to content

Commit

Permalink
Added a Troubleshooting section (#107)
Browse files Browse the repository at this point in the history
  • Loading branch information
paulmassen committed Jul 23, 2020
1 parent b686bf1 commit c4afdde
Showing 1 changed file with 8 additions and 0 deletions.
8 changes: 8 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -218,3 +218,11 @@ report = ODFReport::Report.new(io: @template.attachment.read) do |r|
**rubyzip**: manipulating the contents of the odt file, since it's actually a zip file.
**nokogiri**: parsing and manipulating the document xml files.
**mime-types**: identify images mime types

#### TROUBLESHOOTING

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].

0 comments on commit c4afdde

Please sign in to comment.