login | sign up

Your session has timed out due to inactivity.

You can go back to the overview without login or use the login form to login again before redirect

Knowledge Base / Administrators – Essential Workshops / Setting up an Editing Project

Workshop 1: How to create an Edit Project - Detailed Steps

Created on 06th October 2017 at 11:56 by Jamie O'Connell



Welcome to your one2edit 'How to' Guide!

In this lesson, we will use our example company, 1io Recipe Inc., to begin our first content editing project. 
We will use the 'Master Document Editor' to create content groups and assign content rules, thus preparing our documents for the later lessons on workflows.

NOTE:
A detailed description of any window used here can be found in the 'User Interface Description' section.

NOTE:
We will be creating a one2edit™ project. A project in one2edit will contain one master (parent) document and may contain one or more version (child) documents.

Let's get started!

Step 1: Open the 'Asset Browser'

To create a new project, open the 'Asset Browser' window by clicking 'File > Browse Asset Spaces'.

  1. 'Asset Browser' window: Your asset project is where you store your uploaded data. It is comparable to the hard drive on your computer, where you can create a folder structure and manage your data. The 'Asset Browser' gives you access to this asset project via a web browser.
  2. 'Projects' tab: The one2edit™ 'Projects' tab is where you can organize your project folder structure as well as the projects themselves. It remains active while the 'Asset Browser' window is open, allowing you to easily switch back and forth, if required. This also allows you to choose the target project folder for your new project.

NOTE:
To summarise, we handle data within the 'Asset Browser', and
one2edit projects within the 'Projects' tab.

Step 2: Create a new project

We will now create our new one2edit™ project.

  1. 'Asset Project Folder' structure: In the 'Asset Browser', you can see your company's asset project. This asset project should contain all project-related data within subfolders. If not, you can upload data using the 'Asset Browser' controls.
  2. Choose or create a target project folder: You need to choose a target folder in which to create your project. Don't worry if you have forgotten to create a suitable folder beforehand. As mentioned above, you can still create project folders or edit them while the 'Asset Browser' is open. Just click on the 'Projects' tab, edit your folder structure, and then click back into the 'Asset Browser'.
  3. Choose the InDesign® document that you will use for your project: Select your Adobe® InDesign® document in the 'Asset Browser'. Click 'Create Project'. The 'Asset Browser' will automatically close when the project has been successfully created.
  4. The project's new home: The newly created project will now be listed in the 'Project Name' column within the 'Projects' tab.

NOTE:
The 'Create Project' button will only be available if you have selected a target folder (2) in the one2edit 'Projects' tab.

Example for 1io Recipe Inc.:
(1)
The asset project is named after our company, 1io Recipe Inc. This contains two subfolders with all of the relevant data for our project (i.e. the InDesign® package contents). (2) Because our project will be about recipes, we created a folder with that name in our one2edit™ 'Projects' tab and selected it. (3) We then selected the correct InDesign document in a subfolder. (4) The 'Create Project' button is now active, so we click on it. Our new one2edit™ project, named 'kuhnert-rezepte-demo_cs5-5.indd', will then be listed in the 'Project Name' column.

Step 3: Open 'Project Details' window

Open the 'Project Details' window by either clicking 'Edit > Properties' (after selecting the Master Document) or clicking the thumbnail next to the document.

Step 4: Adapt Project Details

Step 4: Adapt Project Details

When the 'Project Details' window opens, the 'Properties' tab is shown. Within this tab the following fields can be adapted:

  1. You can update the 'Name' of the master document (i.e. the name of the project).
  2. You can add 'Version' text that will appear in the 'Version' column.
  3. It is also possible to add 'Tags' to this project. These are search tags, and can be searched for via the 'Search' field at the top of the screen.
  4. The 'Description' is a free-text field that can be seen in the 'Project Details' window or when viewing the document info via the API.

NOTE:
Text entered into the 'Version' field (2) will be used as the default version text for any version documents created using the 'Project > Create Version' menu command. If no text is entered, the version document text will be 'Version of <master document name>'.

