aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/README.md b/README.md
index adc4b2f..82f4c24 100644
--- a/README.md
+++ b/README.md
@@ -178,6 +178,16 @@ pass `include_default_style_map=False`:
result = mammoth.convert_to_html(docx_file, style_map=style_map, include_default_style_map=False)
```
+#### External file access
+
+Source documents may reference files outside of the source document.
+To disable access to any such external files during the conversion process,
+pass `external_file_access=False`:
+
+```javascript
+result = mammoth.convert_to_html(docx_file, external_file_access=False)
+```
+
#### Custom image handlers
By default, images are converted to `<img>` elements with the source included inline in the `src` attribute.
@@ -415,6 +425,9 @@ For instance:
and embed the HTML into your website,
this may allow arbitrary files on the server to be read and exfiltrated.
+ To disable access to any such external files during the conversion process,
+ pass `external_file_access=False`.
+
### Document transforms
**The API for document transforms should be considered unstable,