在word文档中添加脚注

Question

如何使用Apache POI向单词文档（.docx）添加脚注？ I know how to retrieve footnotes already in the document，但实际上我无法添加更多内容。

Answer 1

我不确定这是否是为word文档添加脚注的最佳方式，但它确实有效。在查看了使用单词添加脚注的文档的Open XML之后，我发现不仅需要脚注，而且段落内部还有参考，并且可选地强烈推荐三种样式。

在文档中添加脚注需要CTFtnEdn个实例，可以使用CTFtnEdn.Factory.newInstance()来实现。现在要添加脚注的内容，我引用了使用word：

创建的脚注中找到的内容

<xml-fragment w:id="1" xmlns:cx="http://schemas.microsoft.com/office/drawing/2014/chartex" xmlns:cx1="http://schemas.microsoft.com/office/drawing/2015/9/8/chartex" xmlns:m="http://schemas.openxmlformats.org/officeDocument/2006/math" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:v="urn:schemas-microsoft-com:vml" xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main" xmlns:w10="urn:schemas-microsoft-com:office:word" xmlns:w14="http://schemas.microsoft.com/office/word/2010/wordml" xmlns:w15="http://schemas.microsoft.com/office/word/2012/wordml" xmlns:w16se="http://schemas.microsoft.com/office/word/2015/wordml/symex" xmlns:wne="http://schemas.microsoft.com/office/word/2006/wordml" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing" xmlns:wp14="http://schemas.microsoft.com/office/word/2010/wordprocessingDrawing" xmlns:wpc="http://schemas.microsoft.com/office/word/2010/wordprocessingCanvas" xmlns:wpg="http://schemas.microsoft.com/office/word/2010/wordprocessingGroup" xmlns:wpi="http://schemas.microsoft.com/office/word/2010/wordprocessingInk" xmlns:wps="http://schemas.microsoft.com/office/word/2010/wordprocessingShape">
    <w:p w:rsidR="00B87AAC" w:rsidRDefault="00B87AAC">
        <w:pPr>
            <w:pStyle w:val="FootnoteText"/>
        </w:pPr>
        <w:r>
            <w:rPr>
                <w:rStyle w:val="FootnoteReference"/>
            </w:rPr>
            <w:footnoteRef/>
        </w:r>
        <w:r>
            <w:t xml:space="preserve">Here is a Footnote</w:t>
        </w:r>
        <w:bookmarkStart w:id="0" w:name="_GoBack"/>
        <w:bookmarkEnd w:id="0"/>
    </w:p>
</xml-fragment>

以下是使用java编写的示例：

CTFtnEdn ctfInstance = CTFtnEdn.Factory.newInstance();

BigInteger id = new BigInteger("1");

ctfInstance.setId(id);

CTP ctp = ctfInstance.addNewP();

ctp.addNewPPr().addNewPStyle().setVal("FootnoteText");

CTR ctr = ctp.addNewR();
ctr.addNewRPr().addNewRStyle().setVal("FootnoteReference");
ctr.addNewFootnoteRef();

CTText cttext = ctp.addNewR().addNewT();
cttext.setStringValue("This is the text in the footnote");
cttext.setSpace(SpaceAttribute.Space.PRESERVE);

将代码添加到CTFtnEdn实例后，需要使用WMPFDocument将其添加到document.addFootnote()。

现在添加对文档段落的引用 - 我不相信在没有引用的情况下，页面底部甚至可以看到脚注。参考的Open XML如下所示：

<w:r w:rsidR="00B87AAC">
    <w:rPr>
        <w:rStyle w:val="FootnoteReference"/>
    </w:rPr>
    <w:footnoteReference w:id="1"/>
</w:r>

使用以下代码可以在java中轻松完成：

ctr = document.getParagraphArray(0).getCTP().addNewR();
ctr.addNewRPr().addNewRStyle().setVal("FootnoteReference");
ctr.addNewFootnoteReference().setId(id);

为了给脚注添加自己的样式，需要添加三个样式的上标。下面是所有这三个的Open XML：

<w:style w:styleId="FootnoteReference" w:type="character">
    <w:name w:val="footnote reference"/>
    <w:basedOn w:val="DefaultParagraphFont"/>
    <w:uiPriority w:val="99"/>
    <w:semiHidden/>
    <w:unhideWhenUsed/>
    <w:rPr>
      <w:vertAlign w:val="superscript"/>
    </w:rPr>
</w:style>
<w:style w:styleId="FootnoteText" w:type="paragraph">
    <w:name w:val="footnote text"/>
    <w:basedOn w:val="Normal"/>
    <w:link w:val="FootnoteTextChar"/>
    <w:uiPriority w:val="99"/>
    <w:semiHidden/>
    <w:unhideWhenUsed/>
    <w:rPr>
        <w:sz w:val="20"/>
        <w:szCs w:val="20"/>
    </w:rPr>
