Contributor Editor is where you manage your contribution assignments. If you activate the Edit Mode, it has a wide range of features for editing content and adding comments. If not activated, the Contributor Editor will only work as Review View, which means that you can only provide feedback comments.
-
Structure - Collapsible view of the structure of the document. For publications, this is similar to a table of contents.
-
Hierarchical structure (TOC) of the document. For publications, the "chapters" are numbered to make it easier for reviewers to communicate with contributors and authors about specific sections of the content.
-
Chapter numbering in the document. These correspond to the numbering in the structure.
-
Contributor Editor Toolbar - You display it by selecting any part of the text, see Edit Content in Edit View.
-
Content Editor - This is where you add and edit content.
-
Assignment button - Use it to end the contribution assignment by setting it to Done or Needs Work.
-
View selector - It shows which view you are looking at. If you have an appropriate license, you can use it to switch between the different views.
-
Settings - This is where you find the following functions: Compare versions, Create snapshot, Profile settings, Share document and Publish document. The publishing option is only available to Paligo authors. You can compare content to previous versions called "snapshots". To find out more, see Compare Contributions.
-
Comments sidebar - This is where you can see comments made by other users, make your own comments, and reply to other users. To find out more about using comments, see Add Comments in Edit View.
-
Variables - These are words or phrases that can change in different scenarios. You cannot edit these as a contributor, but you can use the profile settings dialog to apply their values.
-
Profile Settings - This is where you can select favorites, variables, profiling and options. If the content contains filters and / or variables, you should choose the profile set for the contribution. The person who sends you the contribution assignment should tell you which set you should use and you can select it from the Favorites tab.
Note
If you have a Paligo author license, there are some extra options available to you. Position the cursor over the content of a topic and the Edit View shows a hover menu, with these options:
-
Switch to main Editor
-
Share Document see Share Content (without assignments)
-
Minimize Sidepanels closes comments sidebar and TOC.
You can also toggle the main Paligo editor's Content Manager, by selecting the arrow icon at the top, next to the Dashboard option in the menu.
The Contributor Editor Toolbar is not as advanced as the one in the full Paligo Editor, but has the necessary options for adding structure (such as sections, lists and tables), inline styling and adding images and videos.
-
Show or hide comments
-
Dictionary and spellchecker settings. The spellchecker is activated when highlighted in blue.
-
Skip between the suggestions.
-
Save changes manually or use the autosave feature.
-
Full screen
-
Exit and check in the topic.
If an assignment includes several topics, you have to close the edited topic to be able to edit another. Remember to save the changes first.
-
Add a title or Bridgehead
-
Add inline styling
-
Add media URL
-
Insert Variable
-
Insert Math Expression
Note
To display the Assignments Panel, select Dashboard in the top menu.
Paligo uses structured content, which is a standardized approach to writing, where the content consists of "blocks" of information. These blocks are organized into consistent structures and can be reused in many different outputs (PDF, HTML, HTML5, mobile devices). This makes the content more versatile as it is easier to move, reuse, update and convert into different formats - all important factors when creating documentation.
As a contributor, you will be asked to contribute to one or more topics. Each topic consists of content blocks, like About Elements. When you add content in Contributor Editor, the correct block element is automatically added, ready for you to add the text. For example, if you add a note, the editor automatically adds a note
element and a para
element inside it. The para element is for the text of the note.
In the image below, we have a section that represents the entire Topic (1). Inside the section, there is a Title (2), a Paragraph (3), an Image (4) and an Admonition (5).
Each of these are separate blocks of information. As the blocks are separate and organized into a hierarchy, you cannot select multiple paragraphs all at once, like you could in a word processor or blog post editor. You have to select each block separately. If you select a block, you can see its structure and location in the topic (section) in the element structure panel at the top.
Tip
To find out about available features, see Edit View Features.
To ensure consistency in the structure, there are rules for the positioning of content. These rules are applied automatically by the Contributor Editor so that whenever you add or change content, the structure remains valid.
If you want to add an element in a position, but the editor places it elsewhere, it is because the element is not allowed at the position you selected. The editor will add the content in a valid position instead and may adjust some of the nearby structure in the process.
For example, you cannot insert a table inside a paragraph. If you try to do that, the editor will place the table before or after the paragraph, in a valid position.
With structured content, styling and content are separate. The idea is that content is created as text and images and the styling is applied during publishing, not editing. This means that the same content can be reused in different outputs (PDF, HTML, HTML5, mobile devices) and if needed, have different styling in each one.
But the Contributor Editor does have some styling features for inline content, such as bold, italic and underline. These are available from the toolbar and Paligo recommends that you discuss which ones to use with your Paligo authors.
Comments
0 comments
Article is closed for comments.