incubator-odf-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "DaLi Liu (JIRA)" <j...@apache.org>
Subject [jira] [Resolved] (ODFTOOLKIT-329) Add a new Simple API to generate a table of content in text document
Date Fri, 07 Dec 2012 06:59:21 GMT

     [ https://issues.apache.org/jira/browse/ODFTOOLKIT-329?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

DaLi Liu resolved ODFTOOLKIT-329.
---------------------------------

    Resolution: Fixed
      Assignee: DaLi Liu
    
> Add a new Simple API to generate a table of content in text document
> --------------------------------------------------------------------
>
>                 Key: ODFTOOLKIT-329
>                 URL: https://issues.apache.org/jira/browse/ODFTOOLKIT-329
>             Project: ODF Toolkit
>          Issue Type: New Feature
>          Components: simple api
>    Affects Versions: 0.8.6
>            Reporter: DaLi Liu
>            Assignee: DaLi Liu
>             Fix For: 0.8.6
>
>         Attachments: tocsupport.patch
>
>   Original Estimate: 672h
>  Remaining Estimate: 672h
>
> Dear all,
> I want to generate a table of content by ODF toolkit Simple API. But it seems that there
doesn't exist such method. So I proposal to add a new API createTOC to Simple API.
> Specification: parameters for the new API are: 1. position/location of TOC, 2. TOC style
to be used
> ODFToolkit API: TextDocument.createTOC(positionElement, TOCStyle).
> Discuss with Rob Weir:
> Rob:
>      Also, it would be good to discuss how you will enter a ToC.   If you
>     do this operation in a word processor, like OpenOffice, you see it
>     does two things:
>     1) Enter the markup for <text:table-of-content> that defines the
>     structure and style relations for the table of contents.
>     2) Gather the header text from elsewhere in the document and enter
>     that, along with page references, into a <text:index-body>
>     Doing #1 is easy.  But #2 is very difficult.  Why?  Because until you
>     do a full layout of the document, taking into account font metrics,
>     line breaking algorithms, hyphenation, image positioning, "orphan and
>     widow" rules, etc., you don't know what content is on which page.
> DaLi: yeah, you are right, the page number will be difficult issue.
> Rob:
>     So the easiest thing is to just do #1 and then have the user do an
>     "Update Table" operation in the word process the next time the
>     document is loaded.
> Dali:I will try to do #1 first.
> Rob:
>     Next easiest is to collect the header text to put in the ToC, but not
>     try to calculate the page numbers, leaving that to be calculated when
>     the document is loaded in a full word processor.
>  
> Dali:After finish #1, will consider this.
> Any comments are welcome

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Mime
View raw message