Konwersja HTML do PDF z wiersza poleceń — wsadowy konwerter serwerowy

Masz setki plików HTML lub zapisanych stron internetowych na serwerze, które muszą zostać przekonwertowane do PDF — do archiwizacji, dystrybucji offline lub do procesu dostarczającego dokumenty do druku użytkownikom końcowym. Otwieranie każdego pliku w przeglądarce i drukowanie do PDF się nie skaluje. Total HTML Converter X konwertuje pliki HTML do PDF z wiersza poleceń, wsadowo, bez GUI i bez instalacji przeglądarki. Zainstaluj go na serwerze Windows, wywołaj ze skryptu lub przez ActiveX i pozwól mu działać bez nadzoru.

Co potrafi Total HTML Converter X

• Konwersja wsadowa — podaj maskę (*.html), a konwerter przetworzy każdy pasujący plik w jednym przebiegu
• Zabezpieczenia PDF — ustaw hasła użytkownika i właściciela, ogranicz drukowanie, zabroń kopiowania tekstu, dodaj podpisy cyfrowe
• Znaki wodne — umieść tekstowy lub graficzny znak wodny na każdej stronie podczas konwersji
• Renderowanie CSS — rozpoznaje wszystkie znaczniki HTML, style CSS 1 i CSS 2, obrazy inline oraz tabele
• Kontrola układu strony — ustaw rozmiar papieru, orientację, marginesy i automatyczne dopasowanie szerokości HTML do strony PDF
• Brak GUI — działa cicho z wiersza poleceń bez wyskakujących okien i dialogów potwierdzenia
• ActiveX / COM — wywołuj konwerter z .NET, VBScript, PHP, Python lub dowolnego środowiska zgodnego z COM, aby osadzić konwersję we własnej aplikacji
• Skrypty .bat — zapisz polecenia w plikach wsadowych i zaplanuj je za pomocą Harmonogramu zadań systemu Windows do pełnej automatyzacji konwersji

Windows 7/8/10/11 • Server 2008/2012/2016/2019/2022

HTML a PDF: dlaczego warto konwertować?

HTML to język znaczników zaprojektowany dla przeglądarek internetowych. Plik HTML może odwoływać się do zewnętrznych arkuszy stylów, obrazów i skryptów, które mogą być niedostępne offline. Renderowanie zależy od silnika przeglądarki, zainstalowanych czcionek i rozmiaru ekranu. Strona HTML wydrukowana z Chrome może wyglądać inaczej niż ta sama strona wydrukowana z Firefox lub Edge.

PDF to format o stałym układzie, który wygląda identycznie na każdym urządzeniu. Zachowuje czcionki, obrazy i układ dokładnie zgodnie z zamierzeniem. Pliki PDF mogą być chronione hasłem, podpisane cyfrowo oraz zabezpieczone przed edycją i drukowaniem. Otwierają się natywnie w każdej przeglądarce, mobilnym systemie operacyjnym i systemie desktopowym bez połączenia z internetem.

Jak konwertować HTML do PDF z wiersza poleceń

Krok 1. Zainstaluj Total HTML Converter X

Pobierz instalator z linku powyżej i uruchom go na serwerze lub stacji roboczej Windows. Instalacja trwa mniej niż minutę. Nie wymaga instalacji przeglądarki ani pakietu Microsoft Office — konwerter używa własnego silnika renderowania obsługującego znaczniki HTML, style CSS 1/2 i osadzone obrazy.

Krok 2. Otwórz wiersz poleceń

Otwórz cmd.exe lub PowerShell. Plik wykonywalny konwertera to HTMLConverter.exe, znajdujący się w folderze instalacyjnym (zwykle C:\Program Files\CoolUtils\TotalHTMLConverterX\). Dodaj go do systemowej zmiennej PATH lub używaj pełnej ścieżki w poleceniach.

Krok 3. Uruchom podstawową konwersję

Najprostsze polecenie konwertuje wszystkie pliki HTML w folderze do PDF:

HTMLConverter.exe C:\Pages\*.html C:\Output\ -c PDF

Przetwarza każdy plik .html w folderze C:\Pages\ i zapisuje wynikowe pliki PDF w C:\Output\. Każdy plik HTML tworzy jeden PDF o tej samej nazwie bazowej.

Krok 4. Dodaj opcje zabezpieczeń i formatowania

Kontroluj wyjście PDF za pomocą dodatkowych flag:

HTMLConverter.exe C:\Pages\*.html C:\Output\ -c PDF -OwnerPassword admin123 -NoPrint -NoCopy

• -OwnerPassword admin123 — ustaw hasło właściciela PDF kontrolujące uprawnienia
• -UserPassword open456 — ustaw hasło wymagane do otwarcia pliku PDF
• -NoPrint — wyłącz drukowanie w wyjściowym pliku PDF
• -NoCopy — zabroń zaznaczania i kopiowania tekstu
• -Watermark "CONFIDENTIAL" — umieść tekst na każdej stronie
• -PageNum — dodaj numery stron w stopce
• -log C:\Logs\html2pdf.log — zapisz dziennik konwersji do weryfikacji