Step 6: Open your project

Double-click on your master document to open the 'Master Document Editor' (MDE).

Step 7: 'Master Document Editor'

When the 'Master Document Editor' (MDE) opens, it will display a preview of the first page of your document. For a detailed description of the toolbars and icons, please refer to the 'Master Document Editor' section of the 'one2edit™ User Interface Description'.

Step 8: Create new content groups

Step 8: Create new content groups

A 'Content Group' in one2edit can be thought of as a container that you can fill up with all the content (i.e. text segments, images) that will be relevant for your editing process and workflow. There are two content groups available by default, displayed at the top of the screen:

  1. 'All Items': All of the document's content can always be found in this group. Even if you assign content to another content group, you will still be able to find it all here as well.
  2. 'Unassigned Items': In contrast to the 'All Items' group, this group only contains the content that has not been assigned to any other content group.
  3. 'New Group': The 'New Group' button, located to the left of the 'All Items' group tab, is used to create new content groups within this master document. Click this 'New Group' button now to create a new content group (via the 'New Content Group' window).

Step 9: Choose 'Name', 'Color' and 'Type' for new 'Content Group'

Step 9: Choose 'Name', 'Color' and 'Type' for new 'Content Group'

You can create and personalize your new content group using the 'New Content Group' window.

  1. 'Name':: Give your new content group a name! The name of your content group should allow you to identify the kind of work to be done with the content of this group (e.g. edit text, localize images, translate text, etc.). Content group names are needed during the workflow process when identifying which workflow track is assigned to which content. This is another reason to keep the name relevant.
  2. 'Color':: Give your new content group a color! Any content that you place into this content group will be highlighted using this chosen color, so it is mostly about personal preference. However, it makes sense to choose colors that are not used in your actual master document. This will mean that any highlighted content will be contrasted against the rest of your document.
  3. 'Type':: This menu allows you to choose if your new group will be an 'Edit' or 'Translation Content Group'. In this lesson, you should choose 'Edit Group'.

NOTE:
Always name your content groups according to what you will be doing with the group's content, NOT according to the desired outcome for the content.

Famous mistake:
When creating content groups you have to keep in mind that each and every one of them belongs to the master document. This is where the so-called 'original' or 'source' content is located. Based on this 'original content' we can create various final versions (in the form of version documents). This means that the content of one content group can lead to a variety of final version documents. Giving a content group any result-related name would, therefore, be misleading.

Example for 1io Recipe Inc.:
We decided to name our first content group 'edit_text'  since we already know we will need two separate groups: one for editing our text segments and another for editing our images. For the content group's color, we chose bright pink
(2), which will stand out clearly from the light green color that is a default in our workspace. As the name of the content group makes obvious, this group will contain text segments for editing (not translation). Therefore, we choose 'Edit Group' (3) from the menu.

Step 10: Add 'Content Rules' to your new 'Content Group'

To assign content rules to your new content group, click 'Settings > Content Rules (Policies)'. This opens the 'Content Rules (Policies)' window. You need to keep the 'New Content Group' window open when assigning content rules to your newly created content group.

  1. Use pre-created rules: You can now choose from any rule sets that you have previously defined*. Drag and drop the rules you need into the 'Edit Content Rules' area and/or the 'Review Content Rules' area.
  2. 'Edit Content Rules': Rules that are put into the 'Edit Content Rules' area apply to the very first workflow step (the 'Edit' step).
  3. 'Review Content Rules': Rules that are put into the 'Review Content Rules' area apply to ANY AND ALL of the following workflow steps (the 'Review' steps).
  4. Click 'Save': After assigning the appropriate rules to their areas, click 'Save'. Your 'New Content Group' tab will now appear to the right of the 'Unassigned Items' tab. It will be marked, in the corner, with your chosen content group color.

NOTE:
The huge advantage of applying content rules to a content group is that you do not need to apply these rules to each image or text segment separately. Rules that have been defined for a content group are applied to all of the content within that group.

