A Guide to Quark Author Web Edition 2015 - August 2018 Update

Creating documents

New documents are created in the Quark Publishing Platform Client workspace. To create a new document, click New and choose Smart Document from Server Template, Smart Section or Smart Document from the drop-down menu. Quark Author Web Edition launches and the new document displays.

Editing documents

Existing documents are opened in the Quark Publishing Platform Client workspace. To open an existing document for editing, navigate to the repository folder containing the document to be edited. Right + click the document and choose Check Out. Quark Author launches and the selected document displays.

Document sections

Use the Smart Document pane to build the structure of the document by adding and nesting the document sections. Each document section consists of a Title and Contents.

The user can select to show or hide the Add Section option in the Smart Document pane. By default, the Add Section option is shown for new documents and hidden for checked out documents.

To add a section or sub-section, click + add Section, or + add Sub-Section, enter the title name and add your content.

Continue adding sections and sub-sections until you have built the document structure you desire.

If you attempt to add a Sub-Section before you have a Section, the editor will automatically offer to create the missing sections for you:

 

Reorganizing the document

Edit the structure of the document in the following ways:

• Move sections to a different location in the document by dragging and dropping them into the desired location.

• Use the Promote button to promote the currently selected section of the document.

• Use the Demote button to demote the currently selected section of the document.

• Use the Convert To button to change the semantic type of the selected section.

• Use the Delete button to delete the currently selected component from the document.

Use the Options button to display a drop-down menu of options available for the currently selected section of the document.

Promoting Sections

The Promote feature allows you to promote a section of your document to a higher level. The content of the section remains unchanged, only the type and level change.

If you promote a section that has sub-sections, these sub-sections are also promoted. For example, promoting Part 1:

 

You cannot promote a section that is at the highest level of your content model. In this case the Promote button will be unavailable.

Demoting Sections

The Demote feature allows you to demote sections of your document to a lower level. The demoted section will be converted to a sub-section of the previous section. The content of the section remains unchanged, only the type and level change.

If you demote a section that has sub-sections, these sub-sections are also demoted. For example, demoting Part 2 to a chapter changes Chapter 1 into a section:

 

If you demote a section to the lowest level of your content model and it contains sub-sections, the content of these sub-sections will change to regions. These generic regions appear in the Para Styles drop-down menu with the new type Region.

To reverse the process, you can use Undo to return to the original structure. Regions may not be promoted.

You cannot demote a section that is already at the lowest level of your content model. In this case the Demote button will be unavailable.

Converting Sections

The Convert To feature allows you to change section types from one to another. Selecting Convert To will display a drop-down list of the allowed types available for the currently selected section.

Similar to demote, converting a section which includes sub-sections to another type can produce a situation where the sub-sections have no equivalent structure. In such cases, your content is preserved in the generic region type called Region. Any content contained in the section will be maintained if the target structure does not match the source structure. You can use Undo to reverse the process, if needed.

The system adheres to the following rules when converting sections:

• Preserve the existing hierarchy after the conversion.

• Only allow conversion to valid section types at the same level.

• Do not move content around.

• Do not allow conversion of single, required sections.

• Do not allow conversion of referenced sections.

If converting a section will violate one of these rules, the Convert To option will not appear on the context menu and the Convert To button will appear grayed out. The list of allowed types that the currently selected section can be converted to will be restricted to those types that will not violate any of these rules.

Given the following content model:

and the following hierarchy:

the rules prevent the following conversions:

• Conversion of Part 1 to a Chapter type as this would violate the second rule allowing conversion only between types at the same level.

• Conversion of Part 1 to an Appendix type as this would violate the third rule about moving content. If you want to convert Part 1 to the Appendix type, you would first need to move that section to the end of the series of parts, immediately preceding the existing Appendix section.

• Any conversion of Book as this would violate the fourth rule of not allowing conversions of single, required sections.

If you convert a section that has sub-sections, these sub-sections will also be converted, maintaining the hierarchy.

If you convert a section that contains sub-sections to a type that does not allow sub-sections, the content of these sub-sections become regions. These generic regions appear in the Para Styles drop-down menu with the new type Region.

In this example, Part 3, containing sub-sections Chapter 1 and Chapter 2, was converted to the Appendix type, which does not allow for subsections. You can use Undo to reverse the process, if needed.

You may not use Convert To on a referenced section type. That's because you first need to check out the referenced component, just like you do if you want to edit the text.

Entering text

Use the Editing pane to add content to the document.

As you type, the text, all formatting applied using the toolbar buttons as well as all inserted media appear immediately in the Editing pane. If the document contents span beyond the limits of the editing area, a standard scroll bar will appear.

The edited text looks as similar as possible to the results end users will see after the document gets published. When you format your text using the editor features, the formatting can be immediately seen in the Editing pane.

Track changes

This feature enables multiple people to collaborate on a document. Approved reviewers across the organization may directly provide comments, deletions, and insertions.

During the review process, each user's changes are visually tracked and may be accepted or rejected. While collaborating on a document, color helps associate comments and changes entered by different users. Each user's comments and insertions have a different color which appears as the background color in the Editing pane as well as in the Changes tab on the Right pane. The color palette is configurable.

To track changes in your document, click the Tracking toolbar button on the REVIEW tab. Use the Highlighting toolbar button on the REVIEW tab to enable or disable highlighting of tracked changes.

