MultiPages
Page handling tool

Provided by fr.OpenOffice.org Project

Table of Contents

1 Introduction	3

1.1 Document evolution	3

1.2 Add-on evolution	3

2 Installing MultiPages add-on	3

2.1 Installing on OpenOffice.org version 2	3

2.2 Installing on OpenOffice.org version 1.1	4

3 Tool usage	6

3.1 General	6

3.2 Deleting pages	7

3.3 Adding or duplicating pages	7

3.4 Renaming pages	9

3.5 Changing the order of the pages	9

4 Credits	10

5 Licences	11

5.1 Documentation	11

5.2 Macro library	11

Introduction

This document describes an add-on tool which simplifies the handling of Calc, Draw, Impress documents containing many pages (several tens or even hundreds of pages).

After installation Multipages tool is accessible with a click on a new button in a tool bar. A panel is displayed which lets you :

quickly choose the current page among many pages,

add many empty pages in one action,

duplicate many empty pages in one action,

delete many empty pages in one action,

rename many pages more easily than with usual method,

change the order of the pages (only with Calc).

Document evolution

Version 1.1

this is the first english version

explains how to install on OpenOffice.org version 2

update of screenshots and feature descriptions.

Add-on evolution

Version 1.1 :

this is the first english version

works with Impress

avoids creating two pages of the same name (Draw, Impress)

reworking of user interface and on-line help.

Installing MultiPages add-on

Notice : you must extract the add-on file MultiPages.zip from the downloaded archive MultiPages1.1_fr.zip.

Installing on OpenOffice.org version 2

Open OpenOffice, menu Tools > Package Manager > Add

Select file Multipages.zip and click on “ Open ” to start add-on installation. After installation open a new Calc document : you will see a small floating toolbar with a new icon. Put the toolbar at your convenience. Repeat operation with a new document Draw.

Use the same Package Manager panel to uninstall the add-on. To update the add-on, first uninstall the current version, then install the new one.

Installing on OpenOffice.org version 1.1

Installation requires more attention and some experience of computer science.

Work directories

If OpenOffice is network-installed, with a kernel on a server and thin client in each PC, you may install the add-on :

for some users,

or for all OpenOffice users.

The command-line tool pkgchk is used to install add-ons. It can install :

either a specific add-on, indicated in the command line

or all add-ons it will find in a default directory. There are two default directories :

For addons specific to a user the default directory is
{installation}/user/uno_packages
this translates to, for a Windows XP installation
C:\Program Files\OpenOffice.org1.1\user\uno_packages

For network-wide addons the default directory is
{installation}/share/uno_packages

The pkgchk tool is in the directory :
{installation}/program
this translates to, for a Windows XP local installation
C:\Program Files\OpenOffice.org1.1\program

Running pkgchk

You have to work at command line to run pkgchk. It is advisable to prepare a batch file (MS-Windows) or a shell script (Unix).

The current directory must be {installation}/program

It is mandatory to stop all execution of OpenOffice before running pkgchk. You must also stop the QuickStarter of OpenOffice (MS-Windows version). In the network every OpenOffice must be stopped. Without these precautions the OpenOffice installation may be damaged. Pkgchk tests if OpenOffice runs locally, but it cannot detect this on a network installation.

Installing add-on for a single user

Put MultiPages.zip into {installation}/user/uno_packages

Run this very simple command :

pkgchk

Or else if you want to display a report during execution, add the option -v :

pkgchk -v

Installing add-on on a network

Put MultiPages.zip into {installation}/share/uno_packages

Run the command :

pkgchk --shared

Deleting add-on

Delete MultiPages.zip from the default directory.

Run the command :

pkgchk

or :

pkgchk --shared

Explanation : pkgchk will update all addons depending on the contents of the default directory. Those which exist no more will be deleted.

Tool usage

General

A new icon appears in a toolbar of Calc and Draw applications. It does not appear in Impress because on OpenOffice.org version 2.0 this toolbar would also appear during slide show (see issue IZ 52712).

