PUB Command Line Converter | Aspose.PUB CLI Tools

Overview

Aspose.PUB Convert is a powerful command-line tool that lets you easily convert Microsoft Publisher files (PUB) into formats everyone can use. This is a game-changer for developers and designers who need to make sure their documents work on any device.

Key Features

• Supported Input Formats: PUB.
• Supported Output Formats: PDF, JPEG, PNG, BMP, TIFF, GIF, DOC, DOCX, XLS, XLSX, CSV, PPTX, XPS, EPUB, TEX, MHTML, HTML, SVG.
• Flexible Usage: Can be used both via simple command-line commands and programmatically in your C# code, compatible with .NET 6.0/7.0.

Benefits

Using the Aspose.PUB Convert tool provides several advantages:

• Efficiency: Quickly convert documents between multiple formats without the need for complex software.
• Automation: Integrate document conversion into your automated workflows and scripts.
• Flexibility: Handle various document formats to ensure compatibility with different systems and applications.

Licensing

While the Aspose.PUB Convert application itself is free to use, converting documents requires a valid Aspose.PUB license. You can purchase a license or use Aspose.PUB in trial mode for evaluation purposes.

How to install PUB Command-Line Converter?

The Aspose.PUB Convert tool can be installed either globally or locally, depending on your project’s needs. It is recommended to use the local installation for project-specific use to avoid version conflicts.

Global Installation

To install Aspose.PUB Convert globally on your machine, use the following command:

dotnet tool install --global Aspose.PUB.Convert

Specify the --version option if you need a specific version of the tool.

Local Installation

For local installation within a specific project, first, navigate to your project’s root directory. Then, execute the following commands:

1. Create a tool-manifest if not already present:

dotnet new tool-manifest

2. Install Aspose.PUB Convert locally:

dotnet tool install Aspose.PUB.Convert --local

Again, you can specify the --version option for a specific version.

Updating the PUB CLI Converter

To update the Aspose.PUB Convert tool to the latest version, use the dotnet tool update command with either --global or --local, matching your installation type.

Uninstalling the Publisher CLI Converter

If you need to uninstall the tool, use the dotnet tool uninstall command with either --global or --local, depending on how the tool was installed.

Usage

Command Line

Convert your documents using command-line arguments. Here are the available parameters:

• -i, --input [Required]: Path to the input PUB document.
  • Example: --input input.pub
• -o, --output [Required]: Path for the converted document.
  • Example: --output output.pdf
• -f, --format [Optional]: Output document format.
  • Supported formats: PDF, JPG, PNG, BMP, TIFF, GIF, DOC, DOCX, XLS, XLSX, CSV, PPTX, XPS, EPUB, TEX, MHTML, HTML, SVG.
  • Example: --format pdf
• -l, --license [Optional]: Path to the Aspose.PUB .NET license file.
  • Example: --license path_to_license.lic
• -v, --verbose [Optional]: Enable verbose output.
  • Example: --verbose

Example command-line usage:

Aspose.PUB.Convert --input input.pub --output output.pdf --format pdf

How to integrate CLI PUB Converter into C# Projects?

The Aspose.PUB Convert application can also be integrated directly into your .NET projects using the command line, enabling programmatic access to document conversion capabilities within your C# code.

Adding the Command Line Converter to Your Project:

To add the Aspose.PUB Convert tool to your Visual Studio project, navigate to your project’s root directory, and execute the following command:

dotnet Aspose.PUB.Convert add

This command adds the Aspose.PUB Convert functionality directly into your project, allowing you to use the library’s methods and properties through your code. This is particularly useful for developers looking to implement customized document conversion processes directly within their applications.

Use from Code

Here is an example of using the Aspose.PUB CLI tools programmatically in your C# code:

using Aspose.Pub.MicroApps.Convert;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // Initialize convert options
        var options = new ConvertOptions
        {
            // Required: Specify the input document path
            InputPath = "input.pub",
            
            // Required: Specify the output document path
            OutputPath = "output.pdf",
            
            // Optional: Specify the output format
            ToFormat = "pdf"
        };

        // Execute the conversion task
        await ConvertTasks.Create(options).Execute();
    }
}

For more information and usage examples, please visit the Aspose.PUB for .NET documentation.