lukasjarosch / go-docx

Replace placeholders inside docx documents with speed and confidence.

Hi I'm Lukas

I want to change the world, give me the source code.

• 🔬 I'm a M.Sc. in Computer Science.
• 🔭 I’m currently working as Cloud Platform Engineer @inovex.
• 👯 I love to develop software in my spare time, preferably open source.
• 💻 Long time Linux fanboy.
• ⚒️ I love to craft code in Golang.
• 🐱 I do have two cats. They are really bad at pair programming tho (just look at the picture above to see the enthusiasm 😆).

go-docx's Issues

table merge and table foreach

i want docx table merge and table foreach
能否支持 table，以及他变了的merge和循环？

Documents corrupted

On certain Microsoft Office versions, the rendered documents can only be opened after repairing them.

This issue needs to be investigated and resolved

how we can change delimiter?

function to get all placeholders in file

I am working on tool to use docx files as templates and the package have cut a lot of effort so thanks for your work
i think it would be better if there was a function that return an array with all placeholders in template or even better map with place holder with n of occurrence of the place holder
thanks in advance

PlaceholderMap (or Word) does not adhere to '\n' character

It does not seem to be possible to add a 'newline' character (\n or \r\n if you will) within a table cell of a Word table.

Current formatting:

var location string
	for _, host := range res.HostInfo {
		for i := range host.Ports {
			location += (host.Address + ":" + host.Ports[i].PortNumber + " (" + host.Ports[i].Proto + ")" + "\n") // also tried \r\n and \t
		}
	}

Output seems only to add some kind of whitespace within the cell:

This might be the dumbest issue ever written, so sorry beforehand. Is there any way to enforce this newline?

How to convert to []byte

I need to replace it and call straight back to the file stream

I hope that this library will be able to replace images in the future.

I hope that this library will be able to replace images in the future.

Error if placeholder has leading or tailing whitespace(-s) inside of delimiters

Example:

• My docx template I have { organization} (pay attention to leading whitespace) and {address} placeholders
• My placeholder map have organization and address fields

Than program falls with error:

...: not all placeholders were replaced, want=2, have=1

---

I tried to run with debugger to see which behaviour going on under the hood. I found out that stripXmlTags method deletes whitespaces from placeholder. But inside of docx.Open() method you have another behaviour which does not trim whitespaces.

This results to placeholders dismatch and throwing an error.

Is it possible to avoid line break collapse?

Hello,
I'm trying to use a value that's a literal string with some line breaks in it. Currently the line breaks gets collapsed and the string no longer looks the way I expect it to.

docx.PlaceholderMap{
   "PLACEHOLDER_KEY":    `here is my string
with different 
items on 
multiple lines
`,
}

turns into
here is my string with different items on multiple lines

Is it possible to preserve line breaks in placeholder values?

Document tag truncated

The generated document is invalid if the template file contains a spell-checking mark (curly red underline).

Word error message is as follows:

Data in word\document.xml is truncated:
w:rsidRDefault="00DB7D3C"/><w:sectPr w:rsidR="00DB7D3C"><w:pgSz w:w="11906" w:h="16838"/><w:pgMar w:top="1417" w:right="1417" w:bottom="1134" w:left="1417" w:header="708" w:footer="708" w:gutter="0"/><w:cols w:space="708"/><w:docGrid w:linePitch="360"/></w:sectPr></w:body></w:docum

Please see content of template.docx and test.docx file attached.

test.docx
template.docx

Support for dynamically parametrized variables

It would be nice to see support for numbered lists and tables

There is such a package https://github.com/bobiverse/docxplate in which it is implemented, but the author writes that he almost does not support the package

Inserting of new runs / paragraphs / docx-files

Only replacing placeholders might not always be enough. One might face the task to insert a sub-template into the document.

This currently cannot be done since replacements will always occur inside <w:t> tags but new content will most likely be added on a paragraph (<w:p>) level.

[FEATURE REQUEST] - Support for control statements like condition, loop

Thank you for the great library. It would be really great if this library also support control statements like condition and loop

[FEATURE REQUEST] - Support for dynamic table templates

Hey! Thank you for a great library!

I'm just wondering is that even possible to implement such replacing?
Reference: https://plumsail.com/docs/documents/v1.x/document-generation/docx/tables.html

Let me know if contribution would be helpful.

有计划支持表格 表格合并单元格吗？

v0.4.6 can not replace with ampersand `&`.

In version v0.4.6 can not replace string contain & (ampersand) such as

code

docx.PlaceholderMap{
     "company":  "Test & test"
}

word
{company}

but v0.4.4 it work

能否支持if 和表格循环？

能否支持if 和表格循环？

Many paragraphs.

Hi,
Is it possible to replace the placeholder with array of strings, where each array member would be in a new paragraph? Maybe it's possible to do it some other way?
If so, maybe you can give an example.

Replace checkbox symbol in Word docx

Hi, I am using the replace content function of go-docx, but I cannot replace the checkbox symbol.

Is there a way to replace with ?

Configurable delimiters