PageSpinner Master HTML with the HTML Editor for Mac OS! PageSpinner Globe
PageSpinner Home News archive Download PageSpinner Get Support Buy PageSpinner

Frequently Asked Questions for PageSpinner 5

Expand1.0 GENERAL ISSUES
1.1 About this FAQ
1.2 Navigating the FAQ

Expand2.0 DOCUMENTATION
2.1 Additional documentation
2.2 Additional help

Expand3.0 WORKING WITH PAGESPINNER
3.1 How do I change the background of a page?
3.2 Creating multiple pages
3.3 Creating clickable Image Maps
3.4 Why is there no keyboard shortcut for some frequently used tags?
3.5 How can I customize the New Empty Page created by PageSpinner?
3.6 How can I use PageSpinner to view HTML source downloaded by a browser?
3.7 The preview is not displayed in my browser

Expand4.0 THE EDITOR
4.1 The text looks strange after a Restyle command
4.2 The HTML page is displayed in mono-spaced text after a Restyle command
4.3 Some characters in my page are not displayed correctly on my Web site
4.4 How can I go to a specific line in the editor?
4.5 The editor display flickers when typing with Live Preview is enabled
4.6 Errors with files located on a mounted AppleShare server

Expand5.0 FRAMES
5.1 Blank page when creating a page with frames
5.2 Getting into a frame
5.3 Getting out of a frame

Expand6.0 MISCELLANEOUS TOPICS
6.1 Where is the Notebook stored?
6.2 Double-byte input
6.3 Locating errors in PHP files
6.4 Editing PageSpinner files with a Unix text editor
6.5 Is there a Windows version available?

Collapse 1.0 GENERAL ISSUES
1.1 About this FAQ
What is this FAQ about?
 This FAQ, short for Frequently Asked Questions, is a compilation of the most common questions asked about PageSpinner. It is recommendable to read this FAQ before sending in a question.

PageSpinner is an HTML for Mac OS, that supports HTML 3.2, HTML 4, XHTML 1.0, JavaScript, PHP and CSS. PageSpinner is useful for both the beginner and the more advanced web author with quick access to often used formatting tools and support for AppleGuide and an HTML Assistant that helps you compose your HTML pages.

Contents

1.2 Navigating the FAQ
How do I browse this FAQ?
 The following navigation buttons may be used when you view the FAQ in your browser:

   Expand section Expand section

   Close section Close section

   Go to TOC Go to the table of contents

Contents

Collapse 2.0 DOCUMENTATION
2.1 Additional documentation
Is there any other documentation available? Is there some documentation I can print?
 In Mac OS X there is a searchable PageSpinner On-line Help book available from the Help menu.

Most of the documentation can be viewed and printed using your favorite browser. Select the menu item Documentation in the Help menu to view the index in your browser.

An AppleGuide tutorial on how to work with PageSpinner is available in the Help Menu in Mac OS 9.

Contents

2.2 Additional help
Where can I get help with topics not covered in this FAQ?
 Go to the PageSpinner support page where you can find more help and on-line resources for PageSpinner.

Contents

Collapse 3.0 WORKING WITH PAGESPINNER
3.1 How do I change the background of a page?
How do I change the background and text colors and add a background image?
 Delete the old <BODY ....> start tag. Use the HTML Assistant's Body Topic to create a new body start tag.

Contents