Example for 1io Recipe Inc.:
We have already defined rule sets for our 1io Recipe Inc. company*. We now want to assign rules to our newly created
edit_text content group. (1) In our case, we have defined rules for text editing and will, therefore, apply these to our edit_text content group. We drag them into both the 'Edit Content Rules' area (2) and the 'Review Content Rules' area (3).

* For details about content rules, please refer to the content rules lessons within the 'Further Tutorials for one2edit™ Administrators' section.

Step 11: Create as many groups as you need

You can create as many groups as you like by using the 'New Group' button in the upper left corner. In order to simplify your workflow process, it is advisable to create a separate group for each kind of editing process, especially if there are different users working on different types of content. For example, the users assigned to edit text contained in the text-editing content group will not have access to the images contained within the image-editing content group (and vice-versa).

Example for 1io Recipe Inc.:
We decided we needed multiple content groups to coordinate our workflow process. Therefore, we decided to create one group for editing text and another for editing images.

NOTE: Structure - Document Connection

  1. 'Structure' panel: The 'Structure' panel shows you the content items in the document and their exact level within the document structure. In this case, the 'All Items' tab is chosen, meaning that every content item in the document is present in the structure view. The 'Structure' panel will only contain the content of the selected content group/tab.
  2. Connection between the 'Structure' panel and the 'Document Preview': When you select a piece of content (e.g. the text segment: "It's time for an orange fizz"), the content will be highlighted and there will be a shadow path connecting the content in the structure window to the same piece of content in the document preview.

NOTE:
If you double-click on an item in the 'Structure' panel, the document preview will jump to the correct spread and then highlight that piece of content.

Step 12: Assigning content to a content group

Now you need to put content into your content group. There are two ways of doing this:

1. From the 'Document Preview'

  • Selection tool: First, ensure that the 'Select' tool is chosen.
  • 'Drag & Drop' from 'Document Preview': You can now drag and drop elements directly from the document preview to a content group.

2. From the 'Document Structure'

  • Open 'Structure' panel: Click on the 'Structure' icon in the left-hand toolbar to open the 'Structure' window.
  • 'Drag & Drop' from 'Document Structure': You can now drag and drop the required segments directly from the document structure to a content group.

NOTE:
You can select multiple items in either the document preview or the document structure. You can then drag multiple items into a content group in one go.

NOTE:
To remove items from a content group, simply drag the content into the 'Unassigned Items' group/tab.

Step 13: Move Content Warning

Step 13: Move Content Warning

This warning will appear if you drag a frame, table, spread, etc. into a content group, along with some explicitly selected content (i.e. an ambiguous selection). Choose the desired answer and click 'OK'.

Check the box if you do not wish for this warning message to re-appear for this session.

NOTE:
The ambiguity is around whether you want the all of the frame's content (or the spread's content, or the table's content, etc.) to be moved, or just that portion of content which has been selected.

Step 14: Dragging greater amounts of content

Dragging and dropping content items one by one (or even spread by spread) into content groups can be a time-consuming process. For this reason, there are ways to simplify/speed up the process:

  1. Drag to select desired segments: You can mark multiple text segments and/or images in the document preview by using the 'Select Tool' to drag a box around the items you want. Then you can drag and drop the whole selection into your content group.
  2. Use a 'Filter'*: You can filter the content of the document structure panel to more easily find your required content. In our example here, we are filtering out everything except text segment content. You can also drag and drop entire spreads into a content group directly from the 'Structure' panel.
  3. Check content distribution: Finally you can check whether or not the right content has been assigned to the correct content group by selecting the content group tab and opening the 'Structure' panel. As mentioned previously, only that content which is in the selected content group is shown in the 'Structure' panel.

NOTE:
If you want the majority of content items on a page/spread to be in a specific content group, simply drag the content from the entire page/spread into the content group tab. Then, for the few segments which don't belong in that group, simply drag these to the 'Unassigned Items' tab.

*For a detailed description of the available filter options please refer to the respective lessons in the 'User Interface Description' section.

Step 15: Warning message

Step 15: Warning message

