Pipeline 2—Command Line Tool User Guide

Pipeline 2—Command Line Tool User Guide

The command line version of  Pipeline 2 is not a standalone tool. It only works in combination with a running Pipeline server either on the same computer or a different one. See Configuration on how to specify the address of the server.

Menu

Installation

Choose a package from the downloads and installation page that includes the command line tool, then follow the installation instructions for that package.

Usage

The executable is called dp2, or dp2.exe on Windows. The location of this file depends on the installation.

In order to get an overview of the commands, run dp2 help

Script Commands

daisy202-to-epub3—Transforms a DAISY 2.02 publication into an EPUB 3 publication.

daisy202-validator—Validates a DAISY 2.02 fileset.

daisy3-to-daisy202— Transforms an audio-only DAISY 3 DTB into an audio-only DAISY 2.02 DTB.

daisy3-to-epub3—Transforms a DAISY 3 publication into an EPUB 3 publication.

dtbook-to-daisy3—Converts multiple DTBooks to DAISY 3 format

dtbook-to-epub3—Converts multiple dtbooks to EPUB 3 format

dtbook-to-html—Transforms DTBook XML into HTML.

dtbook-to-odt—Transforms a DTBook (DAISY 3 XML) document into an ODT (Open Document Text).

dtbook-to-pef—Transforms a DTBook (DAISY 3 XML) document into a PEF.

dtbook-to-rtf —Transforms a DTBook (DAISY 3 XML) document into an RTF (Rich Text Format).

dtbook-to-zedai—Transforms DTBook XML into ZedAI XML.

dtbook-validator—Validates DTBook documents. Supports inclusion of MathML.

epub3-to-daisy202—Transforms an EPUB 3 publication into DAISY 2.02.

epub3-to-epub3—Transforms an EPUB 3 publication into an EPUB 3 publication with a braille rendition.

epub3-to-pef—Transforms a EPUB 3 publication into a PEF.

epub3-validator—Validates a EPUB.

html-to-epub3—Transforms (X)HTML documents into an EPUB 3 publication.

html-to-pef—Transforms a HTML document into a PEF.

nimas-fileset-validator— Validate a NIMAS Fileset. Supports inclusion of MathML.

zedai-to-epub3— Transforms a ZedAI (DAISY 4 XML) document into an EPUB 3 publication.

zedai-to-html—Transforms ZedAI XML (ANSI/NISO Z39.98-2012 Authoring and Interchange) into HTML.

zedai-to-pef—Transforms a ZedAI (DAISY 4 XML) document into a PEF.

General Commands

status—Returns the status of the job with id JOB_ID

delete—Removes a job from the pipeline

results—Stores the results from a job

jobs—Returns the list of jobs present in the server

log—Stores the results from a job

queue—Shows the execution queue and the job’s priorities.

moveup—Moves the job up the execution queue

movedown—Moves the job down the execution queue

clean—Removes the jobs with an ERROR status

halt—Stops the webservice

version—Prints the version and authentication information

List of global options: dp2 help -g

List of admin commands: dp2 help -a

Detailed help for a single command: dp2 help COMMAND

Admin Commands

list—Returns the list of the available clients

create—Creates a new client

remove—Removes a client

modify—Modifies a client

client—Prints the detailed client inforamtion

properties—List the pipeline ws runtime properties

sizes—Prints the total size or a detailed list of job data stored in the server

For detailed help on a specific script or other command, run dp2 help COMMAND. For example: Usage: dp2 [GLOBAL_OPTIONS] dtbook-to-epub3 [OPTIONS]

Options

–source SOURCE—One or more DTBook files to be transformed. In the case of multiple files, a merge will be performed.

–language [LANGUAGE]—Language code of the input document.

–assert-valid [ASSERT-VALID]—Whether to stop processing and raise an error on validation issues.

–tts-config [TTS-CONFIG]—Configuration file for the Text-To-Speech.

–audio [AUDIO]—Whether to use a speech synthesizer to produce audio files.

-o,–output [OUTPUT]—Path where to store the results. This option is mandatory when the job is not executed in the background

-z,—zip—Write the output to a zip file rather than to a folder

-n,–nicename [NICENAME]—Set job’s nice name

-r,–priority [PRIORITY]—Set job’s priority (high|medium|low)

-q,—quiet—Do not print the job’s messages

-p,—persistent—Delete the job after it is executed

-b,—background

Configuration

Configuration settings can be passed as options. In order to get the full list of available options, run dp2 help -g. The default settings may be altered in a file called config.yml. This file is located in the same directory as the dp2 executable. To change the location, use the –file option.

Global Options

–host [HOST]—Pipeline’s webservice host (default http://localhost)

–port [PORT]—Pipeline’s webserivce port (default 8181)

–ws_path [WS_PATH]—Pipeline’s webservice path, as in https://daisy.org:8181/path (default ws)

–timeout [TIMEOUT]—Http connection timeout in seconds (default 60)

–client_key [CLIENT_KEY]—Client key for authenticated requests (default clientid)

–client_secret [CLIENT_SECRET]—Client secrect for authenticated requests (default supersecret) true or false (default true)

–starting [STARTING]—Start the webservice in the local computer if it is not running.

–exec_line [EXEC_LINE]—Pipeline webserivice executable path (default ../bin/pipeline2)

–ws_timeup [WS_TIMEUP]—Time to wait until the webservice starts in seconds (default 25)

–debug [DEBUG]—Print debug messages. true or false (default false)

-f,–file [FILE]—Alternative configuration file

Tags: Pipeline 2