Publisher Overview
Last Modified: 3/27/2000
|

|
|
Dispatch Publisher is the tool you will use to organize and prepare your publication to be placed on the web. The Publisher interface allows you to
- import and analyze files,
- set columns, sections, and pagination,
- catalog story and image content, and
- build and publish the issue.
This section of the documentation covers each step of the Publisher process in detail. It's illustrated with numerous screen captures, and contains important tips and hints for getting the most out of Dispatch.
Preparing Files
Last Modified: 3/27/2000
|

|
|
Before logging in to Dispatch, you will need to prepare your content and images so they are in a format which can be read and understood by the Dispatch database.
C O N T E N T
Content must be in one or more of the following formats. The characters within the parenthesis are the identifying file extension for that format. For example, if you are uploading a file in the QuarkXPress tag format, the file name must end with .xtg (ie: film.xtg or music.xtg).
- QuarkXPress Tags (.xtg)
- ASCII (.txt)
- HTML (.htm or .html)
If you use QuarkXPress for your printed publication, we recommend using the XPress tags format. This format passes along stylesheet information from your print publication that Dispatch can use to pre-fill your database fields, saving you time in the cataloging phase.
I M A G E S
Images must be in the standard web formats of GIF (.gif) or JPEG (.jpg or .jpeg). If you are currently working with TIFF or another rich image format, we recommend using Adobe Photoshop to convert your images to one of these supported formats.
NOTE: Make sure that your images will fit within the design of your site. You will probably need to set a maximum pixel width for all story-related images.

Transferring Files
Last Modified: 3/27/2000
|

|
|
After preparing your files (stories and images) for importing, transfer (FTP) those files to the Dispatch server:
- Connect to your Dispatch FTP host using your preferred FTP client.
- Transfer your files (stories and images) to your "uploads" folder.
- Close your FTP session (log out).
NOTE: Make sure your FTP client is configured to transfer files in the appropriate binary or ASCII format. See Configuring FTP Clients for more information.

Logging In
Last Modified: 5/11/2000
|

|
|
Connect to the Dispatch server with your preferred web browser. The access URL will be provided when your account is set up. You will be prompted for your username and password to connect. Once connected, choose "New Session" to begin your session.
If you are returning to Publisher to continue an open session, you will see a message similar to the one to the right, with a notation of when you last left Publisher, the current time, and your user name (circled in red in the illustration).
Publisher will always return you to the screen you were on when you left the session.
Select Issue
Last Modified: 3/27/2000
|

|
|
Enter the date of the issue you wish to create or edit. The date must be in the mm-dd-yyyy format (03-07-2000). You may click on the date presented in red in the instructions, and it will be entered in the text box in the appropriate format. If this is not the date of the issue, you may edit the date.
Click the "Next" icon to continue.
The next screen allows you to
- Create a new issue with the date you entered,
- Choose an existing issue to edit from the dropdown list, or
- Search again for another issue date.
Click the "Next" icon to continue.
Set Issue Values
Last Modified: 3/27/2000
|

|
|
Set the volume number, issue number and end date for this issue. Dispatch will, by default, set these values based on your previous usage.
Dates must be in the mm-dd-yyyy format (04-01-2000). Using Dispatch tags, you will be able to re-format these values in your templates, choosing to use long date, short date, Roman numeral, decimal and other formats.
Click the "Next" icon to continue.
Files Found
Last Modified: 4/6/2000
|

