From 204ceaec854c9a1dfeefb8b5b6243493321ff0f2 Mon Sep 17 00:00:00 2001 From: Michael Williamson Date: Sun, 3 Jul 2016 15:42:39 +0100 Subject: Add documentation for comments --- NEWS | 4 ++++ README.md | 19 +++++++++++++++++++ 2 files changed, 23 insertions(+) diff --git a/NEWS b/NEWS index 0f7735c..ccdc188 100644 --- a/NEWS +++ b/NEWS @@ -1,3 +1,7 @@ +# 1.1.0 + +* Add support for comments. + # 1.0.4 * Add support for w:sdt elements. This allows the bodies of content controls, diff --git a/README.md b/README.md index 53f5e48..428cf8a 100644 --- a/README.md +++ b/README.md @@ -39,6 +39,8 @@ The following features are currently supported: * Text boxes. The contents of the text box are treated as a separate paragraph that appears after the paragraph containing the text box. +* Comments. + ## Installation pip install mammoth @@ -239,6 +241,23 @@ with open("document.docx", "rb") as docx_file: result = mammoth.convert_to_html(docx_file, style_map=style_map) ``` +#### Comments + +By default, comments are ignored. +To include comments in the generated HTML, +add a style mapping for `comment-reference`. +For instance: + +```python +style_map = "comment-reference => sup" + +with open("document.docx", "rb") as docx_file: + result = mammoth.convert_to_html(docx_file, style_map=style_map) +``` + +Comments will be appended to the end of the document, +with links to the comments wrapped using the specified style mapping. + ### API #### `mammoth.convert_to_html(fileobj, **kwargs)` -- cgit v1.2.3