This warning will appear if you drag a frame, table, spread, etc. into a content group with no content explicitly selected. Check the box if you do not wish for this warning message to re-appear for this session.

Click 'OK' and continue working.

NOTE:
one2edit™ uses this warning to remind you that you are moving content from that frame into the content group, and not the frames themselves (because frames are not content).

Step 16: Checking the content groups

To get a quick overview of which content items are in which content group:

  1. Display All Items: Select the 'All Items' tab. This tab displays all of the content items from the document, even if they belong to different content groups.
  2. 'Show Images', 'Show Segments': Click the 'Show Segments' button and the 'Show Images' button. These buttons are located on the toolbar at the top of the spread.
  3. Content is Highlighted: These buttons will highlight the document content in the colors of their respective content groups.
  4. Marked within 'Structure' window: In the 'Structure' panel, any piece of content that belongs to a content group will be marked according to the color of its respective group.
  5. Unassigned Content: Any content items that have not been assigned to a content group will be highlighted in the default color for the workspace. These pieces of content can also be found under the 'Unassigned Items' tab.

Example for 1io Recipe Inc.:
So far, we have created two content groups and assigned bright colors (pink and light blue) to each of them. After switching on 'Show Segments' and 'Show Images'
(2), those colors become visible (3)(4). Every item that was assigned to the edit_text group is now highlighted in pink within the document preview (3), and marked with a pink corner within the 'Structure' panel (4). Every item that was assigned to the edit_image content group is now highlighted in light blue within the document preview (3), and marked with a light blue corner within the 'Structure' panel (4). A small part in this spread is highlighted in the default 'green' color (5), which means it has not been assigned to any content group. In our case, we will take this content and assign it to the edit_text group.

Step 17: Special Rules for selected items

Step 17: Special Rules for selected items

Sometimes, it might be useful to assign further rules to specific content items in a document, in order to improve the subsequent workflow efficiency.

  1. Select Item: Select the content item to which you want to assign further rules. After selecting it, the panels on the right hand side will become available (3).
  2. Click 'Settings > Content Rules (Policies)': Open the 'Content Rules' window (where you can access your rule sets) by clicking on 'Settings > Content Rules (Policies)'.
  3. Open 'Content Rules (Policies)' Panel: Click the 'Content Rules (Policies)' panel icon to open it.
  4. Drag and Drop Rule Sets: Drag and drop any rules you want to apply to that specific content item into the 'Edit Content Rules' and/or the 'Review Content Rules' areas.

NOTE:
Assigning further rules means that these rules will be added to any existing rules for the content group. These rules do not override those of the content group. Therefore, it is not possible to remove rules from a single item if those rules have already been assigned to the content group containing that item. For this reason, it is advisable to assign basic/general rules to the content group, while managing more specific permissions on selected items.

Example for 1io Recipe Inc.:
We have applied the 'allow all_Text' rule set to our edit_text content group (see previous steps). We had defined this set of rules so that the right to change the size of text or the typeface were not allowed. However, for some segments it would be useful to be able to change the size and typeface. Therefore, we need to choose the relevant segment(s)
(1) and open 'Settings > Content Rules' (2). We can then open the 'Content Rules (Policies)' panel (3) for this text segment and drop in these more permissive rules (4).

Step 18: 'Save & Close'

When you have finished setting up your content groups and assigning your content rules, click 'File > Save & Close'.

If you just click 'File > Close', one2edit will prompt you to save your changes.

WHAT IF, you accidentally left one2edit™?

WHAT IF, you accidentally left one2editâ„¢?

If you leave one2edit accidentally without saving your work (e.g. a browser crash, an internet interruption, etc.), your latest changes will be saved by default. At your next login, you will be prompted to recover your changes.

Congratulations!

You have now prepared your master document, created content groups, assigned content to those groups, and applied content rules to the content within those groups.
In our next workshop we will learn how to create workflows for our project.




© 2009-2024 1io BRANDGUARDIAN GmbH · All rights Reserved · Legal / Privacy Policy


top