Dhen storing an OpenOiiiiecorg X L doiSment on disks the OpenOiiiiecorg soittare aatays Sses the sSbdoiSment iormats there eaih sSbdoiSment is stored as one entry in the oreraaa paikagec This method is based on the popSaar 1 P iiae iormatc The sSbdoiSments that OpenOiiiiecorg sSpports and the names that are Ssed in the paikage are sSmmariked in the ioaaoting tabae:
hrtnor meta.xml styles.xml content.xml settings.xml RnniET 1 hrtnor 1inDoiSment meta iniormations sSih as the aSthor or the time oi the aast sare aitionc tyaes Ssed in the doiSment iontent and aStomatii styaes Ssed in the styaes themsearesc DoiSment iontent and aStomatii styaes Ssed in the iontentc ppaiiation-speiiiii settingss sSih as the tindot sike or printer iniormationc
<office:tocument-meta< <office:tocument-styles< <office:tocument-content< <office:tocument-settings<
The deiinitions oi the root eaements desiribed in the tabae abore are anaaogoSs to the deiinition oi <office: tocument<s e.iept that the ihiad eaement speiiiiiation is sSitabay restriitedc
0c c4 Primary DoiSment Charaiteristiis
YoS deiine primary doiSment iharaiteristiis in the doiSment root eaement Ssing the ioaaoting attribStes:

Caass Version

Chapter O Introduction to OpenOffice.org XML
The office:class attribSte identiiies the doiSment iaass oi an OpenOiiiiecorg X L doiSmentc DoiSment iaasses that yoS ian assign are as ioaaots:
Te.t Gaobaa doiSment preadsheet Drating Presentation
athoSgh the doiSment strSitSre is the same ior aaa doiSment iaassess most appaiiations ian onay deaa tith a iertain iaass oi doiSmentsc For e.ampaes ii yoS read a spreadsheet doiSment Ssing a tord proiessor appaiiation there is aatays some aoss oi iniormationc The iaass attribSte enabaes an appaiiation to deteit the doiSment iaass tithoSt parsing the doiSmentc This is partiiSaaray SseiSa in the ioaaoting sitSations:
Dhen appaiiations ian deaa tith sereraa doiSment iaassesc Dhen an rh transiormation to another iormat shoSad be appaieds and there are sereraa styaesheets araiaabae there eaih styaesheet is speiiiii to a iertain doiSment iaassc office:class YoS mSst speiiiy a doiSment iaass attribSte ior erery OpenOiiiiecorg X L doiSmentc <!ATTLIST office:tocument office:class (text|text-global| spreatsheet|trawing|presentation|charty teEt|IeEt<

rg int Ti RrT 9T ooTi

Version
n OpenOiiiiecorg X L iiae ian iontain the rersion nSmber oi the iiae iormatc The rersion nSmber is in the iormat revision.versionc i the iiae has a rersion and the OpenOiiiiecorg appaiiation reiognikes the DTD that beaongs to this rersions it may raaidate the doiSmentc Othertises the appaiiation does not need to raaidate the doiSments bSt the doiSment mSst be A TTienI tc The office:version attribSte prorides the rersion nSmber oi the doiSmentc rg int Ti RrT 9T ooTi n 9Ti office:version The version attribSte is attaihed to the root eaementc <!ATTLIST office:tocument office:version CtATA tIMPLIEt< The rersion nSmber oi the teihniiaa preriet is 2c c t some eaementss yoS ian attaih iSstom attribStess thiih OpenOiiiiecorg appaiiation keeps in iase the doiSment is e.portedc i yoS Sse this ieatSres then there mSst be no rersion nSmbers beiaSse this ioSad resSat in raaidating errors that prerent the doiSment irom aoadingc

0c4 DoiSment niormation

n this manSaas iniormation aboSt an OpenOiiiiecorg X L doiSment is iaaaed 4t44c E.ampaes oi metadata are:

DoiSment titae

Technical Reference Manual Version 2 December 2ee2
Sthor DoiSment ireation date
YoS speiiiy metadata tithin the <office:meta< eaementc rg int Ti RrT 9T ooTi <office:meta< This eaement iontains metadatac <!ENTITY % meta "(meta:generator?,tc:title?, tc:tescription?,tc:subiect?, meta:initial-creator?,meta:creation-tate?, tc:creator?,tc:tate?, meta:printet-by?,meta:print-tate?, tc:keyworts?,tc:language?, meta:etiting-cycles?,meta:etiting-turation?, meta:hyperlink-behaviour?,meta:auto-reloat?, meta:template?,meta:user-tefineta, meta: tocument-statistics?y <!ELEMENT office:meta %meta;< n the DTDs the eaement names iorrespond to the DSbain Core Eaement et ihttp:sspSracoiaic orgsdisoc This is indiiated by the tc namespaie preii.c
n OpenOiiiiecorg X L doiSment iontains the ioaaoting types oi 9yT 9: nn1i9yT 9 The X L representations oi the styaes that are araiaabae in the OpenOiiiiecorg Sser interiaie are reierred to as styaess ors there a diiierentiation irom the other types oi styaes is reqSireds they are reierred to as iommon styaesc The term common indiiates that this is the type oi styae that an OpenOiiiiecorg Ssers tho is not interested in the OpenOiiiiecorg X L iiae iormats ionsiders to be a styaec Arn4uoi9yT 9 n aStomatii styaeiiontains iormatting properties thats in the Sser interiaie riet oi a doiSments are assigned to an objeit sSih as a paragraphc The term automatic indiiates that the styae is generated aStomatiiaaay at e.port timec n other tordss iormatting properties that are immediateay assigned to a speiiiii objeit are represented by an aStomatii styae tithin an OpenOiiiiecorg X L doiSmentc This tays a separation oi iontent and aayoSt is aihieredc g49 Ii9yT 9 master styae is a iommon styae that iontains iormatting iniormation and additionaa iontent that is dispaayed tith the doiSment iontent then the styae is appaiedc n e.ampae oi a master styae is an OpenOiiiiecorg Drat master pagec n this iases the additionaa iontent is any shapes that are dispaayed as the baikgroSnd oi the drat pagec nother e.ampae oi master styaes are page mastersc n this iases the additionaa iontent is the headers and iootersc Paease note that the iontent that is iontained tithin master styaes is additionaa iontent that iniaSenies the representation oi a doiSment bSt does not ihange the iontent oi a doiSmentc

E4oT TinTy.n14Tiu4. i4oi4I 4 The eaement shotn in the ioaaoting e.ampae deiines a triangae that is aoiated in the middae oi a im by im imagec The boSnding bo. iorers an area oi im by 0c5imc One riet bo. Snit iorresponds to 2c20mmc <traw:area-polygon svg:xp"0" svg:yp"0" svg:witthp"2.0cm" svg:heightp"2.0cm" svg:viewBoxp"2000 2000" svg:pointsp":00,1400 1:00,1400 1000,:00"/<

Common mage

ap ttribStes

L and aink target iramec

n addition to the shape attribStess eaih image map eaement ian iontain the ioaaoting iniormation: Links iniaSding a
Namec naitire iaagc Desiriptionc se the <svg:tescription< ihiad eaementc Erents assoiiated tith the areac se the <office:events< ihiad eaementc
Other attribStes oi the image maps are taken irom the OT L image map representationc Eaih image map eaement identiiies a hyperaink and Sses the Xaink hrefs types and show attribStess and the office:target-frame-name attribSte to desiribe the ainkc
rg int T RrT 9T ooi 4oT T
xlink:href <!ATTLIST <!ATTLIST <!ATTLIST <!ATTLIST tIMPLIEt< traw:area-polygon traw:area-polygon traw:area-polygon traw:area-polygon xlink:href %url; tIMPLIEt< xlink:type (simpley tIMPLIEt< xlink:show (new|replacey tIMPLIEt< office:target-frame-name CtATA
The office:name attribSte assigns a name to eaih image map eaementc
office:name <!ATTLIST traw:area-polygon office:name CtATA tIMPLIEt< L
The traw:nohref attribSte deiaares that the image map eaement and the assoiiated area is inaitirec The that is iontained in the image map eaement is not Ssedc
traw:nohref <!ATTLIST traw:area-polygon traw:nohref (nohrefy tIMPLIEt<
n OT Ls this is aihiered by Ssing the nohref attribStec

NSmber Format

The OpenOiiiiecorg X L nSmber iormat ionsists oi three parts:
Preii. P the te.t that is dispaayed beiore the nSmber Dispaay iormat speiiiiiations ior e.ampaes s Bs Cs or 0s s 4 Siii. P the te.t that is dispaayed aiter the nSmber

c c0 Preii. and Siii.

The style:num-prefix and style:num-suffix attribStes speiiiy that to dispaay beiore and aiter the nSmberc
style:num-prefix and style:num-suffix
i the preii. and sSiii. do not iontain aaphanSmerii iharaiterss an X LT format attribSte ian be ireated irom the OpenOiiiiecorg attribStes by ioniatenating the raaSes oi the style:numprefixs style:num-format, and style:num-suffix attribStesc
<!ATTIST style:properties style:num-prefix CtATA tIMPLIEt< <!ATTIST style:properties style:num-prefix CtATA tIMPLIEt<
Dithin the X LT format attribStes the preii. and sSiii. ian onay be non-aaphanSmerii iharaitersc This restriition does not appay to OpenOiiiiecorg soittarec

c c Format peiiiiiation

The style:num-format attribSte speiiiies the iormat oi the nSmberc

style:num-format

The raaSe oi this attribSte ian be "0"s "a"s " "s "i"s or " "c
<!ATTLIST style:properties style:num-format CtATA tIMPLIEt<
The raaid raaSes ior this attribSte hare the same meanings as a singae aaphanSmerii token that appears tithin an X LT format attribStec
c c4 Letter ynihronikation in NSmber Formats
i aetters are Ssed in aaphabetiiaa order ior nSmberings there are tto tays to proiess oreriaots tithin a digits as ioaaots:
YoS ian insert a net digit starting tith a raaSe oi a or s that is iniremented erery time an oreriaot oiiSrs in the ioaaoting digitc The nSmbering seqSenie in this iase is something aike asbsis cccs ks aasabsais cccsaks bas cccs and so onc YoS ian insert a net digit that aatays has the same raaSe as the ioaaoting digitc The nSmbering seqSenie in this iase is something aike as bs is cccs ks aas bbs iis cccs kks aaas cccs and so onc This is iaaaed T Ii9y1orIn1u 4un1c style:num-letter-sync <!ATTLIST style:properties style:num-letter-sync %boolean; tIMPLIEt<
X LT does not sSpport aetter synihronikationc

c02 iripts

iripts do not impay a siripting aangSage or an objeit modeac For this reasons a siript ian operate on the DoiSment Objeit odea iDO o oi an OpenOiiiiecorg X L doiSment or on the OpenOiiiiecorg P c iripts iannot modiiy a doiSment thiae the doiSment is aoadingc Ooterers some erents are iaaaed immediateay aiter the doiSment is aoadedc Eaih siript is represented by a <script:script< eaementc

<script:script<

This eaement iontains the soSrie iode oi the siriptc t ian aaso optionaaay iontain a iompiaed rersion oi the siriptc The iompiaed rersion oi the siript is iontained tithin a <script:bytecote< baoiks thiih ian iontain any iontentc aa siripts are iontained tithin the siripting seition oi a doiSmentc Jara iript siripts that operate on the OT L DO are speiiaa siripts that hare their otn representation and they ian onay be Ssed in te.t doiSmentsc

c00 Erent Tabaes

any objeits sSih as iontroass imagess te.t bo.ess or an entire doiSment sSpport erentsc n erent binds the oiiSrrenie oi a partiiSaar iondition to an aition that is e.eiSted ii the iondition arisesc For e.ampaes ii a Sser paaies the iSrsor orer a graphiis this iondition triggers an aition that is sSpported by OpenOiiiiecorgc This erents iaaaed "on-moSse-orer"s ian be assoiiated tith an OpenOiiiiecorg mairo that is e.eiSted thenerer the iondition oiiSrss that iss thenerer a Sser paaies the iSrsor orer a graphiic The X L representation oi erents and erent tabaes is strSitSred as ioaaots:
aa oi the erent eaements that are assoiiated tith an objeit are aoiated in a iontainer eaement iaaaed <office:events<c Eaih erent-to-aition assoiiation is reiorded in one <script:event< eaementc Depending on the type oi aition that the erent triggerss the ioaaoting eaements are Ssed:

0c This is the iirst aist itemc This is a iontinSation oi the iirst aist itemc c This is the seiond aist itemc t iontains an Snordered sSb aistc
This is a sSb aist itemc This is a sSb aist itemc This is a sSb aist itemc
4c This is the third aist itemc

4c9 OStaine NSmbering

YoS ian aink oStaine nSmbering to paragraph styaesc

4c9c0 OStaine tyae

The tay in thiih OpenOiiiiecorg X L represents oStaine nSmbering styaes is rery simiaar to the tay it represents aist styaesc The <text:outline-style< eaement iontains eaements that speiiiy the styae oi eaih oStaine aereac
<text:outline-style< <!ELEMENT text:outline-style (text:outline-level-styleyt<

4c9c OStaine Lerea tyae

The <text:outline-level-style< eaement speiiiies the styae ior eaih oStaine aereac
<text:outline-level-style<
This eaement is iontained in <text:outline-style< eaements onayc
<!ELEMENT text:outline-level-style EMPTY<
The attribStes that yoS ian assoiiate tith the <text:outline-level-style< eaement are:
Lerea paiing and aaignment Te.t styae NSmber iormat Dispaay aereas tart raaSe
ee eition 4c4c5 ior a desiription oi this attribStec

paiing and aignment

The <text:outline-level-style< eaement iontains a <style:properties< eaement that ian iontain attribStes speiiiying the spaiing and aaignment ior the oStaine nSmbering aistc The attribStes are the same as the attribStes ior the nSmbering aerea styae eaements <text:list-level-style-numbering<s as ioaaots:
tart indent l text:space-before inimSm aabea tidth l text:min-label-witth inimSm aabea distanie l text:min-label-tistance Labea aaignment l fo:text-align ee eition 4c4c5 ior detaiaed iniormation on these attribStesc
ee eition 4c4c5 ior iniormation on the te.t styae attribStec
Paease reier to Chapter ior detaiaed iniormation on nSmber iormat attribStesc YoS ian assoiiate the attribStes desiribed in Chapter tith the <text:outline-numbering-level-style< eaementc
<!ATTLIST text:outline-level-style teEt|IeEt< <!ATTLIST text:outline-level-style tIMPLIEt< <!ATTLIST text:outline-level-style tIMPLIEt< <!ATTLIST text:outline-level-style boolean; "false"<
style:num-format CtATA style:num-prefix CtATA style:num-suffix CtATA style:num-letter-sync %
ee eition 4c4c5 ior iniormation on the dispaay aerea eaementc

4c02c04 Font Charaiter et
se these properties to speiiiy the iharaiter set oi a iontc
style:font-charset style:font-charset-asian style:font-charset-complex
The raaSe oi these attribStes ian be x-symbol or the iharaiter enioding in the notation desiribed in the X L reiommendation iChapter 9c4c4s Charaiter Enioding and Entitiess http:ss tttct4corgsT s EC-.ma*ihareniodingoc i the raaSe is x-symbols aaa iharaiters that are dispaayed Ssing this iont mSst be iontained in the N CODE iharaiter range 2.i222 to 2.i2iic These properties are ignored ii there is no iorresponding fo:font-family property attaihed to the same properties eaementc YoS ian Sse these properties instead oi the style:font-name attribStes to speiiiy the properties oi a iontc Ooterers it is adrisabae to Sse the style:font-name attribSte insteadc ee eition 4c02cr ior iniormation aboSt then the asian and iompae. rariants oi the attribSte are eraaSatedc
<!ATTLIST style:properties style:font-charset CtATA tIMPLIEt< <!ATTLIST style:properties style:font-charset-asian CtATA tIMPLIEt< <!ATTLIST style:properties style:font-charset-complex CtATA tIMPLIEt<

4c02c09 Font ike

se these properties to speiiiy the sike oi iontc
fo:font-sive iX L propertyo fo:font-sive-asian fo:font-sive-complex
The raaSe oi these property is either an absoaSte aength or a perientagec n iontrast to X Ls perientage raaSes ian be Ssed tithin styaes onay and reaate to the iont height oi the parent styae rather than to the iont height oi the attribStes neighborhoodc bsoaSte iont heights sSih as metiums larges x-larges and so ons and reaatire iont heights sSih as smallers and larger are not sSpportedc ee eition 4c02cr ior iniormation aboSt then the asian and iompae. rariants oi the attribSte are eraaSatedc
<!ENTITY % length_or_percentage "CtATA"< <!ATTLIST style:properties fo:font-sive %length_or_percentage; tIMPLIEt< <!ATTLIST style:properties fo:font-sive-asian % length_or_percentage; tIMPLIEt< <!ATTLIST style:properties fo:font-sive-complex % length_or_percentage; tIMPLIEt<

4c02c05

eaatire Font ike
se these properties to speiiiy a reaatire iont sike ihangec
style:font-sive-rel style:font-sive-rel-asian style:font-sive-rel-complex
These properties speiiiy a reaatire iont sike ihange as a aength sSih as t1pts -3ptc t iannot be Ssed tithin aStomatii styaesc The sike ihanges reaates to the iont sike setting that appaies to the parent styae oi the styaec ee eition 4c02cr ior iniormation aboSt then the asian and iompae. rariants oi the attribSte are eraaSatedc

i part oi a paragraph tas deaeteds the te.t that tas deaeted is iontained in this eaement as a para graph eaementc i the deaeted te.t is reinserted into the doiSments the paragraph is joined tith the paragraph there the deaetion took paaiec
<!ELEMENT text:teletion (office:change-info,%text;y<
E4oT Tio T un1inei <text:tracket-changes< <text:changet-region text:itpc002< <text:teletion< <office:change-info office:chg-authorpMichael Brauer office:chg-tatep04/1-/99 office:chg-timep12:4::0:< <text:p< , but this has been teletet </text:p< </text:teletion< </text:changet-region< </text:tracket-changes<. <text:p< This is the original text<text:change text:region-itpc002/<. </text:p< This e.ampae shots:
Deaeted te.t but this has been teletet This te.t is iontained in the <text:p< eaement tithin the <text:teletion< eaementc CSrrent te.t This is the original text. This te.t is iontained in the <text:p< eaement at the end oi the e.ampaec Originaa te.t beiore deaetion took paaie teletet. This is the original text, but this has been

4c04c6 Format Change

iormat ihange eaement represents any ihange in iormatting attribStesc The region there the ihange took paaie is marked by a ihange start and a ihange end eaementc
<text:format-change< <!ELEMENT text:format-change (office:change-infoy<
iormat ihange eaement does not iontain the aitSaa ihanges that took paaiec

4c09 Optionaa niormation

YoS ian iniaSde the iniormation desiribed in this seition in an X L doiSment to improre its periormaniec Ooterers it is not essentiaac

4c09c0

ark Fiae ior aphabetiiaa ndiies
To ease the ireation oi aaphabetiiaa indiiess OpenOiiiiecorg aaaots yoS to assign a so-iaaaed aSto mark iiaec This iiae iontains a aist oi keytordss and Spon Spdate oi an aaphabetiiaa inde. erery oiiSrrenie oi sSih a keytord in the doiSment is marked as an aaphabetiiaa inde. entrycThe aSto mark iiae eaement is an XLinks and the L is giren by the xlink:href attribStec

4c The address oi the ieaa in the sSbtabaec For e.ampaes to reierenie the ieaa in ioaSmn 0 and rot 0 in a sSbtabae that is iaaaed Subtables and that is in ioaSmn 49 and rot 06 oi the tabae SampleTables the address is SampleTable.Am1:.A1c i the name oi the tabae iontains a baank the name shoSad be betteen tto qSotation marksc This qSotation marks shoSad be
qSotedc A9nTr i41tiI T4uv io TTi4ttI 99u1. YoS ian reierenie ieaas in tto tayss Ssing absoaSte addresses or reaatire addressesc Dhen yoS periorm an operation on a tabae ieaas ior e.ampae then yoS iopy a iormSaas absoaSte ieaa reierenies do not ihange; reaatire ieaa reierenies do ihangec The prerioSs e.ampae Sses reaatire addressingc To ireate an absoaSte addresss paaie a doaaar sign i$o beiore eaih tabae names ioaSmn reierenies and rot reiereniec For e.ampaes the absoaSte address oi the prerioSs e.ampae is TSampleTable.TAmT1:c YoS ian iombine absoaSte and reaatire reierenies in a ieaa addressc For e.ampaes yoS ian Sse SampleTable.AmT1: to reier to a reaatire tabae and ioaSmns and an absoaSte rotc bsoaSte addresses mSst iontain a tabae namec The disirimination betteen absoaSte and reaatire addressing is onay neiessary in some speiiaa iasesc Othertises a ieaa reierenie tithoSt the doaaar signs is Ssedc
rg int T RrT 9T ooT <!ENTITY % cell-attress CtATA< cell-attress
9crcr Ceaa ange ddress Entity
ieaa range is a nSmber oi adjaient ieaas iorming a reitangSaar shapec The reitangae stretihes irom the ieaa on the top aeit to the ieaa on the bottom rightc The range address oi ieaas has a speiiaa data typec To speiiiy a ieaa range addresss yoS Sse an entityc To reierenie a range oi adjaient ieaass ionstrSit the address as ioaaotss in the speiiiied order: 0c The address oi the ieaa at the top aeit oi the range yoS tant to reiereniec c ioaon i:oc
4c The address oi the ieaa at the bottom right oi the range yoS tant to reiereniec For e.ampaes yoS Sse the address.A1:.B2 to reierenie the range oi ieaas irom ioaSmn 0 and rot 0 to ioaSmn and rot c The smaaaest range yoS ian speiiiy is a singae ieaac n this iases the range address is the same as the ieaa addressc
rg int T RrT 9T ooT <!ENTITY % cell-range-attress CtATA< cell-range-attress
9crc Ceaa ange ddress List Entity
ieaa range address aist is a aist oi ieaa ranges or ieaa addresses s or bothc Eaih item in the aist is separated by a spaiec
rg int T RrT 9T ooT <!ENTITY % cell-range-attress-list CtATA< cell-range-attress-list
Tabae Ceaa Content Vaaidations
The <table:content-valitations< eaement iontains aaa oi the ieaa iontent raaidationsc
<table:content-valitations< <!ELEMENT table:content-valitations (table:content-valitationy a<
9c c0 Tabae Ceaa Content Vaaidation
The <table:content-valitation< eaement speiiiies the raaidation oi the iontent oi the ieaa tith this styaec

table:link-to-source-tata <!ATTLIST table:consolitation table:link-to-source-tata % boolean; "false" <

9c0m DDE Links

The <table:tte-links< iontainer eaement stores aaa DDE ainksc Erery aink iontains the DDE oSrie and the data oi the aast ionneitionc
<table:tte-links< <!ELEMENT table:tte-links (table:tte-linkyt <

9c0mc0 DDE Link

This <table:tte-link< eaement iontains the DDE soSrie and a simpae tabae eaementc

<table:tte-link<

The tabae does not need a namec The eaements in the tabae do not hare styaes or other iniormationc Onay the data in the ieaa attribStes is Ssedc The ieaa does not iontain paragraphsc The data is stored in the raaSe attribStesc The tabae mSst iontain at aeast one ieaac
<!ELEMENT table:tte-link (table:tte-source, table:tabley <

9c0mc DDE oSrie

The DDE soSrie oi the <table:tte-link< eaement onay sSpports the raaSe true ior the office: automatic-uptate attribStec dditionaaays the DDE soSrie has a net attribSte table:conversion-motec

Conrersion

This attribSte speiiiies the method by thiih the DDE serrer ionrerts its data into nSmbersc There are three possibae raaSesc
table:conversion-mote <!ATTLIST table:tte-link table:conversion-mote (into-tefaultstyle-tata-style|into-english-number|let-texty "into-tefaultstyle-tata-style" <
9c0r Tabae Formatting Properties
The ioaaoting seitions detaia the iormatting properties that ian be appaied to tabaesc

9c0rc0 Tabae Didth

Erery tabae mSst hare a ii.ed tidthc YoS speiiiy this tidth as a ii.ed aengthc YoS ian aaso speiiiy the tidth oi a tabae reaatire to the tidth oi the area that the tabae is inc n this iases yoS speiiiy the tidth as a perientagec ser agents that sSpport speiiiying the reaatire tidth oi a tabae ian speiiiy tidths in this tays bSt it is not essentiaac
rg int T RrT 9T ooT <!ATTLIST style:properties style:witth %length; tIMPLIEt< <!ATTLIST style:properties style:rel-witth %percentage; tIMPLIEt< The reasons thy erery tabae mSst hare a ii.ed tidth and reaatire tidths are onay an option are as ioaaots:

nimation Direition

This attribSte speiiiies the siroaa direition oi animated te.tc rg int Ti RrT 9Ti ooT <!ATTLIST style:properties text:animation-tirection (left|right|up|towny tIMPLIEt< text:animation-tirection

nimation tart nside

This attribSte speiiiies thether or not te.t animation starts at the originaa position oi the te.tc rg int Ti RrT 9Ti ooT <!ATTLIST style:properties text:animation-start-insite %boolean; tIMPLIEt< text:animation-start-insite

nimation top nside

This attribSte speiiiies thether or not te.t animation stops at the originaa position oi the te.tc rg int Ti RrT 9Ti ooT <!ATTLIST style:properties text:animation-stop-insite %boolean; tIMPLIEt< text:animation-stop-insite

nimation epeat

This attribSte speiiiies the nSmber oi times the animation is repeatedc i the raaSe oi the attribSte is 0s the animation is repeated indeiiniteayc rg int Ti RrT 9Ti ooT <!ATTLIST style:properties text:animation-repeat %integer; tIMPLIEt< text:animation-repeat

nimation Deaay

This attribSte speiiiies a deaay beiore the animation is startedc rg int Ti RrT 9Ti text:animation-telay
To ioniorm tith O r620s the iormat oi the raaSe oi this attribSte is PnYnMntTnmnMnS. ee eition 5c5c4c oi O r620 ior more detaiaed iniormation on this time iormatc ee the Preiaie ior a pointer to O r620c
<!ATTLIST style:properties text:animation-telay %timeturation; tIMPLIEt<

5c02 Te.t Properties

5c02c0 Sto Grot Didth and Oeight
These attribStes speiiiy thether or not to aStomatiiaaay inirease the tidth and height oi the te.t ii te.t is added to a drating objeitc rg int Ti RrT 9Ti ooT <!ATTLIST style:properties traw:auto-grow-witth %boolean; tIMPLIEt traw:auto-grow-height %boolean; tIMPLIEt< traw:auto-grow-witth traw:auto-grow-height

5c02c Fit To ike

This attribSte speiiiies thether or not to stretih the te.t iontent oi a drating objeit to iiaa the entire objeitc i the raaSe oi the attribSte is trues the te.t iontent is stretihedc rg int Ti RrT 9Ti ooT <!ATTLIST style:properties traw:fit-to-sive %boolean tIMPLIEt< traw:fit-to-sive
5c02c4 Te.t rea Vertiiaa aign
This attribSte speiiiies the rertiiaa aaignment oi the te.t area inside a shapec rg int Ti RrT 9Ti ooT <!ATTLIST style:properties traw:textarea-vertical-align (top|mittle|bottom|iustifyy tIMPLIEt< traw:textarea-vertical-align
5c02c9 Te.t rea Oorikontaa aign
This attribSte speiiiies the horikontaa aaignment oi the te.t area inside a shapec rg int Ti RrT 9Ti ooT <!ATTLIST style:properties traw:textarea-horivontal-align (left|center|right|iustifyy tIMPLIEt< traw:textarea-horivontal-align

5c00 Graphii Properties

5c00c0 Coaor
rg int Ti RrT 9Ti ooT <!ENTITY % color-mote ; (greyscale|mono|watermark|stantarty< <!ATTLIST style:properties traw:color-mote %color-mote; tIMPLIEt<

This attribSte enabaes or disabaes the risibiaity oi a shadotc rg int Ti RrT 9Ti ooT <!ATTLIST style:properties traw:shatow (visible|hitteny tIMPLIEt< traw:shatow
To render a shadots a iopy oi the shape is rendered in the singae shadot ioaor behind the shapec The oiiset attribStes speiiiy the oiiset betteen the top aeit edge oi the shape and the top aeit edge oi the border c rg int Ti RrT 9Ti ooT <!ATTLIST style:properties traw:shatow-offset-x %length; tIMPLIEt traw:shatow-offset-y %length; tIMPLIEt< traw:shatow-tistance-x and traw:shatow-tistance-y
The shadot ioaor attribSte speiiiies the ioaor in thiih the shadot is renderedc rg int Ti RrT 9Ti ooT <!ATTLIST style:properties traw:shatow-color %color; tIMPLIEt< traw:shatow-color
The shadot transpareniy attribSte speiiiies the transpareniy in thiih the shadot is renderedc

traw:shatow-transparency

The raaSe oi this attribSte is a perientage raaSec
<!ATTLIST style:properties traw:shatow-transparency %percent; tIMPLIEt<
5c04 Conneitor Properties

tart Line paiing

The start aine spaiing attribStes modiiy the aine spaiing at the start point oi a ionneitor shapec rg int Ti RrT 9Ti ooT <!ATTLIST style:properties traw:start-line-spacing-horivontal %tistance; tIMPLIEt traw:start-line-spacing-vertical %tistance; tIMPLIEt< traw:start-line-spacing-horivontal traw:start-line-spacing-vertical

End Line paiing

The end aine spaiing raaSes modiiy the aine spaiing at the end point oi a ionneitor shapec rg int Ti RrT 9Ti ooT <!ATTLIST style:properties traw:ent-line-spacing-horivontal %tistance; tIMPLIEt traw:ent-line-spacing-vertical %tistance; tIMPLIEt< traw:ent-line-spacing-horivontal traw:ent-line-spacing-vertical

easSre Properties

Line Distanie
The traw:line-tistance attribSte speiiiies the distanie irom the reierenie points to the measSre ainec rg int Ti RrT 9Ti ooT <!ATTLIST style:properties traw:line-tistance %tistance; tIMPLIEt< traw:line-tistance

GSide Orerhang

The gSides are the tto aines irom the reierenie points to the measSre ainec The traw:guite-overhang attribSte speiiiies the distanie that the gSides are dratn aiter they iross the measSre ainec
traw:guite-overhang <!ATTLIST style:properties traw:guite-overhang %tistance; tIMPLIEt<

GSide Distanie

The traw:guite-tistance attribSte speiiiies the distanie betteen the reierenie points and the measSre aine there the drating oi the gSides startsc rg int Ti RrT 9Ti ooT <!ATTLIST style:properties traw:guite-tistance %tistance; tIMPLIEt< traw:guite-tistance

<form:text< <form:textarea< <form:formattet-text< <form:combobox< form:convert-empty-to-null
The raaSe oi this attribSte ian be true or falsec i the raaSe oi the attribSte is trues the raaSe oi the iontroa is regarded as nSaac i the raaSe oi the attribSte is falses the raaSe oi the iontroa is regarded as an empty stringc
<!ENTITY % convert-empty "form:convert-empty-to-null boolean; 'false'"<

Data Fiead

The form:tata-fielt attribSte speiiiies the name oi a resSat set ioaSmnc The resSat set is speiiiied ior the iormc YoS ian Sse this attribSte tith the ioaaoting eaements:
<form:text< <form:textarea< <form:formattet-text< <form:combobox< <form:listbox< <form:checkbox< <form:ratio< <form:image-frame< form:tata-fielt <!ENTITY % tata-fielt "form:tata-fielt CtATA tIMPLIEt"<

List oSrie

The form:list-source attribSte speiiiies the soSrie Ssed to popSaate the aist in a aist bo. or iombo bo.c The iirst ioaSmn oi the aist soSrie resSat set popSaates the aistc YoS ian Sse this attribSte tith the ioaaoting eaements:
<form:combobox< <form:listbox<
form:list-source <!ENTITY % list-source "form:list-source CtATA tIMPLIEt"<

List oSrie Type

The form:list-source-type attribSte speiiiies the type oi data soSrie that is Ssed to popSaates the aist data in a aist bo. or iombo bo.c YoS ian Sse this attribSte tith the ioaaoting eaements:
<form:combobox< <form:listbox< form:list-source-type
table: The aist is popSaated Ssing the iontent oi a database tabaec query: The aist is popSaated by e.eiSting a qSeryc sql: The aist is popSaated by e.eiSting an oL statementc sql-pass-through: The aist is popSaated by e.eiSting any type oi statement that is passed direitay to a database drirerc value-list: The aist is popSaated tith raaSes speiiiied by the Sser Ssing the form: value attribSte in the <form:option< eaementc This setting is onay appaiiabae to aist bo.esc table-fielts: The aist is popSaated Ssing the iiead names in a database tabaec
<!ENTITY % list-source-types "(table|query|sql|sql-passthrough|value-list|table-fieltsy"< <!ENTITY % list-source-type "form:list-source-type %listsource-types; tIMPLIEt"<

6c5 Erents

OT L deiines a aist oi standard erents ior iontroasc These erents are represented by attribStess thiih are assoiiated tith the iontroa eaementsc n the OpenOiiiiecorg X L iiae iormats these erents and any additionaa erents deiined by the OpenOiiiiecorg iomponent are stored as eaements in an <office:events< eaementc For a singae erent eaements the script:event-name attribSte speiiiies the type oi erent and other attribStes speiiiy the aangSage and the erent handaerc

BSaaetin boardss see eition 02c0c0 tyaess see eition 0c9 Controass see eition 6c Erentss see eition c00 <tlg:wintow<
Eaih doiSment iontains onay one <tlg:wintow< eaementc
<!ELEMENT tlg:wintow (tlg:stylesa, (%event;ya, tlg:bulletinboartay< <!ATTLIST tlg:wintow tlg:it CtATA teEt|IeEt tlg:left CtATA tIMPLIEt tlg:top CtATA tIMPLIEt tlg:witth CtATA tIMPLIEt tlg:height CtATA tIMPLIEt tlg:style-it CtATA tIMPLIEt tlg:title CtATA tIMPLIEt tlg:page CtATA tIMPLIEt tlg:tag CtATA tIMPLIEt tlg:help-text CtATA tIMPLIEt tlg:help-url CtATA tIMPLIEt xmlns:tlg CtATA tFIXEt "http://openoffice.org/2000/tialog" xmlns:script CtATA tFIXEt "http://openoffice.org/2000/script" <

02c0c0 BSaaetin Board

T enTSSice.org X L does not iaiiaitate iontroa aayoSt management or aStomatii positioningc The same appaies to <tlg:titletbox< eaements thiih is another iontainer eaement ior iontroasc
<tlg:bulletinboart<
This eaement ian iontain iontroa eaements and other bSaaetin board eaementsc The position oi aaa eaements iontained in this eaement is reaatire to the parent <tlg:bulletinboart< eaementc
<!ELEMENT tlg:bulletinboart ((tlg:bulletinboart| tlg:button| tlg:checkbox| tlg:combobox| tlg:menulist| tlg:ratiogroup| tlg:titletbox| tlg:textfielt| tlg:text| tlg:filecontrol| tlg:img| tlg:timefielt| tlg:tatefielt| tlg:numericfielt| tlg:currencyfielt| tlg:patternfielt| tlg:formattetfielt| tlg:fixetline| tlg:progressmeter|tlg:scrollbar yay< <!ATTLIST tlg:bulletinboart tlg:left CtATA tIMPLIEt tlg:top CtATA tIMPLIEt <
The attribStes that yoS ian assoiiate tith the <tlg:bulletinboart< eaement are:

Leit Top

The tlg:left attribSte speiiiies the aeit i.o position oi the bSaaetin boardc

tlg:left

The raaSe oi this attribSte is nSmeriic
<!ATTLIST tlg:bulletinboart tlg:left CtATA tIMPLIEt<
The tlg:top attribSte speiiiies the Spper iyo position oi the bSaaetin boardc

tlg:top

<!ATTLIST tlg:bulletinboart tlg:top CtATA tIMPLIEt<
The <tlg:styles< eaement is a iontainer eaement ior <tlg:style< eaementsc

<tlg:styles<

This eaement is iontained in the top-aerea <tlg:wintow< eaementc This eaement ian iontain one or more <tlg:style< eaementsc

Patches for the Solaris OE can be found on the CD in the directory /solsparc/patches, or on the internet at http://sunsolve.sun.com.
10 OpenOffice.org 1.1 Setup Guide
Special System Requirements for Linux
PC with Pentium or compatible processor Linux Kernel 2.2.13 or higher glibc2 version 2.2.0 or higher XServer (capable of 800x600 screen resolution and 256 colors) with window manager (for example, GNOME). For accessibility support, GNOME 2.0 or higher is required. at least 128 MB of RAM
OpenOffice.org cannot be installed on a (V)FAT partition under Linux since FAT file systems do not support the creation of symbolic links.
Special System Requirements for Windows
Microsoft Windows 98, ME, NT (Service Pack 6 or higher), 2000 or XP. For support of Asian character input under Windows 98/ME a native Windows 98/ME system is required. PC with Pentium or compatible processor 64 MB of RAM Please note that administrator rights are needed for the installation process.
Chapter 2 General Installation Information 11
Contents of the Download Setup Packages
Download setup packages consist of the OpenOffice.org setup application, and the User and Setup (this document) Guides in Portable Document Format (PDF). The contents of the setup packages for the different platforms are listed in the following table: Platform Windows Installation Files OpenOffice.org Setup: setup.exe, setup.inf and copies of the licenses.
Solaris OE (SPARC) OpenOffice.org Setup: nstall (a shell script). setup (the setup program), setup.ins (a plain text list of files to be installed) and copies of the licenses
OpenOffice.org Setup: install (a shell script). setup (the setup program), setup.ins (a plain text list of files to be installed) and copies of the licenses
Before You Install From a Downloaded Set
Place all the downloaded installation files in the same folder. Ensure that the setup files have executable rights. If they do not, use chmod to change the rights.
12 OpenOffice.org 1.1 Setup Guide
Updating an Existing Installation
You can update an existing OpenOffice.org installation (1.0.2 and higher) to OpenOffice.org 1.1 and continue to use the existing configuration settings. If the setup application finds a earlier OpenOffice.org version on your system, you are prompted to update the installation, or to install the latest version in a different directory. You cannot update an earlier version that is in a different language. We do not recommend that you update to a beta version of the OpenOffice.org software.
Updating a Multi-User Installation
The setup application only updates the server installation of a multi-user installation (see also page 33). The next time a user opens OpenOffice.org, a prompt appears offering to update the local user data.

Chapter 2 General Installation Information 13

Single-User Installation

The single-user installation installs the OpenOffice.org 1.1 software on one computer for one user. For a single-user installation, log on to your system as a normal user, and then install OpenOffice.org into your home directory, or in another local directory for which you have full access rights. Linux/Unix and Window XP/2000users: It is essential to use the two stage Multiuser installation procedure, even if it is on a stand-alone box, and you are the only user. Linux/Unix users: It is recommended that you use the automated installation script provided.
You can stop the installation process at any time by clicking the Cancel button in the installation dialog. You can also choose to remove the installation directory at this point. If you do, all files and subfolders are removed.
Installation Requirements
Depending on the options that you choose, the single-user installation requires between 190 and 250 MB of free space on your hard-disk. During the installation, an additional 40 MB is required for temporary files on Windows systems, and 80 MB on UNIX based platforms. On systems with a previously installed version of OpenOffice.org, open one of the following files:
.sversionrc (UNIX based systems)
sversion.ini (Windows based systems). For Windows NT/2000 and Win9x configured for multiple users, the sversion.ini file is in "C:\Program Files and Settings\{user name}\Application Data".
These files contain the path and version number of the installed OpenOffice.org software. If the version number is identical to the version that you want to install, you must uninstall OpenOffice.org, before you can reinstall it. If the version number is lower than the version that you want to install, and greater than 1.0.2, you can choose to update the installation (see Updating an Existing Installation on page 13)
Starting the Installation
1. Log on with your user name (system administrator rights are not required for a single-user installation). 2. Start the graphical X Window interface. 3. Change to the installation directory on the CD. On a multiple-platform installation CD, the installation files are found in:
Solaris/Sparc for the Solaris Operating Environment (SPARC Platform Edition) Solaris OE (SPARC) Solaris/Intel for the Solaris Operating Environment (x86 Platform Edition) Solaris OE (x86) Linux for Linux

4. Start the setup application with the command:./setup
1. Log on with your user name (system administrator rights are not required for a single-user installation).
16 OpenOffice.org 1.1 Setup Guide
2. Start the graphical X Window interface. 3. Change to the directory containing the downloaded installation file. 4. Unpack the tarball into a suitable temporary location, either by using a graphical front-end to tar, or by opening a terminal and executing the command tar -xzf Ooo_1.1.0_LinuxIntel_install.tar.gz (This will create a new directory named Ooo_1.1.0_LinuxIntel_install) 5. Open a console window in an X-session. Note: The setup progam must be run from within an X-session. It cannot be run from the command line. 6. Execute the following commands: cd /<temp_dir>/Ooo_1.1rc3_LinuxIntel_install./setup
Installing From a CD on Windows Platforms (using download earlier than 1.1.3)
1. If required, log on with your user name (system administrator rights are not required for a single-user installation). 2. Change to the setup directory on the installation CD. On a multiple-platform CD, the setup files are found in the Windows folder. 3. Do one of the following:
Double-click setup.exe Open the Windows Start menu, choose Run, and then type X:\Windows\setup.exe in the Open box where X is the letter of your CD-ROM drive.
4. Click OK to start the installation.
Chapter 3 Single-User Installation 17
Installing From a CD on Windows Platforms (using 1.1.3 download and later)
The 1.1.3 Downloads are now EXE files, which means that you no longer have to unzip before running the Install. To run the install, just double click on the EXE file.
Installing From a Download Set on Windows Platforms
1. If required, log on with your user name (system administrator rights are not required for a single-user installation). 2. Change to the directory containing the downloaded installation file. 3. Open the Zip file with a suitable program such as WinZip, and extract the files to a suitable temporary location (C:\Temp is suitable). This will create a new directory named C:\<temporary_directory>\OOo_1.1.0_Win32Intel_install 4. Change to the directory containing the un-packed downloaded installation files. 5. Do one of the following:
Double-click setup.exe. Open the Windows Start menu, choose Run, and then type "X:\instdir\setup.exe" in the Open box where X:\instdir is the directory with the download set files. (If there are spaces in the path, be sure to include the quotation marks.)
6. Click OK to start the installation.

The Setup Procedure

During the installation, click the Help button to display information about the current dialog, and then click the Back button to return to the setup program. Do

Select the type of installation that you want to perform. Click Next to continue the installation.
24 OpenOffice.org 1.1 Setup Guide

Component Selection

If you select the Custom Installation option, you can then choose the modules and the components that you want to install. Click the plus sign (+) next to the name of a module or component category to expand the list. Click the category or the component that you want to install. If a category contains unselected components, the box in front of the category is semitransparent. Categories in dark blue are installed with all of their components. Categories in light blue are installed with only some of their components. Categories in white are not installed. To restore the standard installation options, click the Default button.
Select the modules and the components you want to include in the installation. Click Next to continue the installation.
Chapter 3 Single-User Installation 25

Installation Directory

The next dialog lets you select the installation directory. This dialog does not appear in an update installation. The available drives on your system are listed in this dialog. The space requirements displayed are only estimates and depend on the properties of the storage media.
Note: There are slight differences between the Windows dialog and the unix/linux dialog.
Enter a path for the Installation directory in the text box, or click Browse to select a directory. If the directory does not exist, you are prompted to create it.
Click Next to continue with the installation.
26 OpenOffice.org 1.1 Setup Guide
Reviewing the Installation Options
After you set your installation options, a dialog appears that allows you review the settings.
Click Install to continue with the installation, or click Back to alter the settings made.
Chapter 3 Single-User Installation 27

Assigning File Types

Use this dialog to associate OpenOffice.org with Microsoft file types, and with HTML documents. This information is registered in your operating system.
Select the File types that you want OpenOffice.org to open. Unless you intend to use OpenOffice.org as your regular daily Office suite, make sure you leave the boxes unchecked. (If you forget, or miss this screen, don"t panic, as your files are still there, and are still in the original format. They may still be opened from within Word or Excel by using the "Open File." button. They can also be re-associated with Microsoft Office, by right-clicking on a file (Shift-right-click in Windows 9x/Me) and selecting "Open With.", then choosing the Microsoft program and checking the "Always open with this program" box.). Whether you check these boxes or not, you may still open all your Microsoft Office files with OpenOffice.org.

Chapter 3 Single-User Installation 31
Multi-User and Network Installation
Installing OpenOffice.org for multiple users on a network is a two-step process: 1. Server Installation - installed by the system administrator using the setup -net command. The OpenOffice.org files are copied to a directory with read and execute permission for all users (see page 33) 2. User Installation - each user installs a copy of OpenOffice.org in their home directory, or only installs user-specific files. The latter is also known as a Workstation Installation, and requires access to the Server Installation to run the OpenOffice.org applications (see page 46).

Server Installation

The Server Installation is not a stand-alone version of the OpenOffice.org software. Before you can use OpenOffice.org, you must perform a Workstation Installation from the Server Installation (see "Workstation Installation" on page 46).
The Server Installation of the OpenOffice.org software requires approximately 250 MB of disk space. Temporary setup files generated during the install process require an additional 20 MB of disk space. These temporary files are automatically removed after the installation. Under UNIX, an 80 MB temporary swap volume is created during the installation and deleted afterwards.
1. Log on as the system administrator. 2. Start the graphical XWindow interface. 3. Change to the installation directory on the CD. On a multiple-platform installation CD, the installation files are found in:
Solaris/Sparc for the Solaris Operating Environment (SPARC Platform Edition) Solaris OE (SPARC) Solaris/Linux for the Solaris Operating Environment (x86 Platform Edition) Solaris OE (x86) Linux (for Linux)
4. Start the installation script with the command:./setup -net Note: For Linux there is an automated installation script named install. This may be used instead of the 'setup -net' command if a custom installation is not required.
1. Log on as the system administrator. 2. Start the graphical XWindow interface. 3. Change to the directory containing the downloaded installation files. 4. Start the setup application with the command:./setup -net Note: For Linux there is an automated installation script named install. This may be used instead of the 'setup -net' command if a custom installation is not required.

34 OpenOffice.org 1.1 Setup Guide
Installing From a CD on Windows Platforms
1. Log in as the system administrator. 2. Open the Windows Start menu, choose Run, and then type X:\Windows\setup.exe -net in the Open box. X is the letter of your CD ROM drive. 3. Click OK to start the installation.
1. Log in as the system administrator. 2. Open the Windows Start menu, choose Run, and then type "X:\instdir\setup.exe" -net in the Open box where X:\instdir is the directory with the download set files. (If there are spaces in the path, be sure to include the quotation marks.) 3. Click OK to start the installation. When updating an existing OpenOffice.org installation, you may have to tell the setup program where this previous version is installed. If the setup procedure does not automatically recognize a previous version that can be updated, try running the setup application with the -update parameter:./<setup> -net -update:<path_to_previous_serverinst> where <setup> is the name of the setup routine to be started (see above), and <path_to_previous_serverinst> is the fully qualified path to the previous server installation of OpenOffice.org.
Chapter 4 Multi-User and Network Installation 35
1. Choose an install option, and then click Next.
36 OpenOffice.org 1.1 Setup Guide
Read the information, and then click Next.
Chapter 4 Multi-User and Network Installation 37
Standard Installation - recommended for most users. Installs all of the OpenOffice.org applications, and a selection of filters.
38 OpenOffice.org 1.1 Setup Guide
Custom Installation - recommended for advanced users. Allows you to select the individual components to be installed. Minimum installation - recommended for users with space restrictions. This option only installs the components that are required to run OpenOffice.org.
Select Custom Installation. Install all of the OpenOffice.org components during the server installation, so that each user can access these options during a Workstation Installation.
Click Next to continue the installation.
If you select the Custom Installation option, you can then choose the modules and the components that you want to install. Click the plus sign (+) next to the name of a module or component category to expand the list. Click the category or the component that you want to install. If a category contains unselected components, the box in front of the category is semitransparent.

Installing on Windows Platforms
1. Log on with your user name. 2. Change to the program subdirectory in the setup directory on the server installation. Do not use the original setup file of the OpenOffice.org installation. 3. Do one of the following
Double-click setup.exe. Open the Windows Start menu, choose Run, and then type "{server install dir}\program\setup.exe" in the Open box where {server install dir} is the setup directory on the server installation. (If there are spaces in the path, be sure to include the quotation marks.)
4. Click OK to start the workstation installation.
Chapter 4 Multi-User and Network Installation 47
48 OpenOffice.org 1.1 Setup Guide
Chapter 4 Multi-User and Network Installation 49
50 OpenOffice.org 1.1 Setup Guide
Chapter 4 Multi-User and Network Installation 51
52 OpenOffice.org 1.1 Setup Guide
If you do not see the dialog window described below, but rather a dialog window offering standard, custom and minimum installation types, close the dialog, and then run the setup application in the program subdirectory on the server installation. The Workstation Installation option only installs user-specific files locally, and requires access to the server installation to run OpenOffice.org. The Local Installation option installs a complete copy of OpenOffice.org locally. The resulting installation does not require access to the Server Installation to run OpenOffice.org.
Select Workstation Installation as the installation type. You have to perform a separate workstation installation for each user on the same machine. Click Next to continue the installation.
Chapter 4 Multi-User and Network Installation 53
The next dialog lets you select the installation directory. This dialog does not appear in an update installation. The available drives on your system are listed in this dialog. The space requirements displayed are only estimates and depend on the properties of the storage media. Note: The Windows dialog may appear slightly differently
54 OpenOffice.org 1.1 Setup Guide
Chapter 4 Multi-User and Network Installation 55
56 OpenOffice.org 1.1 Setup Guide

Java Runtime Environment

If the Java Runtime Environment (JRE) was not installed during the Server Installation, you are prompted to install the JRE. To install the JRE, follow the instructions on page 29.
Chapter 4 Multi-User and Network Installation 57
Click Complete to finish the installation. Depending on the window manager that you use, you may need to log off and restart your window manager.
Change to the {installpath}/program directory, or to the local OpenOffice.org directory in your home directory, and type:./soffice You can also add the {installpath}/program directory to the program path, and then type "soffice" in any directory to start OpenOffice.org. To set up the default printer for OpenOffice.org, call the spadmin Printer Administration Utility, as is described in the Appendix. After completing the installation process under the Solaris OE, log out and log in again to update the CDE integration. The icons for starting the OpenOffice.org applications are added to the Windows

58 OpenOffice.org 1.1 Setup Guide
Start menu in the programs/OpenOffice.org 1.1 folder. During the installation process, a link to the OpenOffice.org Quickstarter is added to the Autostart folder in the Windows Start menu. The Quickstarter is added to the system tray when you start Windows. Right-click the Quickstarter icon in the system tray, and choose the OpenOffice.org application that you want to start. For more information on the Quickstarter, see the online help. Information about starting OpenOffice.org with command line parameters is found in the Appendix.
Chapter 4 Multi-User and Network Installation 59

Appendix

The Appendix contains instructions for installing the Java Runtime Environment (JRE),and information about the printer administration program under the Solaris Operating Environment and under Linux. It also contains information about modifying, repairing, and deinstalling the OpenOffice.org software.
During the OpenOffice.org installation, you are prompted to install the Java Runtime Environment (JRE). These files are only required to run JAVA based applets and some OpenOffice.org components, such as the Report AutoPilot. To install the JRE later, run the jvmsetup located in the program directory of the OpenOffice.org installation. To use the Java Runtime Environment (JRE) under Linux, refer to the readme file for the most up-to-date information.
Setting up Printer, Fax and Fonts Under UNIX Based Platforms
Under UNIX based platforms, the printer administration program spadmin is provided to help you set up printers, faxes and fonts for use with the OpenOffice.org software.
Call the printer administration program spadmin as follows:
Go to the {installpath}/program directory. Enter:./spadmin
After it starts, the window of the printer administration program spadmin appears. Following a Server Installation, the system administrator first logs on as user root and starts the printer administration program spadmin. The administrator then creates a general printer configuration file called {installpath}/share/psprint/psprint.conf for all users. All changes are immediately available to all users. The system administrator can also add fonts for all users in the network installation. However, these fonts are available only after restarting the OpenOffice.org software.

Setting up Printers

Under UNIX based platforms, the OpenOffice.org software only offers direct support for printers using the PostScript technology. Other printers must be set up as described in the section Printer Drivers in the OpenOffice.org Software. The OpenOffice.org software automatically provides a printer with the default driver for each system queue. You can add additional printers as needed.

Adding a Printer

1. Click the New Printer button. 2. Select the Create Printer option and click Next. 3. Select the appropriate driver for your printer. If you are not using a PostScript printer or your model is not listed, use the Generic Printer driver or follow the steps below. You can also add new drivers using the Import button or delete unnecessary drivers using the Delete button. Click Next. 4. Choose a command line that you can use to print on your printer (for example, lp -d my_queue). Click Next.

62 OpenOffice.org 1.1 Setup Guide
5. Give the printer a name and determine whether it should become the default printer. Click Finish. 6. To print a test page, click on Test Page. If the test page fails to print or is incorrectly printed, check all settings as described in Changing Printer Settings.
Printer Drivers in the OpenOffice.org Software
When installing a non-PostScript printer, you must set your system so that PostScript can be converted into the language of the printer. We recommend using current PostScript conversion software such as Ghostscript (http://www.cs.wisc.edu/~ghost/). You should set up the Generic Printer in that case. Also make sure that the page margins are set correctly. If you are using a printer using the PostScript technology, you should install a description file for the printer (PostScript Printer Definition - PPD) so that you can utilize the specific printer features like paper tray selection, duplex print function and all built-in fonts. You can also use the generic printer driver since it contains the most important data and is suitable for most printers. In that case, you will have to do without the paper tray selection and must correctly set the page margins. Some PPD files are installed as default files. If there is no matching PPD file for your printer, you will find various PPD files at http://www.adobe.com/products/printerdrivers/. You can also ask the manufacturer of your printer for PPD files.
Importing Drivers When Creating a New Printer
1. Click Import in the driver selection dialog. 2. Click Browse to select the directory where you unpacked the PPD files. 3. In the Selection of drivers list box, select the printer driver you want to install. 4. Click OK.

Chapter 5 Appendix 63

Deleting Drivers When Creating a New Printer
Select the printer driver. Click Delete.
Be sure that you do not delete the generic printer driver, and remember that drivers deleted from Server Installations are no longer available to other users who are using the same Server Installation. If the printer has more fonts built in than the usual PostScript fonts, you must also load the AFM files for these additional fonts. Copy the AFM files into the {installpath}/share/psprint/fontmetric directory or into the {installpath}/user/psprint/fontmetric directory. You can find AFM files, for example, at ftp://ftp.adobe.com/pub/adobe/type/win/all/afmfiles/.
Changing Printer Settings
In the printer administration program spadmin, select the printer from the Installed printers list box and click Properties. The Properties dialog appears containing several tab pages. This is where you can make settings that are used according to the PPD file of the selected printer.

Chapter 5 Appendix 65

4. Enter a command line with which to communicate with the fax in the following dialog. In the command line of each fax sent "(TMP)" is replaced by a temporary file and "(PHONE)" by the telephone number of the recipient fax machine. If "(TMP)" occurs in the command line, the PostScript code is transmitted in a file, otherwise as standard input through a pipe. Click Next. 5. Assign a name to your new fax printer and determine whether the telephone numbers (see below) marked in the text should be removed from the printout, or not. Click Finish. You can now send faxes by printing to the printer that has just been created. Enter the fax number as text in the document. You can also enter a field that takes the fax number from your active database. In any case, the fax number must start with the characters @@# and end with @@. A valid entry would have the form @@#1234567@@. If these characters including the telephone number are not printed, activate the Fax number is removed from the printout option under Properties on the Command tab page. If no telephone number is entered in the document, a dialog prompting you for it will appear after the printout. In OpenOffice.org you can also activate a button for sending faxes to a default fax. To do this, right-click the function bar, open the Visible Buttons submenu and click the Send Default Fax button. You can set which fax is used when this button is pressed under Tools - Options - Text Document - Print. Remember to create one separate print job for each fax, otherwise, the first recipient will receive all the faxes. In the Tools - Mail Merge dialog select the Printer option and then select the Single print jobs check box.
Connecting a PostScript to PDF Converter
If a PostScript to PDF converter such as Ghostscript or Adobe Acrobat Distiller is installed on your computer, you can quickly create PDF documents in the OpenOffice.org software. 1. Click New Printer. This opens the Add Printer dialog. 2. Select Connect a PDF converter. Click Next. Choose whether to use the default driver, the Acrobat Distiller driver or another driver. The driver "Generic Printer (T42 enabled)" prefers the type 42 fonts over
66 OpenOffice.org 1.1 Setup Guide
type 3 fonts; this driver is a good choice for output to a software PostScript interpreter. Click Next. 3. In the next dialog, enter a command line for the PostScript->PDF Converter. Enter the directory where the PDF files should be saved. If you do not provide a directory, the user's home directory will be used. In the command line "(TMP)" is replaced by a temporary file and "(OUTFILE)" by the target file, the name of which is created from the document name. If "(TMP)" occurs in the command line, the Postscript code is forwarded in a file, otherwise as standard input through a pipe. If Ghostscript or Adobe Acrobat Distiller is in the search path, you can use one of the predefined command lines. Click Next. 4. Assign a name to your new PDF converter. Click Finish. You can now create PDF documents by printing to the converter that has just been created.

Installing Fonts

When you are working with the OpenOffice.org software you might notice that a different number of fonts is provided depending on the document type being used. This is because not all of the fonts can be used in every case.
Therefore, only those fonts will be shown in the font selection box when working with a text document which can also be printed, as it is assumed that you will only want to use those fonts that you can actually have printed on paper. In an HTML document or in online layout, only fonts that are available on screen are offered. On the other hand, when working with spreadsheets and drawings you will be able to use all of the fonts that can be either printed or shown on the screen.
The OpenOffice.org software tries to match the display on screen to the printout (WYSIWYG = what you see is what you get). Possible problems are shown in the bottom of the dialog Format - Character.

Adding Fonts

You can integrate additional fonts in the OpenOffice.org software. Fonts which you integrate are available exclusively to the OpenOffice.org software and can be

Chapter 5 Appendix 67

used with various Xservers without your having to install them there. To make the fonts available to other programs as well, proceed as usual by adding the fonts to your Xserver. The OpenOffice.org software can display and print out PostScript Type1 fonts as well as TrueType fonts (including TrueType Collections). To integrate additional fonts in the OpenOffice.org software, proceed as follows: 1. Start spadmin. 2. Click Fonts. 3. The dialog lists all fonts added for the OpenOffice.org software. You can select and remove fonts using the Remove button or add new fonts with the Add button. 4. Click Add. The Add Fonts dialog appears. 5. Enter the directory from which you want to add the fonts. Press the. button and select the directory from the path selection dialog or enter the directory directly. 6. A list of the fonts from this directory appears. Select the fonts you want to add. To add all the fonts, click Select All. 7. With the Create soft links only check box you can determine whether the fonts are to be copied into the OpenOffice.org directory or only symbolic links are to be created there. If the fonts to be added are on a data medium that is not always available (such as a CD-ROM), you must copy the fonts. 8. Click OK. The fonts will now be added. In the case of a Server Installation, the fonts are installed in that installation if possible. If the user has no write access rights, the fonts will be installed in the corresponding Workstation Installation so that only the user who installed them can access them.

Deleting Fonts

To delete fonts, proceed as follows: 1. Start spadmin. 2. Click Fonts.
68 OpenOffice.org 1.1 Setup Guide
3. All fonts added to the OpenOffice.org software are listed in the dialog that now appears. Select the fonts you want to delete and click Delete. You can delete only the fonts that have been added for the OpenOffice.org software.

Renaming Fonts

You can also rename fonts added for the OpenOffice.org software. This is especially useful for fonts that contain several localized names. 1. Start spadmin. 2. Click Fonts. 3. Select the fonts you want to rename and click Rename. 4. Enter a new name in the dialog that appears. If the font contains several names, these names will serve as suggestions in the combo box where you enter the new name. 5. Click OK. If you select several fonts to rename, one dialog appears for each selected font. If you have selected a TrueType Collection (TTC), one dialog appears for each of the fonts contained in it.

Chapter 5 Appendix 69

Installing a patch under the Solaris Operating Environment (OE)
Before you can install OpenOffice.org under the Solaris OE, the system patches described in the chapter "System Requirements" on page 10 must be installed. To install a Solaris system patch, use the procedure outlined in the following example for Patch #106327-08. The patch in this example is compressed in zip format and was downloaded from http://sunsolve.sun.com. 1. Log on with root access rights: su 2. Create a temporary directory for unpacking the compressed patch file, for example, /tmp/patches. mkdir /tmp/patches 3. Copy the compressed patch file to this directory and unpack it there: unzip 106327-08.zip 4. Install the patch using the command patchadd: patchadd 106327-08 5. After successful installation of the patch, you can remove the temporary directory: rm -rf /tmp/patches To display a list of the patches already installed on your system, use the command showrev -p or patchadd -p. To deinstall a patch, use the command patchrm.
70 OpenOffice.org 1.1 Setup Guide
Modifying an Existing OpenOffice.org Installation
To modify, repair or remove an existing OpenOffice.org installation, run the setup application found in your local directory. If you want, you can also run the setup application found on the installation CD.

Modify

The Modify option adds or removes components from an existing installation, or modifies file type assignments. More information on choosing components is found in chapter "" on page