|
|
Files Found is divided into three primary sections: interstitials, files found, and unknown and ignored files. They are all independent and will only show up if they are relevant to the issue you are building.
Interstitial Section
At the top of the Files Found screen you have an opportunity to select which interstitial pages will run in the issue being built. By default, the pages which were selected during the last build are automatically pre-selected.
If you want an Interstitial to run in this issue, make sure it is checked. If you do not want it to run, make sure it is unchecked.
Files Found Section
The next section of the Files Found screen lists the files Dispatch has found in your upload folder, separating them by stories and images.
TIP: If you realize you have forgotten to upload some of the files you need at this point, you may FTP them to the uploads directory now and press "reload" in your browser. They will be added to the list of Files Found. You may also delete or rename files using your FTP client.
If files are listed in red and you receive an error message about your files, this means that Dispatch has detected corrupt files.
Corrupt files usually fall into two categories:
- FTP Transfer Errors - In this scenario, a file has been uploaded as a binary file that should actually be an ASCII file, or a file has been uploaded as an ASCII file that should be a binary file. This is a common error with QuarkXPress tags, since FTP clients do not automatically know that they are ASCII files and will upload them as binary files if the FTP client is not properly configured. Please see configuring Macintosh and Windows FTP clients for more information on this topic.
- Wrong File Format - In this scenario, a file may be named .gif, but it is actually a Tiff or a Jpeg. Another common mistake is naming a file .xtg, but actually exporting the file from Quark in a different format. To fix this type of error, simply check the file format again and resave it from Quark or Photoshop in the correct file format.
Dispatch will not delete or import any corrupted files it detects. Instead it will leave them in your uploads file for you to fix.
Unknown and Ignored Files Section
The bottom portion of the Files Found screen lists unknown or ignored files. These are files Dispatch will ignore, but still pass on to your web server. If you do not want these files passed on to your web server, you must delete them with your FTP client before continuing.

New Interstitial Definition
Last Modified: 4/4/2000
|

|
|
An interstitial page in Dispatch is one not associated with any story content. For example, a table of contents page is an interstitial page, since it is only a listing of links to other stories, and not a story itself.
To create an interstitial page for your document, click on the hyperlinked "You may add a new interstitial here" on the Files Found page.
On the resulting screen, you will define to define a Column ID and a Column Name for the interstitial page as well as assign it to a specific section.
The Column ID will define how the interstitial file is named. For example, if the column ID is "index", the resulting interstitial filename will be "index.html".
The name can be entirely descriptive. For example, if you create an interstitial as your home page ("index.html"), you would probably name the interstitial "Home Page".

File Analysis: Overview
Last Modified: 4/10/2000
|

|
|
When Dispatch imports your Xtg files, it begins by identifying the embedded QuarkXPress styles, fonts and characters. Any of those which are not currently in the Dispatch database are shown in the first file analysis screen in green. These items will be presented on subsequent screens for identification.
Once all styles, fonts and characters have been identified, Dispatch converts your documents to HTML and
completes the file analysis by displaying any material it has determined belongs in the database fields, such as headlines, subheadlines, authors, etc.

File Analysis: Characters
Last Modified: 4/4/2000
|

