pdx:addEndnote Inserts an endnote into the Word document

pdx:addEndnote

Inserts an endnote into the Word document.

Description

Element definition

<pdx:content>
    <pdx:addEndnote pdx:wordFragmentName="">
        <pdx:textDocument>
            <pdx:data pdx:dataId="" pdx:dataType="text">text</pdx:data>
            <pdx:paragraphStyle />
        </pdx:textDocument>
        <pdx:textEndnote>
            <pdx:data pdx:dataId="" pdx:dataType="text">text</pdx:data>
        </pdx:textEndnote>
        <pdx:endnoteMark pdx:customMark="">
            <pdx:textRunStyle>
                <pdx:bold pdx:value="" />
                <pdx:caps pdx:value="" />
                <pdx:color pdx:value="" />
                <pdx:font pdx:value="" />
                <pdx:fontSize pdx:value="" />
                <pdx:italic pdx:value="" />
                <pdx:rtl pdx:value="" />
                <pdx:smallCaps pdx:value="" />
                <pdx:textAlign pdx:value="" />
                <pdx:underline pdx:value="" />
            </pdx:textRunStyle>
        </pdx:endnoteMark>
        <pdx:referenceMark>
            <pdx:textRunStyle>
                <pdx:bold pdx:value="" />
                <pdx:caps pdx:value="" />
                <pdx:color pdx:value="" />
                <pdx:font pdx:value="" />
                <pdx:fontSize pdx:value="" />
                <pdx:italic pdx:value="" />
                <pdx:rtl pdx:value="" />
                <pdx:smallCaps pdx:value="" />
                <pdx:textAlign pdx:value="" />
                <pdx:underline pdx:value="" />
            </pdx:textRunStyle>
        </pdx:referenceMark>
    </pdx:addEndnote>
</pdx:content>

This element allows the insertion of a endnote into the Word document.

You may fully customize the endnote content including all kind of elements like paragraphs of text with sophisticated formatting, images, links or even tables and HTML content.

If one wishes to insert an endnote within a complex paragraph one should use this element in combination with the addText element.

Attributes and sub-elements

options

key	Description
textDocument	This can be a string of text that will appear in the Word document just before the endnote call or an array with the text and the formatting options (as in the addText method) or a Word fragment.
textEndnote	This is a string of text that will show up in the corresponding endnote or a Word fragment that may include a variety of elements.
endnoteMark	The keys of this array are: 'customMark': a special character, if any, that we would like to use for the call to the endnote content, 'font': the font family we wish to use (Arial, Calibri...) 'bold': true or false for bold text, 'bidi': true for right to left languages, 'italic': true or false to turn on italics, 'color': an hexadecimal color ('000000', 'FF0000' ...), 'rtl': true for right to left languages.
referenceMark	The keys of this array are: 'font': the font family we wish to use (Arial, Calibri...) 'bold': true or false for bold text, 'bidi': true for right to left languages, 'italic': true or false to turn on italics, 'color': an hexadecimal color ('000000', 'FF0000' ...), 'rtl': true for right to left languages.

Code samples

#Example 1

config.xml

<?xml version="1.0" encoding="UTF-8"?>
<pdx:document xmlns:pdx="http://www.phpdocx.com/main">
    <pdx:config>
        <pdx:output pdx:name="output" pdx:type="docx" />
    </pdx:config>
</pdx:document>

content.xml

<?xml version="1.0" encoding="UTF-8"?>
<pdx:document xmlns:pdx="http://www.phpdocx.com/main">
    <pdx:content>
        <pdx:wordFragments>
            <pdx:wordFragment pdx:wordFragmentName="endnoteFragment" pdx:target="document">
                <pdx:content>
                    <pdx:addEndnote>
                        <pdx:textDocument>
                            <pdx:data pdx:dataId="" pdx:dataType="text">endnote</pdx:data>
                        </pdx:textDocument>
                        <pdx:textEndnote>
                            <pdx:data pdx:dataId="" pdx:dataType="text">The endnote we want to insert.</pdx:data>
                        </pdx:textEndnote>
                    </pdx:addEndnote>
                </pdx:content>
            </pdx:wordFragment>
        </pdx:wordFragments>
        <pdx:addText>
            <pdx:textRun>
                <pdx:data pdx:dataId="" pdx:dataType="text">Here comes the </pdx:data>
            </pdx:textRun>
            <pdx:textRun>
                <pdx:data pdx:dataId="" pdx:dataType="wordFragment">endnoteFragment</pdx:data>
            </pdx:textRun>
            <pdx:textRun>
                <pdx:data pdx:dataId="" pdx:dataType="text"> and some other text.</pdx:data>
            </pdx:textRun>
        </pdx:addText>
    </pdx:content>
</pdx:document>

settings.xml

<?xml version="1.0" encoding="UTF-8"?>
<pdx:document xmlns:pdx="http://www.phpdocx.com/main">
    <pdx:settings>
    </pdx:settings>
</pdx:document>

import os as os
import sys as sys
sys.path.append(os.path.abspath("wrappers/python/XmlDocx"))
import XmlDocx as XmlDocx
document = XmlDocx.XmlDocx("config.xml")
document.setDocumentProperties("settings.xml")
document.addContent("content.xml")
document.setXmlDocxPath("xmldocx path")
document.render()

The resulting Word document looks like: