Creating a publication

Background

Starting point

The procedure in this topic assumes Skribenta is installed and configured for normal operation, and:

You have logged into Skribenta.
You are assigned to one of the following user roles: content provider, technical writer or administrator.
You have selected the workspace you want to work in.

Your need

You want to create a publication so you can publish content together with a configuration file.

The possibility

It is possible to create a publication:

based on an existing content file and configuration file.
based on an existing content file or configuration file.
and the corresponding content and configuration file at the same time.
based on an existing publication,

About this task

What you will learn

This instruction tells you how to create a publication.

The result

This is the Publications view before creating a publication:

This is the Publications view after creating a publication:

Overall steps

Browse to a location the Publications view, then create the publication.

Time

1 minute

Procedure

Creating a publication based on an existing content file and configuration file

1. Make sure that the step(s) in section "Starting point" (see section "Background" above) are performed.

2. Create a content file and a configuration file in the workspace.

3. On the Aspect toolbar, click Publications.

The Publications view opens.

4. In the Publications view, browse to the publication group where you want to create a publication.

It is also possible to create a publication directly in the Publications top folder.

5. Right-click the publication group.

A pop-up list opens.

6. In the pop-up list, select the publication group icon.

The Publication group toolbar opens.

7. On the Publication group toolbar, click New > Publication.

The Publication tab opens.

8. On the Publication configuration tab:

Type a publication name in the Name box.
Click the Browse button to the right of the Master box to browse for a content file.
- Click the option button to select the content file.
Click the Browse button to the right of the Recipe box to browse for a configuration file.
- Click the option button to select the configuration file.

9. Click Create.

The publication is created.

Alternative procedure: Creating a publication based on an existing content file or configuration file

1. Make sure that the step(s) in section "Starting point" (see section "Background" above) are performed.

2. Create a content file or a configuration file in the workspace.

3. On the Aspect toolbar, click Publications.

The Publications view opens.

4. In the Publications view, browse to the publication group where you want to create a publication.

It is also possible to create a publication directly in the Publications top folder.

5. Right-click the publication group.

A pop-up list opens.

6. In the pop-up list, select the publication group icon.

The Publication group toolbar opens.

7. On the Publication group toolbar, click New > Publication.

The Publication tab opens.

8. On the Publication configuration tab:

Type a publication name in the Name box.
Click the Browse button to the right of the Master box or Recipe box to browse for a content file or a configuration file, respectively.
- Click the option button to select the content or configuration file.
  
  In this example, a content file is selected.

9. Click Create.

The publication is created.

A configuration file, which was not specified in the previous steps, is created in the same folder as the existing content file. The configuration file name is the same as the publication name.

Alternative procedure: Creating a publication and the corresponding content and configuration file at the same time

1. Make sure that the step(s) in section "Starting point" (see section "Background" above) are performed.

2. On the Aspect toolbar, click Publications.

The Publications view opens.

3. In the Publications view, browse to the publication group where you want to create a publication.

It is also possible to create a publication directly in the Publications top folder.

4. Right-click the publication group.

A pop-up list opens.

5. In the pop-up list, select the publication group icon.

The Publication group toolbar opens.

6. On the Publication group toolbar, click New > Publication.

The Publication tab opens.

7. On the Publication configuration tab, type a publication name in the Name box.

8. Click Create.

The publication is created.

The parameter Skribenta.Publication.FileFolder must be set to define a reference folder available in the workspace.

A content file and a configuration file are created in a subfolder structure, following the publication group structure, in the reference folder defined by the parameter Skribenta.Publication.FileFolder. The content and configuration file names are the same as the publication name. An empty Images folder and Modules folder are also created.

Alternative procedure: Creating a publication based on an existing publication

1. Make sure that the step(s) in section "Starting point" (see section "Background" above) are performed.

2. On the Aspect toolbar, click Publications.

The Publications view opens.

3. In the Publications view, browse to the publication that you want to base your new publication on.

4. Right-click the publication.

A pop-up list opens.

5. In the pop-up list, select the publication icon.

The Publication toolbar opens.

6. On the Publication toolbar, click Based on this.

The Based on this tab opens.

7. Type a publication name in the Name box.

8. Click Create.

The publication is created.

The new publication (Publication C) uses the same content file as Publication B, but a new configuration file. The configuration file name is the same as the publication name. The new configuration file is created in the same folder as the configuration file for Publication B.