René's URL Explorer Experiment


Title: Add independent list instances and continuation paragraphs by pseudosavant · Pull Request #1614 · python-openxml/python-docx · GitHub

Open Graph Title: Add independent list instances and continuation paragraphs by pseudosavant · Pull Request #1614 · python-openxml/python-docx

X Title: Add independent list instances and continuation paragraphs by pseudosavant · Pull Request #1614 · python-openxml/python-docx

Description: Problem Paragraph styles alone do not give document generators control over list identity, starting numbers, or unnumbered continuation paragraphs. This adds a draft public API for those operations using numbering already present in a document or template. API Document.add_list(style="List Number", start=1, level=None) creates an independent sequence. ListInstance.apply(paragraph, level=None) numbers a paragraph without changing its style. restart(start=1, level=None) returns an independent sequence. apply_continuation(paragraph, level=None) suppresses numbering and preserves text alignment. levels and default_level expose template level selection. A caller resumes a sequence by applying the same handle again. Separate abstract definitions preserve independent counters when sequences are interleaved. In Word, sharing an abstract definition caused a 3, 4, 1, 5 sequence to display 3, 4, 1, 2. The implementation copies the original definition and instance overrides without changing template definitions. This intentionally starts with template-backed list authoring in the main story and table cells. It does not add arbitrary numbering-format authoring or numbering-style-link resolution. Undefined levels, invalid starts, and cross-document use are rejected before mutation. Continuation formatting is a snapshot. Word has no list-item container. Validation 1,634 unit tests and 652 acceptance scenarios passed against this branch based on upstream master. New coverage includes independent starts and restarts, interleaved sequences, multi-paragraph items, template overrides, invalid references, and cross-document validation. Microsoft Word verified starts, interleaved restart behavior, continuation indentation, and multilevel numbering with nested restarts. Includes a Word-authored multilevel fixture and documentation of the observed behavior. Design discussion Related work includes #210 and #582. This draft focuses on a small public authoring API rather than a general numbering editor. API names, supported scope, and XML helper boundaries are open for review. My current downstream consumer is markdown-docx, and I can adapt it to upstream conventions. This branch contains isolated feature commits based directly on upstream master. It has no fork packaging, version changes, or dependency on the fork's other features.

Open Graph Description: Problem Paragraph styles alone do not give document generators control over list identity, starting numbers, or unnumbered continuation paragraphs. This adds a draft public API for those operations...

X Description: Problem Paragraph styles alone do not give document generators control over list identity, starting numbers, or unnumbered continuation paragraphs. This adds a draft public API for those operations...

Opengraph URL: https://github.com/python-openxml/python-docx/pull/1614

X: @github

direct link

