Publishing from the Command Line

Publishing from the command line enables you to automatically publish one or more books in a batch or as part of a scripted or scheduled process. Author-it will even create the command line parameters for you - meaning you don't even need to look up the correct syntax.

Open the Publishing console and select the Profile and Books you wish to publish.
Select the Show Command Line button
-or-

Right-click and choose Show Command Line.
A window appears displaying the Command Line parameters based on your selections. You can copy and paste the parameters as required.

Syntax

Authorit5[.exe] libraryname [ /user /pwd ] [ /pub book|profile[;book|profile...] (/returncode)

The parts of the command line switch syntax are:

Argument	Description

Authorit5	The path to the Author-it 5 program.
libraryname	The type, name and path of your Author-it Library. Author-it will open this library when found. For example: `/jet"C:\Program Files\Author-it 5\Data\Libraries\Acme.adl"` -or- `/sql"Acme\|server1\|True"`
	If not using trusted connections, you also need to pass the SQL parameters: `/sql"Acme\|server1\|False\|login id\|password"`
user	User account to sign into the Author-it Library database.
pwd	Password used to sign into the Author-it Library database.
/pub	Tells Author-it to publish documentation in the specified library using the book and output list.
book	The ObjectID of the book you want to publish in the library.
profile	The ObjectID of the publishing profile you want to publish to.
/returncode	cause the publisher to return a "return code", as follows:
	0	if publishing was successful
	1	if an error or warning occurred during publishing (including the cancel button being selected)
	This allows automatic publishing to be used in a batch file and the success or failure can be used to branch in a batch file. For example: `PUBLISH.BAT` `@echo off` `echo Starting Publisher - Book 825 to Publishing Profile 1077` `"C:\Program Files\Author-it 5\Authorit5.exe" /jet"C:\Program Files\Author-it 5\Data\Libraries\Acme.adl" /pub"825\|1077;" /returncode` `If ERRORLEVEL 1 GOTO RET1` `echo Publishing has worked` `GOTO END` `:RET1` `echo Publishing has failed` `GOTO END`

Note: When used, these arguments must be in a command line to run the Author-it Publisher. The statement must all be on the same line.

Example:

An example of a valid command line that runs Author-it, loads a specific JET library, publishes a book with the object code of 825 using the publishing profile with the object code of 1077 may look like:

"C:\Program Files\Author-it 5\Authorit5.exe"/jet"C:\Program 
Files\Author-it 5\Data\Libraries\Acme.adl" /pub"825|1077"