OfficeToPDF
Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
parent directory.. | ||||
Office To PDF ============= This is the Cognidox Ltd Office To PDF tool. It can be used to convert Microsoft Office 2003, 2007, 2010, 2013, 2016 or 2019 documents to PDF from the command line. In order to run the tool, .net 4 and one of MS Office 2007, 2010, 2013, 2016 and 2019 must be installed and at least one printer device configured. It is distributed under the Apache License v2.0: http://opensource.org/licenses/apache2.0 More information about installation and usage can be found on the Cognidox project page: https://www.cognidox.com/officetopdf-converter/ Supported file types: --------------------- The following file types can be converted: * Word - .doc, .dot, .docx, .dotx, .docm, .dotm, .rtf, .odt, .txt, .htm, .html, .wpd * Excel - .xls, .xlsx, .xlsm, .xlt, .xltm, .xltx, .xlsb, .csv, .ods * Powerpoint - .ppt, .pptx, .pptm, .pot, .potm, .potx, .pps, .ppsx, .ppsm, .odp * Visio - .vsd, .vsdm, .vsdx, [.vdx, .vdw, .dwg, .dfx, .wmf, .emf, .emz, .svg require Visio >= 2013] * Publisher - .pub * Outlook - .msg, .vcf, .ics * Project - .mpp [requires Project >= 2010] * Windows - .xps Usage: ------ In order to use the tool, simply call officetopdf.exe with two arguments - the source Office document and the destination PDF document. e.g. officetopdf.exe somefile.docx somefile.pdf Switches: --------- The following optional switches can be used: /bookmarks - create bookmarks in the PDF when they are supported by the Office application /readonly - attempts to open the source document in read-only mode /hidden - attempts to minimise the Office application when converting /markup - show document markup when creating PDFs with Word /print - create high-quality PDFs optimised for print /pdfa - produce ISO 19005-1 (PDF/A) compliant PDFs /excludeprops - Do not include properties in the PDF /excludetags - Do not include tags in the PDF /noquit - Do not quit already running Office applications once the conversion is done /verbose - print out messages as it runs /password <pass> - use <pass> as the password to open the document with /writepassword <pass> - use <pass> as the write password to open the document with /merge - when using a template, create a new file from the template and merge the text from the document to convert into the new file /template <template_path> - use a .dot, .dotx or .dotm template when converting with Word. When converting Excel, use the page settings from the first worksheet in the template document /excel_active_sheet - only convert the active worksheet /excel_auto_macros - run Auto_Open macros in Excel files before conversion /excel_delay - number of milliseconds to pause Excel for during file processing /excel_show_formulas - show formulas in the PDF when converting with Excel /excel_show_headings - show row and column headings /excel_max_rows <rows> - if any worksheet in a spreadsheet document has more than this number of rows, do not attempt to convert the file. Applies when converting with Excel /excel_no_link_update - do not update links when opening Excel files /excel_no_map_papersize - do not map papersize to A4/letter /excel_no_recalculate - skip automatic re-calculation of formulas in the workbook /excel_template_macros - run Auto_Open macros in the /template document before conversion by Excel /excel_worksheet <num> - only convert worksheet <num> in the workbook. First sheet is 1 /fallback_printer <name> - prints the image to the postscript printer with name <name> if the export failes - requires GhostScript /printer <name> - prints the image to the postscript printer with name <name> - requires GhostScript /powerpoint_output <type> - controls what is generated by output. Possible values are slides, notes, outline, build_slides, handouts and multi-page handouts using handout2, handout3, handout4, handout6 and handout9. The default is slides /word_header_dist <pts> - the distance (in points) from the header to the top of the page /word_footer_dist <pts> - the distance (in points) from the footer to the bottom of the page /word_field_quick_update - perform a fast update of fields in Word before conversion /word_field_quick_update_safe - perform a fast update of fields only if there are no un-available linked files. /word_fix_table_columns - fix table column widths in cases where table body columns do not match header column widths /word_keep_history - do not clear Word's recent files list /word_max_pages <pages> - do not attempt conversion of a Word document if it has more than this number of pages /word_no_field_update - do not update fields when creating the PDF /word_ref_fonts - when fonts are not available, a reference to the font is used in the generated PDF rather than a bitmapped version. The default is for a bitmap of the text to be used /word_show_comments - show comments when /markup is used /word_show_revs_comments - show revisions and comments when /markup is used /word_show_format_changes - show format changes when /markup is used /word_show_hidden - show hidden text /word_show_ink_annot - show ink annotations when /markup is used /word_show_ins_del - show all markup when /markup is used /word_show_all_markup - show all markup content when /markup is used /word_markup_balloon - show balloon style markup messages rather than inline ones /pdf_clean_meta <type> - allows for some meta-data to be removed from the generated PDF. <type> can be: basic - removes author, keywords, creator and subject full - removes all that basic removes and also the title /pdf_layout <layout> - controls how the pages layout in Acrobat Reader. <layout> can be one of the following values: onecol - show pages as a single scrolling column single - show pages one at a time twocolleft - show pages in two columns, with odd-numbered pages on the left twocolright - show pages in two columns, with odd-numbered pages on the right twopageleft - show pages two at a time, with odd-numbered pages on the left twopageright - show pages two at a time, with odd-numbered pages on the right /pdf_page_mode <mode> - controls how the PDF will open with Acrobat Reader. <mode> can be one of the following values: full - the PDF will open in fullscreen mode bookmarks - the PDF will open with the bookmarks visible thumbs - the PDF will open with the thumbnail view visible none - the PDF will open without the navigation bar visible /pdf_append - append the generated PDF to the end of the PDF destination /pdf_prepend - prepend the generated PDF to the start of the PDF destination /pdf_owner_pass <password> - set the owner password on the PDF. Needed to make modifications to the PDF /pdf_user_pass <password> - set the user password on the PDF. Needed to open the PDF /pdf_restrict_accessibility_extraction - Prevent all content extraction without the owner password /pdf_restrict_annotation - prevent annotations on the PDF without the owner password /pdf_restrict_assembly - prevent rotation, removal or insertion of pages without the owner password /pdf_restrict_extraction - prevent content extraction without the owner password /pdf_restrict_forms - prevent form entry without the owner password /pdf_restrict_full_quality - prevent full quality printing without the owner password /pdf_restrict_modify - prevent modification without the owner password /pdf_restrict_print - prevent printing without the owner password /printer <name> - prints the image to the postscript printer with name <name> - requires GhostScript /version - print out the version of OfficeToPDF and exit Templates: ---------- When converting documents with Word, the /template switch can be used to open the source document with a specific Word template file. If no /template switch is set, the default Normal.dotm template will be used. The template path must be the full path to the template file. e.g. /template c:\users\fred\Application Data\Microsoft\Templates\example.dotx For more information about Office template paths, see: http://office.microsoft.com/en-001/word-help/about-document-template-locations-HP003082725.aspx Error Codes: ------------ The following error codes are returned by OfficeToPDF. Note that multiple errors are returned as a bitmask, so bitwise operations can test for multiple errors. 0 - Success 1 - Failure 2 - Unknown Error 4 - File protected by password 8 - Invalid arguments 16 - Unable to open the source file 32 - Unsupported file format 64 - Source file not found 128 - Output directory not found 256 - The requested worksheet was not found 512 - Unable to use an empty worksheet 1024 - Unable to modify or open a protected PDF To check for a specific error code after calling officetopdf.exe, use the batch "SET /A" command. e.g. SET /A "PASSWORDFAIL=(%ERRORLEVEL% & 4)" IF %PASSWORDFAIL% NEQ 0 ( ECHO Password failed ) Handling Dialogs: ----------------- When converting, the environment variable OFFICE2PDF_AUTO_CONVERT will be set with a value of 1. The existence of this variable can be used by VBA/macro code in Office documents to indicate the document is being processed in an un-attended way. For instance, the following AutoOpen Word macro will show a message box whenever a document is opened: Sub AutoOpen() MsgBox "You have opened the document" End Sub OfficeToPDF will stall until the message box is closed. To avoid this, the macro can be updated to check for the OFFICE2PDF_AUTO_CONVERT environment variable. Sub AutoOpen() If Environ("OFFICE2PDF_AUTO_CONVERT") = "" Then MsgBox "You have opened the document" End If End Sub Credits: -------- Cognidox would like to thank all the people who have made suggestions through CodePlex. OfficeToPDF use the PDFSharp library: http://pdfsharp.codeplex.com/. This is licensed using the MIT License: http://pdfsharp.codeplex.com/license XPS extensions for PDFSharp from https://github.com/HiraokaHyperTools/PDFsharp. This is licensed using the MIT License: https://github.com/HiraokaHyperTools/PDFsharp/blob/master/LICENSE