</w:style>
<w:style w:customStyle="1" w:styleId="FootnoteTextChar" w:type="character">
    <w:name w:val="Footnote Text Char"/>
    <w:basedOn w:val="DefaultParagraphFont"/>
    <w:link w:val="FootnoteText"/>
    <w:uiPriority w:val="99"/>
    <w:semiHidden/>
    <w:rPr>
        <w:sz w:val="20"/>
        <w:szCs w:val="20"/>
    </w:rPr>
</w:style>

在java中添加：

CTStyle style = CTStyle.Factory.newInstance();
style.setStyleId("FootnoteReference");
style.setType(STStyleType.CHARACTER);
style.addNewName().setVal("footnote reference");
style.addNewBasedOn().setVal("DefaultParagraphFont");
style.addNewUiPriority().setVal(new BigInteger("99"));
style.addNewSemiHidden();
style.addNewUnhideWhenUsed();
style.addNewRPr().addNewVertAlign().setVal(STVerticalAlignRun.SUPERSCRIPT);

document.getStyles().addStyle(new XWPFStyle(style));

style = CTStyle.Factory.newInstance();
style.setType(STStyleType.PARAGRAPH);
style.setStyleId("FootnoteText");
style.addNewName().setVal("footnote text");
style.addNewBasedOn().setVal("Normal");
style.addNewLink().setVal("FootnoteTextChar");
style.addNewUiPriority().setVal(new BigInteger("99"));
style.addNewSemiHidden();
style.addNewUnhideWhenUsed();
CTRPr rpr = style.addNewRPr();
rpr.addNewSz().setVal(new BigInteger("20"));
rpr.addNewSzCs().setVal(new BigInteger("20"));

document.getStyles().addStyle(new XWPFStyle(style));

style  = CTStyle.Factory.newInstance();
style.setCustomStyle(STOnOff.X_1);
style.setStyleId("FootnoteTextChar");
style.setType(STStyleType.CHARACTER);
style.addNewName().setVal("Footnote Text Char");
style.addNewBasedOn().setVal("DefaultParagraphFont");
style.addNewLink().setVal("FootnoteText");
style.addNewUiPriority().setVal(new BigInteger("99"));
style.addNewSemiHidden();
rpr = style.addNewRPr();
rpr.addNewSz().setVal(new BigInteger("20"));
rpr.addNewSzCs().setVal(new BigInteger("20"));

document.getStyles().addStyle(new XWPFStyle(style));

请注意，document.getStyles().addStyle(new XWPFStyle(style))用于向文档添加新样式。

这是SSCCE（确保最后更改输出路径）：

public static void main(String[] args) throws FileNotFoundException, IOException, XmlException{
    // create doc
    XWPFDocument document = new XWPFDocument();

    // some sample text
    document.createParagraph().createRun().setText("This is a Test.");

    // check to add footnotes in case of empty
    if (document.getFootnotes().isEmpty()){
        document.createFootnotes();
    }

    // add footnote
    CTFtnEdn ctfInstance = CTFtnEdn.Factory.newInstance();

    BigInteger id = new BigInteger("1");

    ctfInstance.setId(id);
    CTP ctp = ctfInstance.addNewP();

    ctp.addNewPPr().addNewPStyle().setVal("FootnoteText");

    CTR ctr = ctp.addNewR();
    ctr.addNewRPr().addNewRStyle().setVal("FootnoteReference");
    ctr.addNewFootnoteRef();

    CTText cttext = ctp.addNewR().addNewT();
    cttext.setStringValue("This should be a footnote");
    cttext.setSpace(SpaceAttribute.Space.PRESERVE);

    // add footnote to document
    document.addFootnote(ctfInstance);

    // add reference to footnote at end of first paragraph
    ctr = document.getParagraphArray(0).getCTP().addNewR();
    ctr.addNewRPr().addNewRStyle().setVal("FootnoteReference");
    ctr.addNewFootnoteReference().setId(id);

    // styles

    // if styles dont already exist then create them
    if (document.getStyles()==null){
        document.createStyles();
    }

    CTStyle style = CTStyle.Factory.newInstance();
    style.setStyleId("FootnoteReference");
    style.setType(STStyleType.CHARACTER);
    style.addNewName().setVal("footnote reference");
    style.addNewBasedOn().setVal("DefaultParagraphFont");
    style.addNewUiPriority().setVal(new BigInteger("99"));
    style.addNewSemiHidden();
    style.addNewUnhideWhenUsed();
    style.addNewRPr().addNewVertAlign().setVal(STVerticalAlignRun.SUPERSCRIPT);

    // add style
    document.getStyles().addStyle(new XWPFStyle(style));

    style = CTStyle.Factory.newInstance();
    style.setType(STStyleType.PARAGRAPH);
    style.setStyleId("FootnoteText");
    style.addNewName().setVal("footnote text");
    style.addNewBasedOn().setVal("Normal");
    style.addNewLink().setVal("FootnoteTextChar");
    style.addNewUiPriority().setVal(new BigInteger("99"));
    style.addNewSemiHidden();
    style.addNewUnhideWhenUsed();
    CTRPr rpr = style.addNewRPr();
    rpr.addNewSz().setVal(new BigInteger("20"));
    rpr.addNewSzCs().setVal(new BigInteger("20"));

    // add style
    document.getStyles().addStyle(new XWPFStyle(style));

    style  = CTStyle.Factory.newInstance();
    style.setCustomStyle(STOnOff.X_1);
    style.setStyleId("FootnoteTextChar");
    style.setType(STStyleType.CHARACTER);
    style.addNewName().setVal("Footnote Text Char");
    style.addNewBasedOn().setVal("DefaultParagraphFont");
    style.addNewLink().setVal("FootnoteText");
    style.addNewUiPriority().setVal(new BigInteger("99"));
    style.addNewSemiHidden();
    rpr = style.addNewRPr();
    rpr.addNewSz().setVal(new BigInteger("20"));
    rpr.addNewSzCs().setVal(new BigInteger("20"));

    // add style
    document.getStyles().addStyle(new XWPFStyle(style));

    // save document
    FileOutputStream out = new FileOutputStream(new File("yourPathHere.docx"));
    document.write(out);
    out.close();
}

