Repository navigation
Review and merge bigger forks #11
Description
Bigger forks:
- https://github.com/michael-koeller/python-docx
- custom properties
- https://github.com/VanOord/vo-python-docx
- header & footer
- captions & cross-reference (bookmarks)
- https://github.com/br-rkdrnf/python-docx/tree/footnotes
- Hyperlink python-openxml/python-docx#784
- https://github.com/DQinYuan/python-docx/tree/section.paragraphs
- https://github.com/miguelfreitas/python-docx
- https://github.com/madphysicist/python-docx/tree/enum-docs
- https://github.com/Yiqing-Zhou/python-docx/tree/master
- https://github.com/BayooG/bayoo-docx
- https://github.com/jlovegren0/python-docx
- https://github.com/lnv42/python-docx/tree/feature/tableLooking
Activity
Cyberwizzard commentedon Mar 17, 2023
+1 for getting review comment support from bayoo merged into this.
toxicphreAK commentedon Jun 1, 2023
Implemented in 85a30f1
toxicphreAK commentedon Aug 3, 2026
Reviewed in the 2.0.0 feature pass (August 2026) and left open deliberately: this is a standing research task rather than a unit of implementable work, so there is nothing here to close.
Several of the features these threads point at have since landed on
mainindependently — tracked changes (#74), fields and TOC (#80), list numbering (#73), cross-run search and replace (#76), floating images (#85), watermarks (#86) and style copying (#87). Worth re-reading this list against HISTORY.rst before spending time on it, since the overlap is now substantial.toxicphreAK commentedon Aug 4, 2026
Surveyed all eleven forks listed above, plus every non-trivial branch in each of them (78 branches in total), diffing each against its merge-base with upstream. Most are based on upstream v0.8.6-v0.8.9 and predate both upstream v1.2.0 and the 2.0.0 feature pass.
Everything they contain has now either landed on
mainor been filed as its own issue, so this thread has nothing left to track and is closed in favour of those.New issues filed from this survey
word/endnotes.xml)footnotes,beringParagraph.textequation_supportfeature/theme-fonttablew:tblLook— table style conditional formattingfeature/tableLookingmasterw:docDefaultsdevelopupdate_packagerelease/v0.2.15SEQand bookmarksupdate_packageAlready covered on
mainRoughly nine tenths of the surveyed diff. Custom document properties (michael-koeller
feature/custom_properties) — #72. Headers and footers, hyperlinks, bookmarks — upstream v1.0-v1.2 plus #71 and #75. Comments and footnotes (BayooG) — upstream v1.2.0 and #34. EMF and WMF images (BayooG, miguelfreitas) — #35. Paragraph and run shading (miguelfreitas) — 2.0.0.Settings.track_revisionsand listnumId/ilvlaccess (revvsaleshyperlink) — #74 and #73. Multi-column sections andw:cols(Yiqing-Zhou) — #78. Cell vertical alignment (VanOordfeature/cell-vert-align) — upstream. Theme font names onw:rFonts(br-rkdrnffeature/fix-eastAsiaFont-bug, BayooGfeature/fontTheme) — #79. Table and cell borders (BayooGfeature/tblBoard) — #38.Section.paragraphs(DQinYuan) — replaced bySection.iter_inner_content(). TOC and bibliography field insertion (VanOord) — #80.Looked at and deliberately not filed
word/fontTable.xml(br-rkdrnffnttbl.py) — embedded-font bookkeeping with no read or write use case that stands on its own. Mentioned in Expose the theme part and resolve theme typefaces to real font names #96 as adjacent; not worth a part class by itself.xl, aWorkbook()entry point and ~45x:element classes) — out of scope. This is a WordprocessingML library; anyone needing.xlsxwants openpyxl.BIBLIOGRAPHYandCITATIONfields (VanOord) —add_field()already writes any instruction, so the only genuinely missing piece is theword/bibliography/sources.xmlpart. Narrow enough to leave until someone asks.Paragraph.merge_paragraph()/append_runs()/header_level/is_heading(BayooG) — one-line conveniences overstyle.nameand run splicing, all expressible with the current API.CustomXMLproxy — hardcoded to their own schema (address,approved_by,client_name). The generic version of the underlying capability is Expose the custom XML data store parts (customXml/item1.xml) #100.enum-docsandfeature/highlight— enum docstring improvements against v0.8.5-v0.8.9, long since superseded upstream. Nothing to port.background-image— carries a vendor template and sample documents rather than a feature.