pdx:setLineNumbering Inserts line numbering into an already existing Word document

pdx:setLineNumbering

Inserts line numbering into an already existing Word document.

Description

Element definition

<pdx:utilities>
    <pdx:setLineNumbering pdx:countBy="" pdx:start="" pdx:distance="" pdx:restart="continuous|newPage|newSection" />
</pdx:utilities>

This method allows the insertion or modification of line numbering properties of an existing Word document in .docx format.

The available options include:

Line number increments to display.
Start number.
Distance between line numbers and text.
Restarting conditions: continuous or restarted in each new document page or section.

Attributes and sub-elements

source

The path to the source Word document.

target

The path to the resulting Word document.

options

This is an array including all the available styling options. The possible keys and values of this array are:

key	Description
countBy	An integer indicating the line number increments to display. If left empty is set to 1.
start	An integer indicating which number must be associated with the first line. The default value is 1.
distance	An integer indicating the distance, in twentieths of a point, between the number and the associated line. If left empty is dealt automatically by Word.
restart	A string that can take the following values: 'continuous': default value, the numbering does not get restarted anywhere in the document. 'newPage': the numbering restarts at the beginning of every page. 'newSection': the numbering restarts at the beginning of every section.

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:utilities>
        <pdx:setLineNumbering pdx:source="/var/www/xmldocx/samples/files/second.docx" pdx:target="/var/www/xmldocx/samples/DocxUtilities/setLineNumbering/output_setLineNumbering.docx" pdx:start="25" />
    </pdx:utilities>
</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: