OpenOffice.Org 1.0 Resource Kit

With the removal of the Web browsing feature (kind of) and Mail, there isn't much left in the program that uses Internet settings. The features left include browsing by just typing a full HTTP URL in the Load URL field, and sending a document as an email. (Choose File > Send > Document as Email.) This ability also applies to mail merges; you can do a mail merge to paper, to email, or to files. The settings in this section help your merges to email work, too.

If you're converting from 5.2, you probably don't need to enter much, if anything. If Internet features aren't working the way you want, make the appropriate changes using the procedures in this section.

Setting Up Proxy Information for Internet Access

Why proxy options? Because you can complete the rather superfluous Bringing Up a Web Page on page 438 and Using Web's Search Connection on page 438. You can probably skip this.

Use the window shown in Figure 5-39 to define the settings for the proxy server. Default settings for your current proxies are often read from your system and set up automatically, so you might not need to change anything.

Proxies

The proxy server can be manually or automatically set up to access the Internet over an interconnected network. A proxy is a computer in the network acting as a kind of clipboard for data transfer. Whenever you access the Internet from a company network and request a Web page that has already been read by a colleague, the proxy will be able to display it much more quickly as long as it's still in memory. All that needs to be checked in this case is that the page stored in the proxy is the latest version. If this is the case, the page won't have to be downloaded from the much slower Internet but can be loaded directly from the proxy.

Figuring out your proxy names and ports

Ask your system administrator or Internet service provider for the proxies and ports to enter. You can also check your browser for the proxies and ports you use. In Netscape, choose Edit > Preferences > Advanced > Proxies. In Internet Explorer, choose Tools > Internet Options > Connections. Depending on the provider, it may or may not be necessary to always use a proxy. For example, no proxy is required for AOL or CompuServe.

Server names

Always enter server names without the protocol prefix ( http , ftp , etc.). For example, enter starnews.stardivision rather than http://starnews.stardivision .

Proxies and ports

Ask your system administrator or ISP for the port for each proxy. The maximum value is 65535. If you enter a higher number, the value will be set at 0 and an error message will appear.

DNS Server

You can use the setup window to set the name of the DNS (Domain Name System). The DNS name server is there to translate the full name of the host that you enter as URL, such as www.lastturtle.com , into its 32-bit IP address. The 32-bit numbers of IP addresses are shown in a simplified way as four decimal numbers separated by dots. Each decimal number is a number from 0 to 255, and represents the first, second, third and final 8 bits of the entire 32 bits.

Setting Up the Ability to Search the Web

The only reason to complete this section is so that you can then use the rather superfluous Using Web's Search Connection on page 438. You can probably skip this; we're documenting it out of an overdeveloped sense of duty.

Note

Sometimes you don't get the hyperlink bar, which contains features like the Search (the Web) icon and the link-creating URL fields. That is, you might have the hyperlink bar, but it's entirely blank. This can be corrected, sometimes, by reinstalling. If you don't have the hyperlink bar, though, don't worry about it. The Search feature is extraneous at best, and the Hyperlink Dialog icon is relocated to the topmost bar of your work area. (Oddly enough, even distributions without the Search icon still have the Search Setup feature.)

The program lets you use any of several popular search engines to search the Internet straight from the program, without having to go to a particular search engine site. See Using Web's Search Connection on page 438 for information on how to search and selecting the search engine to use.

Several search engines are already set up for you; you probably don't need to change these settings unless you need to do some tweaking, or want to add a search engine to the list.

1. Choose Tools > Options > Internet > Search (Figure 5-40).

   Figure 5-40. Search options

2. Enter the appropriate information with the information in the window as well as the guidelines following the illustration.