Krok 5. Zautomatyzuj za pomocą pliku .bat

Zapisz polecenie w pliku .bat i zaplanuj je za pomocą Harmonogramu zadań systemu Windows:

@echo off
"C:\Program Files\CoolUtils\TotalHTMLConverterX\HTMLConverter.exe" C:\Incoming\*.html C:\Archive\PDF\ -c PDF -OwnerPassword secret -NoPrint -log C:\Logs\html2pdf.log

Uruchamia konwersję każdej nocy (lub z dowolną częstotliwością) i zapisuje plik dziennika, aby można było zweryfikować wyniki.

Integracja ActiveX / COM

Total HTML Converter X zawiera pełny interfejs ActiveX. Możesz wywoływać konwerter z dowolnego środowiska zgodnego z COM — .NET, VBScript, PHP, Python, Ruby lub ASP. Pozwala to osadzić konwersję HTML do PDF we własnej aplikacji webowej, portalu intranetowym lub procesie dokumentowym bez uruchamiania osobnego procesu z wiersza poleceń.

Przykład (C#/.NET):

HTMLConverterX Cnv = new HTMLConverterX();
Cnv.Convert("C:\\Pages\\report.html", "C:\\Output\\report.pdf", "-c PDF -log c:\\Logs\\html.log");

Przykład (PHP):

$c = new COM("HTMLConverter.HTMLConverterX");
$c->convert("C:\\Pages\\report.html", "C:\\Output\\report.pdf", "-c PDF -log c:\\Logs\\html.log");

To samo wywołanie działa z ASP.NET, VBScript, Python, Ruby, Perl i JavaScript (Windows Script Host). Twoja aplikacja webowa może przyjmować przesyłane pliki HTML i zwracać użytkownikowi pliki PDF w czasie rzeczywistym.

Konwertery online a Total HTML Converter X

Kiedy potrzebna jest konwersja HTML do PDF z wiersza poleceń

• Generowanie raportów. Aplikacja webowa generuje raporty HTML. Total HTML Converter X konwertuje je do PDF po stronie serwera do pobrania lub wysłania e-mailem — bez różnic w renderowaniu przeglądarek, bez ręcznego eksportu.
• Archiwizacja stron internetowych. Organizacje, które muszą zachować strony internetowe jako dokumenty prawne lub zgodności, konwertują zapisane pliki HTML do PDF. PDF o stałym układzie utrwala stronę dokładnie tak, jak wyglądała, niezależnie od zasobów zewnętrznych.
• Generowanie faktur i rachunków. Platformy e-commerce i systemy rozliczeniowe tworzą faktury jako szablony HTML. Konwerter zamienia je w gotowe do druku pliki PDF z ochroną hasłem i znakami wodnymi za pomocą jednego polecenia.
• Dostarczanie dokumentów przez portal. Portal intranetowy przechowuje treści jako HTML. Gdy użytkownicy żądają wersji do druku, serwer konwertuje HTML do PDF w locie przez ActiveX i przesyła wynik do przeglądarki.
• Eliminacja zależności od przeglądarki na serwerach. Uruchamianie pełnej przeglądarki na serwerze do konwersji HTML na PDF jest zasobochłonne i zawodne. Total HTML Converter X całkowicie zastępuje zależność od przeglądarki lekkim narzędziem wiersza poleceń.

Dlaczego Total HTML Converter X

Bez przeglądarki

Konwerter używa własnego silnika renderowania do parsowania HTML i CSS. Nie potrzebujesz Chrome, Firefox ani żadnej przeglądarki zainstalowanej na serwerze. Eliminuje to problemy z aktualizacjami przeglądarek, zmniejsza obciążenie serwera i pozwala uniknąć niestabilności automatyzacji przeglądarek bezgłowych.

Prawdziwa aplikacja serwerowa

Total HTML Converter X jest zaprojektowany do pracy bez nadzoru. Żadnych okien GUI, okien dialogowych ani monitów potwierdzenia. Działa cicho z wiersza poleceń lub jako część usługi — dokładnie to, czego potrzebuje serwer produkcyjny.

Pełna kontrola PDF

Ustaw hasła, ogranicz uprawnienia, dodaj znaki wodne, wstaw numery stron, dodaj podpisy cyfrowe, dostosuj nagłówki i stopki, kontroluj rozmiar papieru i marginesy — wszystko z wiersza poleceń. Każda opcja jest dostępna jako flaga wiersza poleceń lub parametr ActiveX.

Nie tylko PDF

To samo narzędzie wiersza poleceń konwertuje HTML do DOC, XLS, TIFF, JPEG, RTF, TXT i wielu innych formatów. Jedna instalacja pokrywa wszystkie potrzeby konwersji HTML. Zmień -c PDF na -c TIFF, a otrzymasz wyjście TIFF z tymi samymi funkcjami wsadowymi i automatyzacji.

Windows 7/8/10/11 • Server 2008/2012/2016/2019/2022

string src  = @"C:\test\Source.html";
string dest = @"C:\test\Dest.pdf";

var cnv = new HTMLConverterX();
cnv.Convert(src, dest, "-cPDF -log c:\\test\\HTML.log");

if (!string.IsNullOrEmpty(cnv.ErrorMessage))
    throw new Exception(cnv.ErrorMessage);

public static class Function1
    {
        [FunctionName("Function1")]
        public static async Task Run(
            [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
            ILogger log)
        {
            StringBuilder sbLogs = new StringBuilder();
            sbLogs.AppendLine("started...");
            try
            {
                ProcessStartInfo startInfo = new ProcessStartInfo();
                startInfo.CreateNoWindow = true;
                startInfo.UseShellExecute = false;
                var assemblyDirectoryPath = Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location);
                assemblyDirectoryPath = assemblyDirectoryPath.Substring(0, assemblyDirectoryPath.Length - 4);

                var executablePath = $@"{assemblyDirectoryPath}\Converter\HTMLConverterX.exe";
                sbLogs.AppendLine(executablePath + "...");
                var srcPath = $@"{assemblyDirectoryPath}\src\sample.html";
                var outPath = Path.GetTempFileName() + ".pdf";
                startInfo.FileName = executablePath;

                if (File.Exists(outPath))
                {
                    File.Delete(outPath);
                }

                if (File.Exists(executablePath) && File.Exists(srcPath))
                {
                    sbLogs.AppendLine("files exists...");
                }
                else
                    sbLogs.AppendLine("EXE & source files NOT exists...");
                startInfo.WindowStyle = ProcessWindowStyle.Hidden;
                startInfo.Arguments = $"\"{srcPath}\" \"{outPath}\" -cPDF";
                using (Process exeProcess = Process.Start(startInfo))
                {
                    sbLogs.AppendLine($"wait...{DateTime.Now.ToString()}");
                    exeProcess.WaitForExit();
                    sbLogs.AppendLine($"complete...{DateTime.Now.ToString()}");
                }
                sbLogs.AppendLine("Conversion complete.");
            }
            catch (Exception ex)
            {
                sbLogs.AppendLine(ex.ToString());
            }

            return new OkObjectResult(sbLogs);
        }
    }

dim C
Set C=CreateObject("HTMLConverter.HTMLConverterX")
C.Convert "c:\source.html", "c:\dest.jpg", "-cJPG -log c:\html.log"
C.Convert "https://www.coolutils.com/", "c:\URL Page.pdf", "-cPDF -log c:\html.log"
Response.Write C.ErrorMessage
set C = nothing

dim C
Set C=CreateObject("HTMLConverter.HTMLConverterX")
Response.Clear
Response.AddHeader "Content-Type", "binary/octet-stream"
Response.AddHeader "Content-Disposition", "attachment; filename=test.pdf"
Response.BinaryWrite C.ConvertToStream("C:\www\ASP\Source.html", "C:\www\ASP", "-cpdf -log c:\html.log")
set C = nothing

$src="C:\\test\\test.html";
$dest="C:\\test\\test.pdf";
if (file_exists($dest)) unlink($dest);
$c= new COM("HTMLConverter.HTMLConverterX");
$c->convert($src,$dest, "-cPDF -log c:\\HTML.log");
if (file_exists($dest)) echo "OK"; else echo "fail:".$c->ErrorMessage;

require 'win32ole'
c = WIN32OLE.new('HTMLConverter.HTMLConverterX')

src = "C:\\test\\test.html"
dest = "C:\\test\\test.pdf"

c.convert(src, dest, "-cPDF -log c:\\test\\HTML.log")

if not File.exist?(dest)
  puts c.ErrorMessage
end

import win32com.client
import os.path

c = win32com.client.Dispatch("HTMLConverter.HTMLConverterX")

src  = "C:\\test\\test.html"
dest = "C:\\test\\test.pdf"

c.convert(src, dest, "-cPDF -log c:\\test\\HTML.log")

if not os.path.exists(dest):
    print(c.ErrorMessage)

uses Dialogs, Vcl.OleAuto;

var
  c: OleVariant;
begin
  c := CreateOleObject('HTMLConverter.HTMLConverterX');
  c.Convert('c:\test\source.html', 'c:\test\dest.pdf', '-cPDF -log c:\test\HTML.log');
  if c.ErrorMessage <> '' then
    ShowMessage(c.ErrorMessage);
end;

var c = new ActiveXObject("HTMLConverter.HTMLConverterX");
c.Convert("C:\\test\\source.html", "C:\\test\\dest.pdf", "-cPDF");
if (c.ErrorMessage != "")
  alert(c.ErrorMessage)

use Win32::OLE;

my $src  = "C:\\test\\test.html";
my $dest = "C:\\test\\test.pdf";

my $c = CreateObject Win32::OLE 'HTMLConverter.HTMLConverterX';
$c->convert($src, $dest, "-cPDF -log c:\\test\\HTML.log");
print $c->ErrorMessage if -e $dest;