Sigtuna DAR 3 - New Project (Synchronized Book)

Original Author(s): Miki Azuma

To create a new project, click FILE menu > NEW or click the "New project" button in the toolbar. When the 'Create new project' dialog is displayed, please select the "Synchronized book" icon and click the "OK".

Select 'Synchronized book'
Select 'Synchronized book'

The "Select project destination" dialog is displayed. Key in the title of the book, then select the "Select path" button.

Key in the title of the book
Key in the title of the book

When you open the "Select or create new folder" dialog, the default destination may be the Sigtuna DAR 3 folder in the Program Files folder or the folder you selected before. Ensure that you select the correct project destination on the hard drive.

Select the destination path on the hard drive
Select the destination path on the hard drive

When you have selected the hard drive where the project will be stored, select the "New Folder" button that is at the lower left corner of the dialog box and place the project folder directly on the drive. The "New Folder" that has just been created will now be highlighted and you can key in the title of the book. After clicking "OK", return to the "Select project destination" dialog. Select "OK" again.

Attention!! When you create a new folder, do not leave spaces between the words in the folder name. You can use underscore or "CamelCase", for example, "We_Believe_in_DAISY" or "WeBelieveInDaisy"

Enter the Folder Name
Enter the Folder Name

In order to organize and manage your projects more easily, you can create a folder on the hard drive to hold all of your DAISY project folders. It can simply be called DAISY_Projects.
Managing your projects will be much easier if you always use the book name as the folder name. If two books have the same title, you can include the edition number or author at the end of the title so that they are not the same (each folder must have a unique name).

After you click the "OK" button, the "Create a new Daisy 2.02 Project" dialog is displayed. There are two main areas in this dialog box: "Documents added" on the left, and "Current MDF file" on the right side of the dialog. Select the "Add" button that is in the lower left.

'Create a new Daisy project' dialog
'Create a new Daisy project' dialog

The "Add a document to the list" dialog will display. In the "Browser Display" go to the drive where the source file for your project is stored. When you have located and double clicked the drive, locate the folder for the source file for this project. Double click that folder. Inside the source folder for this project you will find the XHTML file to create the DAISY project.

Select the drive
Select the drive

Double click the XHTML source file to add it to the list.

Add We_Believe_in_DAISY.html
Add We_Believe_in_DAISY.html

The source file has now been added to the "Documents Added" list.

The XHTML source file is added to the 'Documents added' list
The XHTML source file is added to the 'Documents added' list

Note that it is possible to add more than one XHTML source file to your project. If another file is to be added, it is done in exactly the same way. If more than one XHTML file is added you need to ensure that the files are in the correct order. If files have been added in the wrong order, you can move them into the correct order by using the "Move up" and "Move down" buttons.

In this section, you will learn about the MDF (Makeup Definition File). The Markup Definition File contains a listing of all of the elements and attributes, with their associated values, that are to be used as synchronization points within the XHTML source in a project. This list of elements is used to identify and select portions of the source files for the generation of the NCC file and SMIL files for a project. Also stored in this file is information about the hierarchy associated with each type of element. It is the synchronization points and hierarchy that provide navigation within the project during production and in the completed book when it is read.

There are "h" elements (heading elements) and a "span" element in this source file. The only classes defined are "Title" and "page-normal". Sigtuna DAR 3 contains four MDF files from which you can choose. The MDF file called "daisy_FullText.mdf" contains all the possible elements and attributes in xhtml file for the DAISY production, so it is possible just to use this file to create most of the production. It is also possible to edit these MDF files and create completely new MDF files. Click the "daisy_default.mdf" and then click the "Select MDF" button. When the "daisy_default.mdf" is displayed in the upper right column, select the "Modify" button.

Modify MDF file dialog
Modify MDF file dialog

The message, "Please note that this MDF is read-only, but you may modify it and save it with another name!" is shown. Select "OK".

When the "Modify MDF file" dialog is displayed, highlight each element in the left column and review the details presented on the right. On the right side, there are fields for "Name", "Class", "Desc" (Description) and "Level", and check boxes for "Include in NCC", "Link back" and "Nested item". Please refer to "Help" if you require the further information about the MDF function.

In this XHTML source file there is a span element which is used as a breakpoint. Select the "Create tag" button at the lower left of the dialog. Type "span" in the "Name" column, leave the "Class" blank, add "span ID" for the "Desc", and "nothing" for the "Level", then uncheck the three boxes. When you make sure that you have completed these steps correctly, select the "Save tag" button.

Create a new tag
Create a new tag

"span ID" is now added to the column on the left. Select "OK". When the confirmation message is shown, click "Yes". The "Change file name" dialog will open. Key in the name for this new MDF file created for this project and select "OK".

It is helpful to use the book name as the name of the MDF file. If the book titles is "We Believe in DAISY", then the MDF file should be named "We_Believe_in_DAISY.mdf" (each mdf should have a unique name).

Type the MDF file name
Type the MDF file name

The new MDF that you have saved is in the Current MDF file list on the left. This is the MDF that you will use with this project.

.

We_Believe_in_DAISY.mdf is listed
We_Believe_in_DAISY.mdf is listed

Read more about MDF in the MDF Overview.

When the project is open, click the "+" mark in the tree view control on the left side of the main screen, to ensure that all of the headings that are in the table of contents are present in the NCC.

All headings that are in the original source and that are properly marked up will be present in the NCC. If a heading is missing or incorrect, it will be necessary to modify the original XHTML file. If this occurs close Sigtuna DAR 3 and delete the project folder which you had created for this project. After the heading that was missing has been added or the incorrect heading has been changed in the original XHTML file, repeat the steps to create another project. Note that as you have already made the MDF file for this project, it will display in the list of current MDF files on the right when you get to the "Create a new Daisy 2.0 Project" dialog box. Add the corrected XHTML source file and select the MDF that you created and "Finish" project generation.

You may find it difficult to master this part of DAISY book production with Sigtuna DAR 3, in part because it is done only once for each project that is to be produced. In order to become comfortable with the process you can use the same source to create a project many, many times, and continue to practice until you have a thorough understanding of the steps. You will need delete the project folder for each new project you create or create a new folder with a different name for each.

When an error message is shown while generating a project, it means that there is something wrong in the source documents. If this happens, please check the XHTML file or NCC.html file in the project directory in Windows Explorer. Locate the position where the project generation process stops. When you find the same place in the source document, you should be able to find errors. When the error has been corrected, try creating the project again. An error message will also be shown when the XHTML file is linked to a CSS or to images that are in a different folder other than the source folder and Sigtuna DAR 3 is not able to copy those files to the project directory. If this is the case, just simply copy those necessary files to the project directory.
Before recording, it is a good idea to go through all of the text events. Even if there is no error message shown, there could be something wrong in the source documents and all the events may not be synchronization points. When you look at the source document, you should be able to find errors such as missing or incomplete elements (for example a element that is not properly closed - "\" is missing, or a missing angle bracket at the beginning or end of a element. When the error has been corrected, try creating the project again.

See also

DAISYpedia Categories: 


This page was last edited by PVerma on Monday, February 18, 2013 23:18
Text is available under the terms of the DAISY Consortium Intellectual Property Policy, Licensing, and Working Group Process.