If you enable/disable highlighting and tracking in your document, the latest highlighting and tracking state will be saved along with the document.

You can see a list off all tracked changes in the CHANGES tab.

Document specific tracking state

Tracking and highlighting are enabled based on a document's last saved tracking state.

The value of the tracking state will be displayed when you check in a document:

States for tracking will be saved as one of the following values of the Tracking State attribute.

• Disabled

• Highlighting Only

• Tracking And Highlighting

• Tracking Only

Navigating in the document

Use the keyboard to easily navigate within the text.

Use Page Up and Page Down to scroll the Editing Pane one page up or down in the document, no matter how many sections are in the document. Use the Home and End keys to go to the beginning and end of a line, respectively, or combined with the Ctrl key - to the beginning and end of the document. Move inside the text using the Arrow keys.

Keyboard shortcuts for Quark Author Web Edition.

Undo and redo

Standard Undo and Redo features make text editing easier by allowing you to revert or apply edits as needed.

The Undo feature is a quick way to cancel the last change and restore the document to its previous state. To undo the last action use either the Undo toolbar button or the Ctrl+z shortcut on your keyboard.

The Redo feature lets you revert the last undo operation. This means that the document returns to the state it was in before you performed the undo. To redo the last action use either the Redo toolbar button or the Ctrl+y shortcut on your keyboard.

Quark Author Web Edition supports many undo and redo levels, allowing you to go backward or forward as needed.

Cut, copy, and paste

Among the most common editing operations are cutting, copying, and pasting text. Quark Author Web Edition supports these operations and also allows you to paste content formatted in other applications like Microsoft Word.

To copy a text fragment, select the text and then copy it using the Ctrl+c shortcut on your keyboard. The formatting of the original text will be preserved.

To paste a text fragment, start with cutting it or copying from another source. When the text is in the clipboard, paste it using the Ctrl+v shortcut on your keyboard.

Reference note content (footnotes/endnotes) and metadata content are included when copying from one document to another in the same browser.

The Platform Adapters for Microsoft Office allow you to copy Excel content and paste that into Quark Author Web Edition. To achieve this, copy the content from Excel and paste using Ctrl+Shift+c.

Find and replace

The Find and Replace features allow you to quickly search the text looking for specific words or phrases and replace them. This allows you to rapidly change multiple occurrences of a phrase in a document instead of manually finding and modifying each one.

The Find and Replace features are implemented using one dialog box with two tabs that let you switch between the Find and Replace features. Clicking on either the Find or Replace icon on the toolbar will bring up this dialog box.

The Find tab consists of a search field and a few options that let you refine the search:

• Match case - Check this option for a case-sensitive search.

• Match whole word - Check this option to limit the search operation to whole words.

• Match cyclic - Check this option to continue the search from the beginning after the editor reaches the end of the document. This option is checked by default.

The Replace tab includes the following extra fields:

• Replace with - Enter the word or phrase that will replace the search term in the document.

After you enter the search term as well as the replacement term and select the options, press the Replace button. If you want to replace all occurrences of the search term in the document, press the Replace All button.

The system notifies you of how many replacements were made:

XML preview

If at any time you would like to check the XML view of your document, use the XML toolbar button to view the document in XML format. A read-only view of the text will appear containing all the relevant XML tags and attributes:

Saving and closing documents

Use the Save Revision button located at the header to save a revision of the document. The document will remain open for further editing.

Use the Save and Close button located at the header to check in the document.

Use the Close button located at the header to close the document. A draft version of the document will be saved.

For both the Save Revision and the Save and Close options, the Check In dialog box displays:

1. Choose a target collection from the collection list.

2. Enter a file name for the document in the File Name field.

3. To specify whether the asset is saved with a major or minor version number, click Major Version (1.0) or Minor Version (0.1)

   Access to the Minor Version (0.1) option is controlled by privileges.

4. Choose a content type from the Content Type drop-down menu.

5. Choose a workflow from the Workflow drop-down menu.

6. To indicate the asset's current status, choose an option from the Status drop-down menu.

7. To send the asset to a particular user or group, choose an option from the Routed to drop-down menu.

   If your workflow relies on automatic status-based routing, the Routed to drop-down menu value might change automatically when you choose an option from the Status drop-down menu.

    

   If you do not choose any name from the Routed to drop-down menu when you check in an asset for the first time, the asset is routed to the active user.

8. Enter revision comments for the version of the asset you are checking in, in the Revision Comment field. The revision comment will be stored with the asset. The revision comment also displays when you view revisions of the asset.

9. Change values for any attribute existing on the server, which is valid for this document and shown in the Check In dialog.

10. Click Save.

Offline mode

Platform allows you to access and edit checked out documents while you are disconnected from the server. When you are working on a document and you are not connected to the server, the Disconnected status can be seen in the ribbon at the bottom of the Editing pane.

Quark Author Web Edition will detect if you have made any changes to the document and will automatically save the current content as a local draft.

Not all features will be available when working with a document in offline mode:

• If the document you are working on contains references to other documents that are not currently checked out, you will be able to view that content as read only, but you will not be able to edit the content.

• You can insert locally store content into your document, but that content will not be automatically checked into Platform.

When you are reconnected to the server, and check out a document that you were working on offline, the local draft will be opened and you will have the opportunity to save that version to the Platform server. The status bar shows a 'Syncing' message while the offline changes are being saved to the draft of the document. The message changes to 'Sync complete' when saving is complete.