In applications Calc, Draw and Impress a new Add-on item appears in the Tools menu, with a sub-item called “ Page handling ”.

Click on the icon or the menu sub-item to display the main panel of MultiPages :

Within zone “ Browse pages ” you may choose the page (or sheet, or slide) to be displayed. The drop-down list of pages may be displayed in the current order or in alphabetical order.

Click on one of the buttons in zone “ Action on pages ” to see a secondary panel. Note that added or duplicated pages are placed after the currently visible page. After the action is executed the secondary panel vanishes and you may choose another action or close the main panel.

The “ Help ” button displays some explanations. But you’d better try some manipulations with an empty new document.

Deleting pages

Select the page or pages to be deleted. Attention ! Button “ Delete ” definitively suppresses the selected pages without warning.

Adding or duplicating pages

The page duplication panel is similar to the page addition panel here above.

If you add a single page you may choose any name for this page.

You may add up to 100 pages in a single addition or duplication. To add several pages it is mandatory that each page have a different name. Enter a generic name having one to four contiguous # characters, e.g. :

Week ##

Year 20## Profits

#Dollar

The sequence of # will be replaced by a number with the same number of digits and non significant zeros if necessary. If there is not enough # the least significant digits of the number will be used.

Numbers take successive values fro the first number to the last number indicated. Examples of successive numbers :

03, 04, 05, 06

95, 94, 93, ... 10, 09, 08, 07

00, 01, 02, ... 99

Limitations about the page names

Some characters are forbidden in a page name, e.g. #.

It is not possible to have two pages of the same name. For example if you add more than 10 pages and the generic name contains only one # you will get an error message.

How many pages may I have ?

Calc allows a maximum of 256 pages (called sheets).

Draw et Impress don’t have explicit limits but MultiPages limits itself to 3000 pages. On version 1.1 of OpenOffice a file of more than 1000 pages was successfully created (most pages were empty). Opening and closing this file took more than one minute. Some display anomalies were sometimes seen at more than 256 pages.

Renaming pages

Change the right side of the pages names and click on “ Rename ” button.

Changing the order of the pages

With action “ Change order ”, only available with Calc, you may put pages in alphabetical order, paying or not attention to the case of the letters.

You may also obtain an arbitrary order by editing the list with selection/move, modification, or copy/paste.

Credits

Auteur: Bernard Marcelly

Thanks to :

Intégrated by : Sophie Gautier

Last modified : October, 30, 2005

Contacts : OpenOffice.org Documentation project http://fr.openoffice.org

Translation :

English : Bernard Marcelly – November, 10, 2005

Licences

Documentation

Appendix

Public Documentation License Notice

The contents of this Documentation are subject to the Public Documentation License Version 1.0 (the "License"); you may only use this Documentation if you comply with the terms of this License. A copy of the License is available at http://www.openoffice.org/licenses/PDL.html.

The Original Documentation is : Outil de gestion de pages

The Initial Writer of the Original Documentation is Bernard Marcelly

Copyright (C) 2003-2005. All Rights Reserved. (Initial Writer contact(s): marcelly@club-internet.fr )

Contributor(s): ______________________________________.

Portions created by ______ are Copyright (C)_________[Insert year(s)].

All Rights Reserved. (Contributor contact(s):________________[Insert hyperlink/alias]).

NOTE: The text of this Appendix may differ slightly from the text of the notices in the files of the Original Documentation. You should use the text of this Appendix rather than the text found in the Original Documentation for Your Modifications.

Macro library

General information on LGPL is available on this Web site.

Une traduction non-officielle de la license LGPL est disponible sur ce site.

The library Multipages included in the add-on MultiPages.zip is a tool which handles multiple pages in OpenOffice Calc, Draw, Impress, documents. Copyright (C) 2003-2005 Bernard Marcelly

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

fr.OpenOffice.org

- Back to Table of Contents	11/11

Bernard M.

2003-11-03T14:54:58