Domain: github.com

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:508d7b1d-32e9-30a2-214f-d8a5a05e78dd
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idEA6E:395D20:3BAD2E:51C462:6AFF6C12
html-safe-noncee156d50ba004a884425c1f6f8d8e212682ab36fc2f732a666aa5636ff277f49a
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJFQTZFOjM5NUQyMDozQkFEMkU6NTFDNDYyOjZBRkY2QzEyIiwidmlzaXRvcl9pZCI6Ijg5MjYxOTc4MTQwMTEwNjMzMTQiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmac46108d6ddd8a0c7ff107cfe9d9b844e2b9c6cd5aab60496db6eca2fcba18fe96
hovercard-subject-tagpull_request:4629652403
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/python-openxml/python-docx/pull/1614/files
twitter:imagehttps://avatars.githubusercontent.com/u/455424?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/455424?s=400&v=4
og:image:altProblem Paragraph styles alone do not give document generators control over list identity, starting numbers, or unnumbered continuation paragraphs. This adds a draft public API for those operations...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None6d580fc7098c193d7866bf290c4c2b4859a153e87379f44161f35a4495e6b730
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/python-openxml/python-docx git https://github.com/python-openxml/python-docx.git
octolytics-dimension-user_id3403760
octolytics-dimension-user_loginpython-openxml
octolytics-dimension-repository_id13592924
octolytics-dimension-repository_nwopython-openxml/python-docx
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id13592924
octolytics-dimension-repository_network_root_nwopython-openxml/python-docx
turbo-body-classeslogged-out env-production page-responsive full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
releaseec5dd94a369dad6e9ce618a1705cbe3b618a2863
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/python-openxml/python-docx/pull/1614/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython-openxml%2Fpython-docx%2Fpull%2F1614%2Ffiles
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython-openxml%2Fpython-docx%2Fpull%2F1614%2Ffiles
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=python-openxml%2Fpython-docx
Reloadhttps://github.com/python-openxml/python-docx/pull/1614/files
Reloadhttps://github.com/python-openxml/python-docx/pull/1614/files
Reloadhttps://github.com/python-openxml/python-docx/pull/1614/files
python-openxmlhttps://github.com/python-openxml
python-docxhttps://github.com/python-openxml/python-docx
Codehttps://github.com/python-openxml/python-docx
Issues387 (387)https://github.com/python-openxml/python-docx/issues
Pull requests167 (167)https://github.com/python-openxml/python-docx/pulls
Actionshttps://github.com/python-openxml/python-docx/actions
Projectshttps://github.com/python-openxml/python-docx/projects
Wikihttps://github.com/python-openxml/python-docx/wiki
Security and qualityhttps://github.com/python-openxml/python-docx/security
Insightshttps://github.com/python-openxml/python-docx/insights
Sign up for GitHub https://github.com/signup?return_to=%2Fpython-openxml%2Fpython-docx%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fpython-openxml%2Fpython-docx%2Fissues%2Fnew%2Fchoose
pseudosavanthttps://github.com/pseudosavant
python-openxml:masterhttps://github.com/python-openxml/python-docx/tree/master
pseudosavant:codex/list-numbering-upstreamhttps://github.com/pseudosavant/python-docx/tree/codex/list-numbering-upstream
Conversation 0 https://github.com/python-openxml/python-docx/pull/1614
Commits 3 https://github.com/python-openxml/python-docx/pull/1614/commits
Checks 0 https://github.com/python-openxml/python-docx/pull/1614/checks
Files changed https://github.com/python-openxml/python-docx/pull/1614/files
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/1614/files
Add independent list instances and continuation paragraphs https://github.com/python-openxml/python-docx/pull/1614/files#top
Show all changes 3 commits https://github.com/python-openxml/python-docx/pull/1614/files
a0fe7df Add independent list instances and continuation paragraphs pseudosavant Sep 24, 2026 https://github.com/python-openxml/python-docx/pull/1614/commits/a0fe7df78a823b7bae123e5777f0ec177e17d17f
cc85ffc Keep list style casts compatible with Python 3.9 pseudosavant Sep 24, 2026 https://github.com/python-openxml/python-docx/pull/1614/commits/cc85ffcbb2319e18fbadecd7751931bde5a721ba
8b7f2db Expose list continuation indentation for nested blocks pseudosavant Sep 24, 2026 https://github.com/python-openxml/python-docx/pull/1614/commits/8b7f2db53c1242ee3d3cc1784433261253366902
Clear filters https://github.com/python-openxml/python-docx/pull/1614/files
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/1614/files
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/1614/files
document.rst https://github.com/python-openxml/python-docx/pull/1614/files#diff-ef044ca2b76645256f92cb3845195fdaadacf2c037df270d2f803ff41bf007fa
index.rst https://github.com/python-openxml/python-docx/pull/1614/files#diff-8d068e8797e88947c320f79e856c3e16a72b730124a8f9d7031e2c4680dfa534
lists.rst https://github.com/python-openxml/python-docx/pull/1614/files#diff-ba2c9608f78375ca0a65068f05d3b07bd5ba716835268b7481b43a3115d65f69
num-list-instance.feature https://github.com/python-openxml/python-docx/pull/1614/files#diff-5a101b3980aa056cc9a08fbb5419d77a90f53cebf44f0c0ea5d05d3f13e59ffc
list_instance.py https://github.com/python-openxml/python-docx/pull/1614/files#diff-f9b1f2c1ad82707382f8e38204d55f539603b4a2eacf40490174c172df21c1c6
document.py https://github.com/python-openxml/python-docx/pull/1614/files#diff-8b5aed35cea2e719e419af099e5d7d2f6ff97b5737b5329dcf66c57031999541
numbering.py https://github.com/python-openxml/python-docx/pull/1614/files#diff-70529ac37bfcde8351faa320fdabd7a97c5c14c7e4a1f81e656bf1311798d17b
numbering.py https://github.com/python-openxml/python-docx/pull/1614/files#diff-18fce1dea4f601a7ba39f5504ffb117344dd57ff0a1d9f3c3267632ce75cfe7c
parfmt.py https://github.com/python-openxml/python-docx/pull/1614/files#diff-37c7a9dae166871f81fd1efa89fac0bf6e41c7aa7148fcde2556bb1e6943d37e
numbering-word.docx https://github.com/python-openxml/python-docx/pull/1614/files#diff-a2a39f2a48dd7b33987ca2e99687309cad43ee108147297e2db01713c4b71f11
numbering-word.rst https://github.com/python-openxml/python-docx/pull/1614/files#diff-a603e95a1106ea79bc0f0efcd42308cdf524bc75bb6bdf2ea734d5bdfb98d980
test_numbering.py https://github.com/python-openxml/python-docx/pull/1614/files#diff-2582a41514af2c88d1e32e1218172de7bf656c65aa85d882f2593168e1eecf59
docs/api/document.rsthttps://github.com/python-openxml/python-docx/pull/1614/files#diff-ef044ca2b76645256f92cb3845195fdaadacf2c037df270d2f803ff41bf007fa
View file https://github.com/python-openxml/python-docx/blob/8b7f2db53c1242ee3d3cc1784433261253366902/docs/api/document.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1614/{{ revealButtonHref }}
https://github.com/python-openxml/python-docx/pull/1614/files#diff-ef044ca2b76645256f92cb3845195fdaadacf2c037df270d2f803ff41bf007fa
https://github.com/python-openxml/python-docx/pull/1614/files#diff-ef044ca2b76645256f92cb3845195fdaadacf2c037df270d2f803ff41bf007fa
docs/index.rsthttps://github.com/python-openxml/python-docx/pull/1614/files#diff-8d068e8797e88947c320f79e856c3e16a72b730124a8f9d7031e2c4680dfa534
View file https://github.com/python-openxml/python-docx/blob/8b7f2db53c1242ee3d3cc1784433261253366902/docs/index.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1614/{{ revealButtonHref }}
https://github.com/python-openxml/python-docx/pull/1614/files#diff-8d068e8797e88947c320f79e856c3e16a72b730124a8f9d7031e2c4680dfa534
https://github.com/python-openxml/python-docx/pull/1614/files#diff-8d068e8797e88947c320f79e856c3e16a72b730124a8f9d7031e2c4680dfa534
docs/user/lists.rsthttps://github.com/python-openxml/python-docx/pull/1614/files#diff-ba2c9608f78375ca0a65068f05d3b07bd5ba716835268b7481b43a3115d65f69
View file https://github.com/python-openxml/python-docx/blob/8b7f2db53c1242ee3d3cc1784433261253366902/docs/user/lists.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1614/{{ revealButtonHref }}
features/num-list-instance.featurehttps://github.com/python-openxml/python-docx/pull/1614/files#diff-5a101b3980aa056cc9a08fbb5419d77a90f53cebf44f0c0ea5d05d3f13e59ffc
View file https://github.com/python-openxml/python-docx/blob/8b7f2db53c1242ee3d3cc1784433261253366902/features/num-list-instance.feature
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1614/{{ revealButtonHref }}
features/steps/list_instance.pyhttps://github.com/python-openxml/python-docx/pull/1614/files#diff-f9b1f2c1ad82707382f8e38204d55f539603b4a2eacf40490174c172df21c1c6
View file https://github.com/python-openxml/python-docx/blob/8b7f2db53c1242ee3d3cc1784433261253366902/features/steps/list_instance.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1614/{{ revealButtonHref }}
src/docx/document.pyhttps://github.com/python-openxml/python-docx/pull/1614/files#diff-8b5aed35cea2e719e419af099e5d7d2f6ff97b5737b5329dcf66c57031999541
View file https://github.com/python-openxml/python-docx/blob/8b7f2db53c1242ee3d3cc1784433261253366902/src/docx/document.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1614/{{ revealButtonHref }}
https://github.com/python-openxml/python-docx/pull/1614/files#diff-8b5aed35cea2e719e419af099e5d7d2f6ff97b5737b5329dcf66c57031999541
https://github.com/python-openxml/python-docx/pull/1614/files#diff-8b5aed35cea2e719e419af099e5d7d2f6ff97b5737b5329dcf66c57031999541
https://github.com/python-openxml/python-docx/pull/1614/files#diff-8b5aed35cea2e719e419af099e5d7d2f6ff97b5737b5329dcf66c57031999541
https://github.com/python-openxml/python-docx/pull/1614/files#diff-8b5aed35cea2e719e419af099e5d7d2f6ff97b5737b5329dcf66c57031999541
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/1614/files
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.