|
|
Dispatch analyzes QuarkXPress Tag Files (.xtg files) in three stages: Dispatch first locates extended or high-ASCII characters and asks for HTML equivalents. Then, Dispatch identifies each Quark Style for proper HTML treatment. Finally, Dispatch asks for HTML replacements for specific fonts. This process only happens the first time Dispatch encounters a new character, style or font.
C H A R A C T E R R E P L A C E M E N T
Within Quark, many publications use characters (usually some kind of punctuation) that haven't been standardized. Examples include "smart" quotes or letters with accents. Because these characters can vary from font to font, there's no way for Dispatch to translate them, so it asks you what they are. You're only asked about each unusual character within a font once.
For each unknown character, you will be given information to help identify what it should be:
- What font contained the character
- Which file first contained the character
- An example of the character in use from one of your files
- The character's decimal ASCII value (highlighted in red)
In the example above, highlighted in red (#213), is the ASCII value for the character in question. Ignore the value; it is just a placeholder for where the character appears in your content. From the context above you can see that this character is an apostrophe. Though the character is often obvious in context, you may occasionally need to look at your publication's original Quark file to know what character is being used.
TIP: Dispatch can't just use a character's ASCII value for translation, but when you become familiar with font families, this value can help you identify characters.
Once you know the character you want to use, type it in the "HTML Substitute" text box. The link titled "choose" will open a small browser window containing a character map. If you click on the appropriate substitute in this window, it will be automatically entered into the text box. This feature is useful for hard to find characters such as the copyright or trademark symbols.
IMPORTANT: Do not enter characters that require other keystrokes to compose, such as the 'Control,' 'Command', 'Alt' or 'Apple' keys. Use the choose menu or escape them according to the HTML standard. You may use either the ASCII (é) or name code (é).
TIP: You can place more than one character into the "HTML Substitute" text box. You can enter image pathnames, for instance, to replace art font characters (like a dingbat), or blocks of text/HTML, too. If you do replace a character with an image, we recommend using an absolute URL.
If you are unable to identify the appropriate character, you can insert a placeholder of some sort, such as an HTML comment. Later, when you have found the correct character, you can edit the entry in the Edit Font Settings section of the Dispatch Style Manager. Don't forget to also manually edit the story which contained the character you were unable to identify during import!

File Analysis: Styles
Last Modified: 3/27/2000
|

|
|
Dispatch analyzes QuarkXPress Tag Files (.xtg files) in three stages: Dispatch first locates extended or high-ASCII characters and asks for HTML equivalents. Then, Dispatch identifies each Quark Style for proper HTML treatment. Finally, Dispatch asks for HTML replacements for specific fonts. This process only happens the first time Dispatch encounters a new character, style or font.
S T Y L E D E F I N I T I O N
Using styles in Quark offers two advantages for converting files in Dispatch. First, the style information can be used to automate data entry. If every time a headline appears in your publication, you use a Quark Style, Dispatch can pull the headlines out of your stories and put them into your database. This saves time and helps prevent typing errors. Second, using Quark styles with Dispatch improves HTML conversion and layout by allowing you to designate specific HTML treatment for each Quark style that is used in your publication.
UNDER THE HOOD: When Dispatch converts .xtg files to HTML, it handles each piece of text marked by a Quark style in the order encountered. If a Quark style has HTML assigned to it, that HTML is placed before and/or after the text marked by the Quark style. If a style is assigned to a database Field, Dispatch copies the text to the database or adds this text to the story field if it's also part of the story body (Add to story). Now Dispatch is ready to move on to the next Quark style in your .xtg file.
When Dispatch encounters a Quark style it's never seen before, it will need to know a few things:
- Should any HTML be inserted before or after each occurrence of this style?
- Does this style mark a database field, and if so, what field does it mark?
- Is this part of the body of the story?
- What should Dispatch do if it finds this style more than once in a single article?
Dispatch gives you three pieces of information to help you decide what should be done with a particular Quark style: the name of the style, what file it was first seen in, and some sample content marked by the style.
For simplicity's sake, it's best to think about your Quark styles in two ways, story styles and database styles.
Story Styles
Sometimes, the body of an article is made up of several Quark styles. These styles don't mark headlines or bylines, so they're not important to the database, but they can have specialized HTML treatment. For these kinds of styles, select -Not a field- in the Field dropdown, and make sure Add to story is checked.
QUESTION: Not important to the database? Isn't the story a database field?
ANSWER: Yes, but it's handled differently, so it's easier to think of the story as text that Dispatch knows about, but that isn't really in multiple database fields.
Anything placed in Beginning text will be inserted before each occurrence of the Quark style in question, and, likewise, anything placed in Ending text will be inserted after each occurrence. If you leave these text areas blank, the content will be translated normally.
The last dropdown, marked ignore, is only used with Quark styles that have database fields assigned to them, so for story styles, keep it set on ignore.
Database Styles
These Quark styles mark pieces of data, i.e., database fields such as Headline, Byline, Summary, Subheadline, UDFs and others. You'll probably want to leave the Beginning and Ending text boxes empty, since the publication templates you use will most likely handle any HTML formatting for these items, and it's better to import fielded data with little or no HTML.
The Add to story checkbox determines whether or not content marked by this type of Quark style will be considered part of the story body (in other words added to the story). Most often, database styles are not added to the story and are best removed from the story.
The last dropdown, which defaults to Ignore, is used only if the Quark style is a database style (i.e., the Field dropdown is set to something other than -Not a field-). It tells Dispatch how to insert data into the database when there are multiple occurrences of the same Quark style in a single document. The value of the dropdown is applied to the content of each Quark style following the first one. If it's set to Ignore, Dispatch ignores every occurrence after the first.
- Ignore -- Dispatch will use the first occurrence of this Quark style in the database, and ignore the rest. For example, in a column of short notes, the headline from the first note might be used for the entire column.
- Another -- Used specifically for image captions, artists, pull quotes, and multiple user defined fields.
- Append -- Append all the occurrences of this Quark style together, and then put them all into the database. For example, in a column of brief movie reviews, all movie names might be appended for inclusion in the database.
- Replace -- Dispatch will use only the last occurrence of the Quark style

File Analysis: Fonts
Last Modified: 4/4/2000
|

|
|
Dispatch analyzes QuarkXPress Tag Files (.xtg files) in three stages: Dispatch first locates extended or high-ASCII characters and asks for HTML equivalents. Then, Dispatch identifies each Quark Style for proper HTML treatment. Finally, Dispatch asks for HTML replacements for specific fonts. This process only happens the first time Dispatch encounters a new character, style or font.
F O N T D E F I N I T I O N
When Dispatch detects a font that it has never encountered before, it allows you to define what HTML to associate with it. Is it a bold font? An italic font? Serif, Sans-Serif? Using the Beginning text and Ending text boxes, you can have Dispatch handle every piece of text associated with a particular font.
In the example above, you would define the font Folio-Bold Condensed by putting the opening and closing bold HTML tags (<b></b>) into the appropriate text boxes. This would ensure that whenever the Folio-Bold Condensed font was used, the resulting HTML text would be bold.
TIP: You can use any HTML for the beginning and ending text, including font tags, cascading style sheet definitions, or XML. We highly recommend using style sheets.

Identifying Stories
Last Modified: 3/27/2000
|

|
|
If Dispatch can't associate a file with a known column, or if you choose not to use the Dispatch file naming conventions, you'll be presented with an identification screen. Simply choose the column with which each file is associated with, or mark the file as "-New-" to create a new "column definition." You may also choose to delete a story at this time.
NOTE: You can click on a file name to view the HTML conversion of the story for reference.

Identifying Images
Last Modified: 4/10/2000
|

|
|
If Dispatch can't associate an image with a known column, or if you choose not to use the Dispatch file naming conventions, you'll be presented with an identification screen. From the dropdown list, choose the story with which each image is associated.
Certain kinds of images -- such as those associated with interstitial pages -- should be "ignored". These images will be passed along by Dispatch into the issue folders, but no information about them will be stored in the database and you won't be prompted for any cataloging information.
NOTE: You can click on a file name to view the image. You may also click view story to view any story in the dropdown list for reference.

New Column Definition
Last Modified: 3/27/2000
|

|
|
To define a new column, select a column ID, column name, the default section a column should belong to, and if a column should be paginated or not (it usually should be). The column ID is used to associate imported files with this column and will become a permanent setting when you publish the issue within which it is created.
- The column ID must be in lowercase, containing only alpha characters and the underline (_) symbol. (For instance, book or book_review.) The column ID serves several purposes:
- Dispatch uses the column ID when naming the file for publishing on the web. Thus, if you use "book" for your book review column, the resulting web page will be called "book.html." If there is a second book review in any issue, it will be named "book2.html."
- The column ID is the name by which Dispatch will identify the book review column in queries and other related functions.
- Finally, this is the name to use when preparing Xtg files for uploading. If you name your file "book.xtg," Dispatch will automatically associate the file with the correct column name. Otherwise, Dispatch will give you an opportunity to identify the file.
- The column name is the name you would formally call your book review column. It might be "Book Review" or "Books" or something like "Between the Covers."
- Each column must be assigned to a section. Sections can be identical to those contained in your print publication, but they do not have to be. Sections are set up during the initial preparation of your account, but new sections can be added at any time.
To create additional column defaults at this time, click the "more defaults" hyperlink.
NOTE: You can change these settings at any time by accessing "edit column defaults" from various areas within Dispatch.

New Section Definition
Last Modified: 3/27/2000
|

|
|
If you need to create a new section for your publication, click on the "New" icon next to the Section dropdown list on either the New Column Definition or Column Defaults screens.
Give your new section both a name and an ID. The ID is usually similar to the name, but without spaces or upper case letters. The ID becomes a permanent part of the database once an issue has been published, but the section name may be edited at any time.
At the same time you create your new section, place it in sequence with the other sections in your publication. Use the dropdowns on the left to order the sections before you click on the "Update" icon at the bottom of the page.
NOTE: A Section and a Column may share the same name and ID.
Pagination
Last Modified: 3/27/2000
|

|
|
Pagination provides control over how your online publication will take shape. By default, Dispatch remembers your previous and historic pagination, so you won't need to adjust a thing. However, should you chose to do so, the following are a few of the options available:
- Change the sequence of stories as they are displayed on a table of contents, or as "suggested links" generated by Dispatch tags, using the numbered dropdown list on the left.
- Adjust the order of pages within a section or the entire issue. (This is particularly useful for linear "page forward" or "page back" designs.)
- Move an article into a different section, using the dropdown list on the right which contains the names of the sections you have created.
- Incorporate interstitial pages (pages threaded between articles within an issue). Interstitial pages are commonly used as table of contents and sponsor pages.
TIP: After reordering the stories in a section, you may click the "Apply" icon located beneath each section and Dispatch will redraw the current page with the new order in place.
Pagination also allows you to view or edit the content of a story, view any associated images, or change the defaults for a particular column.
- To view a story, use the hyperlink which contains the name of the column, such as Feature or Letters. To view an image associated with a particular story, use the hyperlinked numbers. Both the story and any images will pop up in a small new browser window. You may close this window when you are finished looking at the story or image.
- To edit the contents of a story, click on the hyperlinked [edit]. Dispatch will move you into an editing screen. When you finish any editing and press the "Update" icon, you will be returned to the Pagination screen.
If your publication contains more then 40 stories, Pagination will be displayed on several screens in succession, according to the sections you have defined.

Edit Story Data (super edit)
Last Modified: 4/7/2000
|

|
|
From the Pagination, Story Cataloging, or Review pages, you may choose to edit the contents of the story by clicking on the "edit" hyperlink.
Depending on your preferences, you may see just the story data in a text box, or you may see all fields related to the story, including headline, subheadline, author, and summary, as well as any associated images and the fields connected to them. Any of the content present can be edited.
TIP: If extensive editing of the story data is necessary, it may be easier to first copy the entire story and paste it into another text or HTML editor.

Story Cataloging
Last Modified: 4/10/2000
|

|
|
Story Cataloging is where most of the database input occurs. General fields include headline, subheadline, author credit type, author name, and story summary. User-defined fields will also be displayed during Story Cataloging.
Most of this information is automatically filled in by Dispatch based on column defaults and information derived through the file analysis of uploaded stories. Additional information may be manually entered.
Story cataloging has some additional features, such as referential pop-up windows of stories and images, and links to change a column's default settings. Default settings are most commonly used for reoccurring columnists or columns with static headlines or summaries.
If a User Defined Field (UDF) is listed in red, that means the UDF is no longer linked to this column, although the data is still in the database. You can change what UDFs are linked to a column by choosing "Edit Column Defaults".
To enter multiple values for an author or UDF, use the pipe character "|" to separate the values. For example: "Calvin|Hobbes" Do not use a comma or space on either side of the pipe character!
If the value you want to enter actually contains a pipe within it, like "C|Net", you can escape the pipe by typing \| to escape the pipe. For example: "C\|Net".

Column Defaults
Last Modified: 4/10/2000
|

|
|
Column defaults can be edited from the New Column Definition screen or any place where you see "Edit Column Defaults."
Required Fields
The required fields were defined at the time the column was created. You can change the column name at any time, but it must always have a name. You can not change the column ID as it is a locked value that is used in templates and file naming.
Publisher Fields
The publisher fields are all optional, but we recommend minimally setting a section and pagination value. Values can also be entered for default headline, subheadline, author credit type, author name, summary, and meta tag information.
Information obtained during file analysis, such as a headline style in a QuarkXPress document, will override a default value. You may also manually change these values from Story Cataloging or Super Edit.
Why would you set a default value? For example, if a column always runs in the same section, or always has the same headline, author or summary, you can save yourself some time by setting default values.
User Defined Fields
The user defined fields (UDFs) are fully customizable by column. Click "Add a Field" to link UDFs to the column. Use the position drop-down to sequence the order of the UDFs for that column or to unlink a UDF from the column.
In addition to linking UDFs to a column, you can set a unique default value per column. This is particularly useful for sub-sections or story types. For example, if a particular column always runs in the sub-section "Reviews" in your film section, you could set it's sub-section UDF to Reviews.

Available User Defined Fields
Last Modified: 4/10/2000
|

|
|
The User Defined Fields (UDFs) listed are the current UDFs available to your publication. If you would like to add a new UDF field, please write Dispatch support with your request. UDF field types can be radio buttons, check boxes, select boxes (aka drop-downs), text or text areas.
To link a UDF to a column, simply check the requested fields. To unlink a UDF from a column, uncheck the check box.

Image Cataloging
Last Modified: 3/27/2000
|

|
|
Image Cataloging allows you to enter captions, assign artist credit type and name, provide "alt" information for an image, and, if necessary, re-order the image within the story or assign it to a different story.
You may also view the associated story and a full-sized version of the image itself, both of which are presented in pop-up windows.
Cataloging images and their related information will allow you to build archive pages for artists, photographers, illustrators, etc. Readers will then be able to browse other works by a particular photographer or bookmark their favorite artist's archive pages.
Person Definition
Last Modified: 7/19/2000
|

|
|
When an author or artist is added to your publication database for the first time, Dispatch allows you to further define this individual.
The first screen allows you to enter or correct the author or artist's first, middle and last names. Spell all names as they should appear in print, with capital letters where appropriate, and periods after initials. Place "Jr." or "Sr." or other suffixes in the box with the last name.
If a similar author or artist name already exists in the database, the title "Similar Names" will appear, and the Action dropdown will contain one or more names, in addition to the "New" and "Delete" options. If none of the names presented if the same person, set the dropdown to "New".
If you click on the hyperlinked more defaults, you will be taken to a second screen, from which you can also supply an e-mail address and homepage URL. Only the name elements are required.
Dispatch will automatically delete certain kinds of information which may be contained within the Quark style that identifies the author or artist, i.e., the word "by" or the em dash. Occasionally, however, Dispatch may recognize an author style within a Quark document that contains other textual material. If such unusual strings show up, simply set the dropdown to Del.
Tracking the author or artist information gives you the ability to:
- Automatically provide links to an author/artist's e-mail address, homepage or archive page.
- List recent articles by an author or other images by an artist within your templates.
- Generate archive pages listing every article or image ever contributed by an author/artist.
- Create "homepages" for each author or artist.
All of these features and more can easily be added to your design using Dispatch tags and your imagination.

Review
Last Modified: 3/27/2000
|

|
|
Review provides a final opportunity for access to each story and image within an issue, allowing for last-minute changes before publishing. It is identical to Pagination in function.
When you are finished with the Review, click the "Next" icon to move to Build.

Build Issue
Last Modified: 3/27/2000
|

|
|
The initial Build Issue screen prompts you to select the appropriate template set for building the current issue. Generally this will be the Default Template Set, but you may create special template sets for special issues.
You may choose to have Dispatch show you debugging information during the build. This is generally only necessary when there is a problem with the process.
You may also choose to skip the build of your issue and simply commit all the information to the database.
When you click the "Next" icon, Dispatch will begin building your issue.
The building screen provides a visual report of what happens during the actual creation of an issue.
Dispatch will show the files being built, including any related spawns.
Warnings or errors will be shown in red.
The page will scroll down automatically, tracking the progress of the build.
IMPORTANT: While the issue is building, do NOT press stop in your browser, do not logout, and do not go to another page within this browser window. Doing so will cancel the build.
When the build process is complete, a hyperlink to the issue you just built will be presented. You can look through the entire issue at this point, noting any corrections or changes which need to be made.
If there are additional edits to make, you can go back and make them now. If you are satisfied with the issue you have built, click on the "Next" icon to continue.

Ready to Publish
Last Modified: 3/27/2000
|

|
|
After your issue has been built and you are satisfied with its appearance, the initial Ready to Publish screen appears. When you click on the "Publish" icon at the bottom right of this screen, the current issue and all other associated files, will be published to the Internet.
The Publishing screen shows the directories and files being written during the process.
When the process is complete, you will be prompted to log out. You may do so with the "Logout" icon at the very top of the page.

Logging Out
Last Modified: 4/10/2000
|

|
|
You will be asked to confirm that you wish to complete the log out process. You have three choices:
- Cancel - If you wish to return to Dispatch
- Leave - If you wish to return to the current session at a later time to continue the publishing process
- Logout - If you wish to finish logging out
If you try to log out of Dispatch while it contains information that has not been committed to the database, you will receive a warning. If you do not wish to lose information, choose "Cancel" or "Leave" at this point so you can continue your work.
Publisher Preferences
Last Modified: 7/20/2000
|

|
|
Dispatch allows you to set various preferences. This is done by editing the .dispatch_preferences file found in your home directory.
If you don't have a .dispatch_preferences file yet, simply create a text file with any preferences you want, name it .dispatch_preferences and upload it in ASCII format to your account. If you need any assistance with this, please contact Dispatch support.
A common .dispatch_preferences file might contain this:
auto_url_target = _blank
pagination_style = all
review_skip = 1
pagination_show_filename = 1
The following is a list of currently available preferences:
- Artist_Serial_Comma = AP, White, or List
Sets the serial comma style you prefer. Examples of the styles are listed on the UserField_Serial_Comma preference..
Values: AP, White or List
Default: AP
- Author_Serial_Comma = AP, White, or List
Sets the serial comma style you prefer. Examples of the styles are listed on the UserField_Serial_Comma preference..
Values: AP, White or List
Default: AP
- auto_url_limit = #
This preference is used to limit the number of times a URL will be converted to a link within a single story. It will link the same URL only that many times -- if it shows up more than that number of times in the same file, further instances will be ignored. When set to 0, no URLs will be linked.
Values: 0 or greater
Default: Infinite
- auto_url_target = window_name
When Dispatch converts your stories to HTML, it automatically creates links to web sites and email addresses. You can use this preference to have Dispatch automatically give the link a target window name. Great for opening a new browser, or targeting a framed window.
Values: target window name (e.g._blank)
Default: n/a (no target)
- close_p = 0 or 1
This preference tells Dispatch to use single <p>'s for paragraphs (the default) or closed p's <p></p> for paragraphs when converting Quark xtg files to HTML.
Values: 0 or 1
Default: 0 (just <p>'s)
- edit_story_parts = catalog, story, images
Allows you to choose what content items you want to see when you press edit from Pagination or Review.
Values: catalog, story, images
Default: catalog, story, images
- emdash_style = {replacement characters}
Allows you to define how you want Dispatch to convert internal QuarkXPress emdashes. The default conversion is "--"
Values: any replacement characters you want
Default: --
Examples:
emdash_style = --
emdash_style = --
emdash_style = —
emdash_stle = <img src="http://www.mypub.com/images/emdash.gif"
width="5" height="6" alt="--">
Note: we do not recommend using — as it is not an accepted standard.
- file_extension = value
This
preference will allow you to change the default file extension (.html) that
Dispatch adds to stories. This is a global preference and will only effect
stories that get built by Publisher "after" you add the preference.
Values: .html, .asp, .php, .shtml, .anything_you_want
Default: .html
- ftp_publish = value
By default Dispatch publishes to a local directory on the same machine, or uses NFS to publish to a remote machine. A third option is FTP publishing to a remote machine. NOTE: Like NFS publishing, this option should only be setup by a DesertNet technician or the system administrator in charge of your Dispatch installation. This feature requires that you have an FTP server running on your destination web server.
Values: (see below)
Default: n/a
To enable FTP publishing, simply add one of the following to your .dispatch_preferences file:
For Unix Web Servers:
ftp_publish = ftp://user:password@host.domain/home/pubname/
For Windows Web Servers:
ftp_publish = ftp://user:password@host.domain/c:/apache/htdocs/pubname/
For Macintosh Web Servers:
ftp_publish = ftp://user:password@host.domain/HardDriveName/path/
For VMS Web Servers:
ftp_publish = ftp://user:password@host.domain/disk$desnet/pubname/www/
- http_cache_timeout = 0
Duration of time, in seconds, that Publisher's HTML pages will be cached by the browser. By default pages are not cached at all. Set it to a longer time (eg. 60) to allow 'View Source' for debugging purposes.
Values: time in seconds
Default: 0
- ignored_files = cover.jpg, *-large.jpg
Filename wildcards for files you want
Files Found to automatically ignore. Ignored files are not processed
and are safely kept aside until you publish. Note: you may only use one * wildcard per pattern match.
Values: comma separated filenames and wildcards.
Default: <nothing>
- ignored_publish = current, micro_sites.html, tv.html
A list of filenames and/or directories you do not want Dispatch to publish. This is most commonly used to prevent the "current" directory from publishing, or to prevent a configuration file, like micro_sites.html, from publishing.
Values: comma separated filenames and wildcards.
Default: <nothing>
Note: you may list files or directories, but can not list combinations of files and directories.
- pagination_show_filename = 1 or 0
Used to display the original uploaded file name on Pagination/Review. This is only visible until you publish the issue.
Values: 1 or 0
Default: 0
- pagination_skip = 1 or 0
Allows you to skip the pagination page if you want to. This was created for users who would prefer Pagination, or Review, but not both. NOTE: It is NOT recommended to skip both.
Values: 1 or 0
Default: 0
- pagination_style = all or section
Tells Dispatch to display all the stories on one Pagination page or to break up Pagination into multiple pages by section.
Values: all or section
Default: The default is "all", but Dispatch will automatically break it out into sections if there are too many stories in a section. This is to prevent a browser ceiling limitation.
- pagination_threshold = #
Preference to set the maximum number of stories per page in Pagination. NOTE: Setting this threshold higher is not recommended, as it may push browser memory limitations.
Values: any decimal number
Default: 40
- publish_current = mirror or repository
This preference defines how you want Dispatch to manage your "current" directory. Mirror would mirror your latest issue in the current directory. Repository would always contain the latest issue like mirroring, but it would also contain miscellaneous files from your previous issues that weren't overwritten by your latest issue. There are design benefits and cons to both settings.
Values: mirror or repository
Default: repository
- review_skip = 1 or 0
Same as pagination_skip, but refers to skipping the Review page or not.
Values: 1 or 0
Default: 0
- review_style = all or section
Tells Dispatch to display all the stories on one Review page or to break up Review into multiple pages by section.
Values: all or section
Default: The default is "all", but Dispatch will automatically break it out into sections if there are too many stories in a section. This is to prevent a browser ceiling limitation.
- review_threshold = #
Preference to set the maximum number of stories per page in Review. NOTE: Setting this threshold higher is not recommended, as it may push browser memory limitations.
Values: any decimal number
Default: 40
- silent_publish = 1
Disables the detailed publish information that displays while Dispatch is publishing an issue.
Values: 1 or 0
Default: 0
- UserField_Serial_Comma = AP, White, or List
Sets the serial comma style you prefer.
Values: AP, White or List
Default: AP
Examples of styles:
AP (Associated Press):
sci-fi, horror and comedy
ham and eggs
White:
sci-fi, horror, and comedy
ham and eggs
List:
sci-fi, horror, comedy
ham, eggs
|