3.2 Creating multiple pages
How do I make my web site have multiple page as opposed to one long scrolling page? For instance a home page and then other pages that are linked to it.
 Create the new page, add the text you want and save it in the same folder as the home page. The home page should often be called index.html or welcome.html (you will have to check this with the Webmaster at your site). Then do the following:
  1. Open your home page in PageSpinner.
  2. Place the cursor where you want the link to be inserted.
  3. Select HTML Assistant from the Windows menu.
  4. Select the Link topic.
  5. Click the open button (in the upper right side of Assistant's window) and select the newly created page you want to link to.
  6. Type the text that should be used as the link's title in the Title field.
  7. Click the Apply button at the bottom of the Assistant's window.

You will now have a link to the new page in your home page.

Contents

3.3 Creating clickable Image Maps
Can I create a clickable image map with PageSpinner?
 PageSpinner has only limited support for creating image map tags.

MapSpinner is a free application for creating image maps visually. There is a shortcuts to this application in the Tags : Image Map menu.

Press the option key when selecting the application in the menu to view additional information about the application.

Contents

3.4 Why is there no keyboard shortcut for some frequently used tags?
I would like to have keyboard shortcuts for the commands I frequently use.
 You can add your own keyboard shortcuts to all menu items by doing the following:

Press Ctrl+Option+Command when selecting an item from the menu that contains the command that you want to add a keyboard shortcut to.

PageSpinner will then display a floating menu palette with buttons for the menu items in the menu.

Then press the Ctrl-key when clicking on an item in the palette to define the keyboard shortcut.

Contents

3.5 How can I customize the New Empty Page created by PageSpinner?
How can I change the contents of the new empty page created at startup and when I use the New Empty Page command in the File menu?
 Create a PageSpinner HTML file named "default.html", choose your preferred editor mode and save this file inside the "PageSpinner User Data" folder. You may also use the script Select Default New Page... from the Script menu to choose an existing HTML file to be copied to the "PageSpinner User Data" folder and renamed to "default.html".

The contents of this file will then be used as a template when PageSpinner creates a new page.

Contents

3.6 How can I use PageSpinner to view HTML source downloaded by a browser?
How can I use PageSpinner to handle pages downloaded with my browsers "Show Document Source" command. The downloaded files contains strange characters and line feeds, and are virtually impossible to read or edit.
 Us the menu item Convert From Source... available in the menu Edit : Convert or in the Find button's pop up menu in the toolbar.

PageSpinner will then remove or translate unnecessary line feeds and high ASCII characters and restyle the text automatically.

In some browsers you may specify that PageSpinner should be used as the helper application for viewing downloaded HTML source files.

Contents

3.7 The preview is not displayed in my browser
A preview of my page isn't displayed in my browser when I use PageSpinner's Preview command or click the Preview button in the toolbar in OS X.
 When a preview is not displayed in your selected browser in OS X, please perform the steps described at this page.

Contents

Collapse 4.0 THE EDITOR
4.1 The text looks strange after a Restyle command
When I click the restyle button, the contents of the page is displayed in a strange font or doesn't show up at all.
 This is most likely caused by a corrupted font or a font conflict ID in your system.

If you don't have a font checking tool you may do the following:

Remove some or all of your third-party fonts from the Font folder inside your System folder. Then add a few at a time, launch PageSpinner and see you can find the damaged font.

Contents

4.2 The HTML page is displayed in mono-spaced text after a Restyle command
When I click the restyle button the contents of the page is displayed in black mono-spaced text without any color coded tags.
 PageSpinner supports six editing modes:
  • Text Mode for working with plain text files, log files and other text files
  • HTML Mode for editing HTML files
  • XHTML mode for editing XHTML 1.0 files
  • CSS for editing .css files with Cascading Style Sheet definitions
  • JavaScript for editing JavaScript files
  • PHP for editing PHP files

The first time you open files created by other editors, the editor mode will be determined by the last part of the file name, the file name's extension. If you are using a file name extensions that are unknown to PageSpinner, the file will be opened in Text Mode and and HTML tags will not be color-coded.

If you want all files to be opened in HTML mode, check the box Open files with unknown extensions in HTML Mode in Preferences : General...

You can change the editing mode for a document from the pull-down menu in the toolbar's Style button or from the menu Edit : Editor Options...

Contents

4.3 Some characters in my page are not displayed correctly on my Web site
Some of the special characters in my page are not displayed correctly after I have uploaded the page to the Web site. They look fine when I preview the local page stored on my hard disk.
 You may need to disable the option "Translate ISO characters" or similar in your FTP file transfer application's preferences to get most of the special international characters transferred correctly.

You can also change the "Default Filing Options..." in the Preferences to use the ISO Latin-1 format for all files saved in PageSpinner.

Read more about PageSpinner's filing options in "getting_started.html" and "basics.html" inside PageSpinner's Documention folder.

Contents

4.4 How can I go to a specific line in the editor?
When using an external HTML Validator, PHP, Perl or debugging JavaScrips, I need to find a given line number to edit the text.
 Use the Goto Line... menu item that is available in the Edit : Find/Replace menu.

The keyboard shortcut is Command+Option and ,

Contents

4.5 The editor display flickers when typing with Live Preview is enabled
The contents in the editor flickers when I type a character and Live Preview is enabled
 The editor display my flicker if you have:
  • "Convert quotes to Unicode entities in ISO 8859-1 files" enabled in the Default Filing Options
  • and your file is stored in the ISO 8859-1 format
  • and you use PageSpinner Include files that are stored in the Text or ISO Latin-1 file format and contain a high ASCII character.

Open each Include used in the page and set the file to use ISO 8859-1 in File : Set Filing Options... and then save the file.

Contents

4.6 Errors with files located on a mounted AppleShare server
I am getting error messages when I try to save and preview files located on a mounted AppleShare server
 This may be caused by some read/write permission setting on the file server.

You may be able to work around this by changing the permissions used by PageSpinner when opening/saving files:

Choose Preferences : General... and uncheck the boxes

  • Lock editor files
  • Lock preview files

Then quit and restart PageSpinner.

Please note that when these options are unchecked Safari may sometimes lock certain preview files.

Contents

Collapse 5.0 FRAMES
5.1 Blank page when creating a page with frames
There is only a blank page displayed when I create page with frames using the File : New... assistant.
 The Frame topics in the New Page Assistant only creates the frameset HTML page. Such a page only links to other files which are to be displayed inside the defined frames.

You will need to create two or more of the HTML files listed in New Frame dialog wich should be displayed inside the frames and place these in the same folder as the frameset page.

If you don't change the default names, the files to create are:

  • left.html
  • top.html
  • contents.html
  • footer.html

Contents

5.2 Getting into a frame
I am using frames on my pages. I have a small frame with a table of contents and another large frame containing the actual contents. How can I make a link in the table of contents to open inside the second, larger, frame?
 Add the name of the second larger frame in the field named

   "Open the link in a window or frame named:"

in HTML Assistant's Link topic when you create the link.

If you have an existing link you can add the attribute text

   TARGET="framename"

inside the <A HREF="link.html" ...> tag of the link that should be displayed in the frame named framename.

There is information on how to create frames in the PageSpinner AppleGuide and in the frame examples in the Examples folder.

Contents

5.3 Getting out of a frame
I am using frames on my pages. How can I make some links to be displayed in the full window and not in the current frame?
 If you have an existing link you can add the attribute text

   TARGET="_top"

inside the <A HREF="link.html" ...> tag of the link that should use the full window.

When creating a new link in HTML Assistant, select "_top" from the Target pop-up menu before inserting the link.

Contents

Collapse 6.0 MISCELLANEOUS TOPICS
6.1 Where is the Notebook stored?
I want to backup the contents of the built-in Notebook, where is this data stored?
 The pages in the Notebook are in PageSpinner version 4.5 and higher stored in the file named PageSpinner Notebook in the Preferences folder inside your PageSpinner User Data folder.

You may open your PageSpinner User Data folder from the menu item File : Open Special : Show User Data Folder.

Contents

6.2 Double-byte input
How can create pages that use double-byte fonts?
 Open the Preferences : Font... dialog.

Then select fonts that support double-byte display in all of the font popup menus.

Finally, check all checkboxes in the section "Double-byte Input Support" in the Font dialog.

Contents

6.3 Locating errors in PHP files
I am using PageSpinner to develop PHP pages. When an error is reported from my PHP-enabled Web server and I use PageSpinner's Goto Line command to go to the line where the error was reported, the wrong line is selected.
 You need to set PageSpinner to save PHP files using Unix line feeds, instead of the default Mac line feed settings:

Open Preferences : Default Filing Options...
Select "Unix" from the "Line Feeds" popup menu.
All new files will now automatically use Unix line feeds.

Check the box "Use these settings for all files saved in PageSpinner" to also make existing pages use the new filing options the next time you save these in PageSpinner.

Contents

6.4 Editing PageSpinner files with a Unix text editor
I create my HTML pages with PageSpinner and transfers them to a Unix-based server.

If I then try to edit the page on the server, using a terminal-based editor like vi or ee, the entire page shows up as a single line in the editor. The file has ^M where the editor is expecting a carriage return.
 You need to set PageSpinner to save the files using Unix line feeds, instead of the default Mac line feed settings:

Open Preferences : Default Filing Options...
Select "Unix" from the "Line Feeds" popup menu.
All new files will now automatically use Unix line feeds.

Check the box "Use these settings for all files saved in PageSpinner" to also make existing pages use the new filing options the next time you save these in PageSpinner.

Contents

6.5 Is there a Windows version available?
PageSpinner is nice and easy to use, but I also have to work on a PC. Is there a Windows version available?
 There is no Windows version available.

Plain HTML-files are cross-platform though, and you can set PageSpinner to use MS-DOS or Unix line feeds before transferring pages to a PC in the "Default Filing Preferences".

Contents

This FAQ was created with PageSpinner, FileMaker Pro from FileMaker Inc. and the AppleScript-based FAQ-Spinner kit included in the PageSpinner 5 distribution.
More information can be found at PageSpinner's home page:
http://www.optima-system.com/pagespinner/
Get CamSpinner
Optima System

© 2012 Optima System. All rights reserved.
MapSpinner - the HTML image map editor for Mac OS