[Typo3-doc] Page numbering

[Charlie Dale]

Hi Matthew,

Yep I understand what you're saying now. When I read the docs I tend to do
it online so I haven't noticed the page number issue which would be obvious
when you print.

This is really simple to fix for a particular document, but difficulty to
fix for all of them. OOo Writer requires the author/editor to update the
contents manually. You just right click the Contents and select "Update
Index/Table". Or go to Tools > Update > All Indexes and Tables. Apparently
many writers forget to do this after they make some pages and the text
reflows.

Incredibly, there seems to be no way to do this update automatically in OOo
Writer.

Perhaps we could add a macro to the standard template that does an Update
All on a Save Document event? The following macro would work (auto-generated
by Writer itself):

sub UpdateToC
  dim document   as object
  dim dispatcher as object
  document   = ThisComponent.CurrentController.Frame
  dispatcher = createUnoService("com.sun.star.frame.DispatchHelper")
  dispatcher.executeDispatch(document, ".uno:UpdateAllIndexes", "", 0,
Array())
end sub

Do people think it would be worth doing this? Maybe just wait for the new
DocBook mechanism?

Cheers,
Charlie

On Wednesday, 9 November 2005 21:57, Matthew Manderson wrote:

> Maybe it is only me but, in several of my printed docs the contents
> page numbers do not tally with the actual page numbers. 
> 
> eg.
> 
> TypoScript Oct 5 2002 contents say that 'PHP include scripts' is at
> page 184 when in fact it is at 179. 
> 
> So by calling 'PHP include scripts' say '13. PHP include scripts' and
> marking each section in the docs with 12, 13 etc. It is easy to scan
> the pages and find the section you need. Section 13 will always be
> after 12 and before 14. Whereas relying on page numbering means when
> formatting or additions forces a page over to another the author
> needs to go back and re index.     
> 
> This has the the additional problem of different versions having
> different page numbers so there is no consistent references across
> the versions of docs.  
> 
> Going back to why it is a 'serious' although I would not call it
> that. Is this. 
> 
> I need to find out about cObject TEXT and the content pages says it
> is at page 87. So I look on page 87 and I see COBJ_ARRAY instead. 
> 
> Not very helpful.
> 
> The second reason is there is no easy way of jumping fromm offline
> docs .sxw to online docs and finding the same section. 
> 
> How does that sound?
> 
> Matthew
> _______________________________________________
> Typo3-project-documentation mailing list
> Typo3-project-documentation at lists.netfielders.de 
>
http://lists.netfielders.de/cgi-bin/mailman/listinfo/typo3-project-documenta
tion