Answer 2

这样其他人就不必像我一样进行研究了:)！这是使用类XWPFFootnote的POI 4.1.0代码的更新版本（不幸的是，它还不能完成所有工作）。

首先，初始化文档以接收脚注。 doc是您的XWPFDocument（我总是从模板文档开始，该模板具有预制样式，包括所需的脚注样式：FootnoteText，FootnoteReference）。这基本上会创建两个“虚拟”脚注，我认为这些脚注仅用于显示目的-但是，如果Word脚注不存在，Word会将其视为已损坏。

doc.createFootnotes();

// Create the first two "dummy" footnotes.

{ // <w:footnote w:type="separator" w:id="-1"><w:p><w:r><w:separator/></w:r></w:p></w:footnote>
    XWPFFootnote footnote = doc.createFootnote();
    footnote.getCTFtnEdn().setId(BigInteger.ZERO.subtract(BigInteger.ONE)); // -1
    footnote.getCTFtnEdn().setType(STFtnEdn.SEPARATOR);
    footnote.getCTFtnEdn().addNewP();
    footnote.getCTFtnEdn().getPArray(0).addNewR();
    footnote.getCTFtnEdn().getPArray(0).getRArray(0).addNewSeparator();
}

{ // <w:footnote w:type="continuationSeparator" w:id="0"><w:p><w:r><w:continuationSeparator/></w:r></w:p></w:footnote>
    XWPFFootnote footnote = doc.createFootnote();
    footnote.getCTFtnEdn().setId(BigInteger.ZERO);
    footnote.getCTFtnEdn().setType(STFtnEdn.CONTINUATION_SEPARATOR);
    footnote.getCTFtnEdn().addNewP();
    footnote.getCTFtnEdn().getPArray(0).addNewR();
    footnote.getCTFtnEdn().getPArray(0).getRArray(0).addNewContinuationSeparator();
}

然后，您可以在文本中的某个位置继续添加脚注。创建段落并像往常一样运行，直到您希望出现对脚注的引用的位置（通常为指数形式）。

footnote = doc.createFootnote();
paragraph.addFootnoteReference(footnote); // Creates a new run in the current paragraph to hold the reference.

XWPFParagraph footnoteParagraph;
{ // Create a low-level paragraph and add it to the footnote with the right style. 
    CTP ctp = footnote.getCTFtnEdn().addNewP();
    footnoteParagraph = new XWPFParagraph(ctp, footnote);
    footnoteParagraph.setStyle("FootnoteText");
}

{ // Create a run within this paragraph 
    XWPFRun run = paragraph.getLast().createRun();
    run.setStyle("FootnoteReference");
    run.getCTR().addNewFootnoteRef(); // Not addNewFootnoteReference, this is not recognised by Word!
}

{ // Add a space after the footnote number (like Word). 
    XWPFRun run = footnoteParagraph.createRun();
    run.setText(" ");
}

{ // Add your own text in the footnote, as in any paragraph. 
    XWPFRun run = footnoteParagraph.createRun();
}