Here are some guidelines for figuring out what the prefix (the codes the engine puts in front of what you're searching for), suffix (the code after the keyword), and the separator (what goes between multiple keywords) are for each new search engine.

1. Activate the search engine and perform a search with at least two words.

2. Copy the URL from the URL field in the Function bar and paste it into a blank document.

3. Change the conditions for the search in the search engine, if it offers you the choice.

4. Again, copy the contents of the URL field.

5. Compare the URLs with the sample URLs that you can copy from the fields of this dialog. You should then be able to recognize the prefix, suffix, and separator for various conditions.

Absolute and Relative Paths, and Fixing Broken Links

This applies to graphics and other objects you've inserted in documents via a link, and how the Relative and Absolute Path settings under Tools > Options > Load/Save > General affect object insertion.

About Links and Paths

When you insert a graphic, you can choose whether to link to the graphic where it is, by selecting the Link option in the Insert window, or to pull it into the document. (If you've inserted the graphic without marking the Link option, this whole section doesn't apply.)

Inserting a link to an object is demonstrated in Figure 5-41.

This is affected by the setting in Tools > Options > Load/Save > General. The window is shown in Figure 5-42.

Relative paths are just the path from the main container document like a Writer document to the inserted object. Absolute paths are from the drive letter on down. Let's say you've got the directories and files in Figure 5-43.

If you have relative paths from the Writer and HTML documents, then your pathnames are saved as just bookcover_javaarch.jpg and bookcover_openoffice.jpg . If they're absolute, then the actual code in the files is C:\lastturtle\webpage\productinfo\bookcover_javaarch.jpg and C:\lastturtle\webpage\productinfo\bookcover_openoffice.jpg .

What You Should Do

In general, you want to leave paths relative, the default value; this will make dealing with inserted graphics easier. To make things really simple, don't mark the Link option when inserting graphics, either.

Note

Tool tips, the Graphics window, and the Edit Links window (choose Edit > Links), always display the absolute path, even if only the relative path is saved. In HTML files, you can choose View > HTML Source to see what's actually saved in the link's HTML code.

What Goes Wrong When You Have Absolute Paths and Linked Objects in Documents

With the file structure shown in Figure 5-43, you're fine as long as nothing changes. However, the links will be broken if any of the following happen.

• If you change the webpage directory to web_page , or change anything else in the directories above the graphics files, then absolute paths will be goofed up and links to the graphics broken.

• If you upload the text and HTML files to a bin\cart\products directory on your Web server, it won't work, even if the graphics are still in the same directory.

• Likewise, if you send the documents and graphics to other people working on the Last Turtle Web site, and they put the files in different directories or on their D drive, the links will get screwed up.

What Happens When You Switch Between Absolute and Relative Paths in the Load/Save Window

If you insert graphics using relative paths, then go under Tools > Options and switch to absolute, the paths are now absolute. They don't stay the way you inserted them. So now if the absolute path to the graphics changes at all, the graphics are goofed up, as shown in Figure 5-44.

You'd think, therefore, that all you have to do is go under Tools > Options again and switch to Relative, and everything will be fine. Nope. The graphics paths remain goofed up.

What You Can Do to Fix Broken Links

• In any document, you can unzip the file using WinZip or another program, open the content.xml file that results in TextPad or another program, and edit the file directly. Then zip it back up again. An example content.xml is shown in Figure 5-45.

  Figure 5-45. Content.xml file

  content.xml is stored without indents so it's not that easy to read, but takes up less space. You can make it more readable by choosing Tools > Options > Load/Save > General and deselecting the Size Optimization for XML Format option.

• In Writer and Web you can select the graphic, right click, choose Graphics, click the Graphics tab, and enter a new path. (See Figure 5-46 on page 142.)

  Figure 5-46. Entering the correct path to a broken-link graphic

• In all the other applications, you have to either reimport the graphics, or re-create the correct absolute path, switch the settings to relative paths under Tools > Options while the paths are correct, and save the document again.

Setting Up How the Program Reads and Exports HTML Files

If you ever save or export your documents to HTML, or if you just plain create HTML documents, take a look at the settings in Tools > Options > Load/Save > HTML Compatibility, shown in Figure 5-47.

See also Making an HTML Version of a Document on page 144 to see what happens when you save a document as the Web/Writer fake HTML format.

Selecting the Program for the Send as Email Feature

Choose Tools > Options > OpenOffice.org > External Programs. Leave the default as is unless you've got a really good reason to change it.

Sending a Document as Email

1. Make sure your email program is running and that you're connected to the Internet.

2. Open the program and the document you want to send as an email.

3. Choose File > Send > Document as Email, or File > Document as Email.

4. Your specified email program will appear, showing you a new empty email with the document attached, as shown in Figure 5-48.

   Figure 5-48. Sending a document as an email

Making an HTML Version of a Document

This varies from application to application. However, in general you can choose File > Save As, or File > Export, and select the HTML format.

You can also, in HTML, choose View > Source, then choose File > Export Source.

For information on what the HTML itself is like, see What OpenOffice.org HTML Is Like on page 449.

Note that when you Save As in Writer, you only get the Web (Writer) option, which is not in fact actual HTML. Not even if you make sure you add an HTML file extension. One main tipoff is that the View > Source option is not available. They often look the same way when viewed in a browser, but not always.