René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Feature Request: Paragraph.get_listnum()","articleBody":"following from #180 #25 #217 ...  especially #25 \r\n\r\nProposed Feature:  Paragraph method computing/yielding a string of the paragraph number/heading as it would appear in the open microsoft word document (e.g. '9.1', '(a)', '(i)', 'Article III',  etc.) ; \r\n\r\nIn obtaining the above, assuming (based on very preliminary review of this helpful article: [https://msdn.microsoft.com/en-us/library/office/ee922775(v=office.14).aspx](https://msdn.microsoft.com/en-us/library/office/ee922775(v=office.14).aspx) that the following need to first be obtained (let me know what's missing!)\r\n(i) the abstract numbering format\r\n(ii) the level of current paragraph within numbered list if nested e.g. ('9.' in example below would be level1 and '9.1' would be level2\r\n(iii) the index of the current paragraph within the immediate nested list  ('(a)' index 0 , '(b)' index 1 etc).  \r\n(iv) overrides? \r\n\r\nif preferred, the get_listnum() method could return a  tuple of (numText, format, level, index) --\u003e (\"9.1\", '%1.%2' , 2, 0)\r\n\r\n\r\nFor example, \r\n\r\n###### \u003ci\u003e when open in microsoft word the docx appears as below:\u003c/i\u003e \r\n\r\n### \u003chr\u003e\r\n### SECTION 5\u003c/b\u003e \u003c/br\u003e INTEREST PAYMENTS\u003c/div\u003e\r\n\r\n### 9.          INTEREST\r\n\r\n#### 9.1       Calculation of interest\r\n\r\nThe rate of interest on each Loan for each period is the percentage rate per annum which is the aggregate of the applicable:\r\n\r\n##### (a)        margin; and\r\n\r\n##### (b)       LIBOR.\r\n### \u003chr\u003e\r\n\r\n\r\n###### \u003ci\u003e currently,  (paragraph.text, paragraph.style) yields:\u003c/i\u003e \r\nSECTION 5 INTEREST PAYMENTS  ,  _ParagraphStyle(\"Normal\")\r\n INTEREST , _ParagraphStyle(\"Style1\")\r\n Calculation of interest , _ParagraphStyle(\"Style2\")\r\nThe rate of interest on each Loan for each period is the percentage rate per annum which is the aggregate of the applicable:\r\nmargin; and , _ParagraphStyle(\"Style3\")\r\nLIBOR. _ParagraphStyle(\"Style3\")\r\n\r\nparagraph.listnum_text() would yield:\r\n''\r\n'9.'\r\n'9.1'\r\n''\r\n'(a)'\r\n'(b)' \r\netc.\r\n\r\nThoughts, comments?  Interest in a concerted effort to finally solve this issue and add it to the library?  I realise a lot of people have already spent significant time on this and that there are a bunch of pitfalls I'm not considering (if it were that easy, we'd have the feature already...)\r\n\r\nStill, I feel like if you solved this you could basically circumvent microsoft word entirely! \r\n\r\n","author":{"url":"https://github.com/nikeqiang","@type":"Person","name":"nikeqiang"},"datePublished":"2018-02-07T13:52:22.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":7},"url":"https://github.com/471/python-docx/issues/471"}