4.0.0 (#42)

* adding URL conversions * updating gotenberg version in documentation * pkg: input as variadic string (#39) * pkg: input as variadic string * pkg: fix link to github doc * update doc about v4 client * make doc * fixing missing variadic inputs in doc * adding more fonts * updating PHP documentation
2026-08-08 00:22:14 +01:00 · 2019-01-28 15:18:12 +01:00
parent a3cd1ff4e1
commit 25f7ba3ee6
37 changed files with 553 additions and 103 deletions
--- a/README.md
+++ b/README.md
@@ -23,7 +23,7 @@ At TheCodingMachine, we build a lot of web applications (intranets, extranets an
 Open a terminal and run the following command:

 ```bash
-$ docker run --rm -p 3000:3000 thecodingmachine/gotenberg:3
+$ docker run --rm -p 3000:3000 thecodingmachine/gotenberg:4
 ```

 The API is now available on your host at `http://localhost:3000`.
@@ -33,7 +33,7 @@ to learn how to interact with it!

 ## Badges

-[![Docker image layers](https://images.microbadger.com/badges/image/thecodingmachine/gotenberg:3.svg)](https://microbadger.com/images/thecodingmachine/gotenberg:3)
+[![Docker image layers](https://images.microbadger.com/badges/image/thecodingmachine/gotenberg:4.svg)](https://microbadger.com/images/thecodingmachine/gotenberg:4)
 [![Travis CI](https://travis-ci.org/thecodingmachine/gotenberg.svg?branch=master)](https://travis-ci.org/thecodingmachine/gotenberg)
 [![GoDoc](https://godoc.org/github.com/thecodingmachine/gotenberg?status.svg)](https://godoc.org/github.com/thecodingmachine/gotenberg)
 [![Go Report Card](https://goreportcard.com/badge/github.com/thecodingmachine/gotenberg)](https://goreportcard.com/report/thecodingmachine/gotenberg)
--- a/build/base/Dockerfile
+++ b/build/base/Dockerfile
@@ -10,7 +10,7 @@ FROM debian:9.5-slim

 RUN echo "deb http://httpredir.debian.org/debian/ stretch main contrib non-free" > /etc/apt/sources.list &&\
    apt-get update &&\
-    apt-get install -y curl wget python3-pip
+    apt-get install -y curl wget python3-pip ttf-mscorefonts-installer

 # |--------------------------------------------------------------------------
 # | PM2
@@ -66,4 +66,39 @@ RUN pip3 install unoconv &&\
 # | https://github.com/thecodingmachine/gotenberg/issues/29
 # |

-RUN apt-get -y install pdftk
+RUN apt-get -y install pdftk
+
+# |--------------------------------------------------------------------------
+# | Fonts
+# |--------------------------------------------------------------------------
+# |
+# | Installs a handful of fonts.
+# | Note: ttf-mscorefonts-installer are installed on top of this Dockerfile.
+# |
+
+# Credits: 
+# https://github.com/arachnys/athenapdf/blob/master/cli/Dockerfile
+# https://help.accusoft.com/PrizmDoc/v12.1/HTML/Installing_Asian_Fonts_on_Ubuntu_and_Debian.html
+RUN apt-get install -y \
+    culmus \
+    fonts-beng \
+    fonts-hosny-amiri \
+    fonts-lklug-sinhala \
+    fonts-lohit-guru \
+    fonts-lohit-knda \
+    fonts-samyak-gujr \
+    fonts-samyak-mlym \
+    fonts-samyak-taml \
+    fonts-sarai \
+    fonts-sil-abyssinica \
+    fonts-sil-padauk \
+    fonts-telu \
+    fonts-thai-tlwg \
+    ttf-liberation \
+    ttf-wqy-zenhei \
+    fonts-arphic-uming \
+    fonts-ipafont-mincho \
+    fonts-ipafont-gothic \
+    fonts-unfonts-core
+
+COPY build/base/fonts.conf /etc/fonts/conf.d/100-gotenberg.conf
--- a/build/base/fonts.conf
+++ b/build/base/fonts.conf
@@ -0,0 +1,29 @@
+<?xml version='1.0'?>
+<!DOCTYPE fontconfig SYSTEM 'fonts.dtd'>
+<fontconfig>
+ <match target="font">
+  <edit mode="assign" name="rgba">
+   <const>rgb</const>
+  </edit>
+ </match>
+ <match target="font">
+  <edit mode="assign" name="hinting">
+   <bool>true</bool>
+  </edit>
+ </match>
+ <match target="font">
+  <edit mode="assign" name="hintstyle">
+   <const>hintslight</const>
+  </edit>
+ </match>
+ <match target="font">
+  <edit mode="assign" name="antialias">
+   <bool>true</bool>
+  </edit>
+ </match>
+  <match target="font">
+    <edit mode="assign" name="lcdfilter">
+      <const>lcddefault</const>
+    </edit>
+  </match>
+</fontconfig>
--- a/build/docs/content/01-install.md
+++ b/build/docs/content/01-install.md
@@ -7,7 +7,7 @@ Gotenberg is shipped within a Docker image.
 You may start it with:

 ```bash
-$ docker run --rm -p 3000:3000 thecodingmachine/gotenberg:3
+$ docker run --rm -p 3000:3000 thecodingmachine/gotenberg:4
 ```

 > The API will be available at [http://localhost:3000](http://localhost:3000).
@@ -22,7 +22,7 @@ services:
  # your others services

  gotenberg:
-    image: thecodingmachine/gotenberg:3
+    image: thecodingmachine/gotenberg:4
 ```

 > The API will be available under `gotenberg:3000` in your Docker Compose network.
--- a/build/docs/content/02-html.md
+++ b/build/docs/content/02-html.md
@@ -185,7 +185,7 @@ But this won't:
 You may also use *remote* paths for Google fonts, images and so on.

 > If you want to install fonts directly in the Gotenberg Docker image,
-> see to the [fonts section](#office.fonts).
+> see to the [fonts section](#fonts).

 ### cURL

@@ -208,11 +208,7 @@ import "github.com/thecodingmachine/gotenberg/pkg"
 func main() {
    c := &gotenberg.Client{Hostname: "http://localhost:3000"}
    req, _ := gotenberg.NewHTMLRequest("index.html")
-    req.SetAssets([]string{
-        "font.woff",
-        "img.gif",
-        "style.css",
-    })
+    req.SetAssets("font.woff", "img.gif", "style.css")
    dest := "result.pdf"
    c.Store(req, dest)
 }
@@ -234,8 +230,8 @@ $assets = [
 ];
 $request = new HTMLRequest($index);
 $request->setAssets($assets);
-$dirPath = "/foo";
-$filename = $client->store($request, $dirPath);
+$dest = "result.pdf";
+$client->store($request, $dest);
 ```

 ## Paper size, margins, orientation
@@ -294,6 +290,6 @@ $request = new HTMLRequest($index);
 $request->setPaperSize(Request::A4);
 $request->setMargins(Request::NO_MARGINS);
 $request->setLandscape(true);
-$dirPath = "/foo";
-$filename = $client->store($request, $dirPath);
+$dest = "result.pdf";
+$client->store($request, $dest);
 ```
--- a/build/docs/content/03-url.md
+++ b/build/docs/content/03-url.md
@@ -0,0 +1,56 @@
+---
+title: URL
+---
+
+Gotenberg provides the endpoint `/convert/url` for remote URL conversions.
+
+It accepts `POST` requests with a `multipart/form-data` Content-Type.
+
+## Basic
+
+This endpoint does not accept an `index.html` file nor assets files but a form field
+named `remoteURL` instead. Otherwise, URL conversions work the same as HTML conversions.
+
+> **Attention:** when converting a website to PDF, you should remove all margins.
+> If not, some of the content of the page might be hidden.
+
+### cURL
+
+```bash
+$ curl --request POST \
+    --url http://localhost:3000/convert/url \
+    --header 'Content-Type: multipart/form-data' \
+    --form remoteURL=https://google.com
+    --form marginTop=0 \
+    --form marginBottom=0 \
+    --form marginLeft=0 \
+    --form marginRight=0 \
+    -o result.pdf
+```
+
+### Go
+
+```golang
+import "github.com/thecodingmachine/gotenberg/pkg"
+
+func main() {
+    c := &gotenberg.Client{Hostname: "http://localhost:3000"}
+    req := gotenberg.NewURLRequest("https://google.com")
+    req.SetMargins(gotenberg.NoMargins)
+    dest := "result.pdf"
+    c.Store(req, dest)
+}
+```
+
+### PHP
+
+```php
+use TheCodingMachine\Gotenberg\Client;
+use TheCodingMachine\Gotenberg\URLRequest;
+
+$client = new Client('http://localhost:3000', new \Http\Adapter\Guzzle6\Client());
+$request = new URLRequest('https://google.com');
+$request->setMargins(Request::NO_MARGINS);
+$dest = "result.pdf";
+$filename = $client->store($request, $dest);
+```
--- a/build/docs/content/04-markdown.md
+++ b/build/docs/content/04-markdown.md
@@ -46,7 +46,7 @@ import "github.com/thecodingmachine/gotenberg/pkg"

 func main() {
    c := &gotenberg.Client{Hostname: "http://localhost:3000"}
-    req, _ := gotenberg.NewMarkdownRequest("index.html", []string{"file.md"})
+    req, _ := gotenberg.NewMarkdownRequest("index.html", "file.md")
    dest := "result.pdf"
    c.Store(req, dest)
 }
@@ -65,6 +65,6 @@ $markdowns = [
    DocumentFactory::makeFromPath('file.md', 'file.md'),
 ];
 $request = new MarkdownRequest($index, $markdowns);
-$dirPath = "/foo";
-$filename = $client->store($request, $dirPath);
+$dest = "result.pdf";
+$filename = $client->store($request, $dest);
 ```
--- a/build/docs/content/05-office.md
+++ b/build/docs/content/05-office.md
@@ -46,7 +46,7 @@ import "github.com/thecodingmachine/gotenberg/pkg"

 func main() {
    c := &gotenberg.Client{Hostname: "http://localhost:3000"}
-    req, _ := gotenberg.NewOfficeRequest([]string{"document.docx", "document2.docx"})
+    req, _ := gotenberg.NewOfficeRequest("document.docx", "document2.docx")
    dest := "result.pdf"
    c.Store(req, dest)
 }
@@ -65,8 +65,8 @@ $files = [
    DocumentFactory::makeFromPath('document2.docx', 'document2.docx'),
 ];
 $request = new OfficeRequest($files);
-$dirPath = "/foo";
-$filename = $client->store($request, $dirPath);
+$dest = "result.pdf";
+$filename = $client->store($request, $dest);
 ```

 ## Orientation
@@ -93,7 +93,7 @@ import "github.com/thecodingmachine/gotenberg/pkg"

 func main() {
    c := &gotenberg.Client{Hostname: "http://localhost:3000"}
-    req, _ := gotenberg.NewOfficeRequest([]string{"document.docx"})
+    req, _ := gotenberg.NewOfficeRequest("document.docx")
    req.SetLandscape(true)
    dest := "result.pdf"
    c.Store(req, dest)
@@ -113,18 +113,6 @@ $files = [
 ];
 $request = new OfficeRequest($files);
 $request->setLandscape(true);
-$dirPath = "/foo";
-$filename = $client->store($request, $dirPath);
-```
-
-## Fonts
-
-By default, only `ttf-mscorefonts` fonts are installed.
-
-If you wish to use more fonts, you will have to create your own image:
-
-```Dockerfile
-FROM thecodingmachine/gotenberg:3
-
-RUN apt-get -y install yourfonts
+$dest = "result.pdf";
+$filename = $client->store($request, $dest);
 ```
--- a/build/docs/content/06-merge.md
+++ b/build/docs/content/06-merge.md
@@ -29,7 +29,7 @@ import "github.com/thecodingmachine/gotenberg/pkg"

 func main() {
    c := &gotenberg.Client{Hostname: "http://localhost:3000"}
-    req, _ := gotenberg.NewMergeRequest([]string{"file.pdf", "file2.pdf"})
+    req, _ := gotenberg.NewMergeRequest("file.pdf", "file2.pdf")
    dest := "result.pdf"
    c.Store(req, dest)
 }
@@ -48,6 +48,6 @@ $files = [
    DocumentFactory::makeFromPath('file2.pdf', 'file2.pdf'),
 ];
 $request = new MergeRequest($files);
-$dirPath = "/foo";
-$filename = $client->store($request, $dirPath);
+$dest = "result.pdf";
+$filename = $client->store($request, $dest);
 ```
--- a/build/docs/content/07-webhook.md
+++ b/build/docs/content/07-webhook.md
--- a/build/docs/content/08-scalability.md
+++ b/build/docs/content/08-scalability.md
@@ -14,7 +14,7 @@ services:
  # your others services

  gotenberg:
-    image: thecodingmachine/gotenberg:3
+    image: thecodingmachine/gotenberg:4
 ```

 You may now launch your services using:
--- a/build/docs/content/09-liveness.md
+++ b/build/docs/content/09-liveness.md
--- a/build/docs/content/10-fonts.md
+++ b/build/docs/content/10-fonts.md
@@ -0,0 +1,13 @@
+---
+title: Fonts
+---
+
+By default, a handful of fonts are installed. Asian characters are also supported out of the box.
+
+If you wish to use more fonts, you will have to create your own image:
+
+```Dockerfile
+FROM thecodingmachine/gotenberg:4
+
+RUN apt-get -y install yourfonts
+```
--- a/build/docs/content/11-links.md
+++ b/build/docs/content/11-links.md
--- a/docs/index.html
+++ b/docs/index.html
@@ -45,6 +45,10 @@
                  <a href="#html">HTML</a>
                </div>
              
+                <div class="item">
+                  <a href="#url">URL</a>
+                </div>
+              
                <div class="item">
                  <a href="#markdown">Markdown</a>
                </div>
@@ -69,6 +73,10 @@
                  <a href="#liveness">Liveness</a>
                </div>
              
+                <div class="item">
+                  <a href="#fonts">Fonts</a>
+                </div>
+              
                <div class="item">
                  <a href="#links">Links</a>
                </div>
@@ -103,7 +111,7 @@

 <p>You may start it with:</p>

-<pre class="chroma">$ docker run --rm -p <span class="m">3000</span>:3000 thecodingmachine/gotenberg:3
+<pre class="chroma">$ docker run --rm -p <span class="m">3000</span>:3000 thecodingmachine/gotenberg:4
 </pre>

 <blockquote>
@@ -119,7 +127,7 @@
 </span><span class="w">  </span><span class="c"># your others services</span><span class="w">
 </span><span class="w">
 </span><span class="w">  </span>gotenberg<span class="p">:</span><span class="w">
-</span><span class="w">    </span>image<span class="p">:</span><span class="w"> </span>thecodingmachine/gotenberg<span class="p">:</span><span class="m">3</span><span class="w">
+</span><span class="w">    </span>image<span class="p">:</span><span class="w"> </span>thecodingmachine/gotenberg<span class="p">:</span><span class="m">4</span><span class="w">
 </span></pre>

 <blockquote>
@@ -354,7 +362,7 @@ are on the same level as the <code>index.html</code> file.</p>

 <blockquote>
 <p>If you want to install fonts directly in the Gotenberg Docker image,
-see to the <a href="#office.fonts">fonts section</a>.</p>
+see to the <a href="#fonts">fonts section</a>.</p>
 </blockquote>

 <h3 class="Heading"><a class="Anchor" aria-hidden="true" id="html.assets.c_url" href="#html.assets.c_url">
@@ -380,11 +388,7 @@ see to the <a href="#office.fonts">fonts section</a>.</p>
 <span class="kd">func</span> <span class="nf">main</span><span class="p">()</span> <span class="p">{</span>
    <span class="nx">c</span> <span class="o">:=</span> <span class="o">&amp;</span><span class="nx">gotenberg</span><span class="p">.</span><span class="nx">Client</span><span class="p">{</span><span class="nx">Hostname</span><span class="p">:</span> <span class="s">&#34;http://localhost:3000&#34;</span><span class="p">}</span>
    <span class="nx">req</span><span class="p">,</span> <span class="nx">_</span> <span class="o">:=</span> <span class="nx">gotenberg</span><span class="p">.</span><span class="nf">NewHTMLRequest</span><span class="p">(</span><span class="s">&#34;index.html&#34;</span><span class="p">)</span>
-    <span class="nx">req</span><span class="p">.</span><span class="nf">SetAssets</span><span class="p">([]</span><span class="kt">string</span><span class="p">{</span>
-        <span class="s">&#34;font.woff&#34;</span><span class="p">,</span>
-        <span class="s">&#34;img.gif&#34;</span><span class="p">,</span>
-        <span class="s">&#34;style.css&#34;</span><span class="p">,</span>
-    <span class="p">})</span>
+    <span class="nx">req</span><span class="p">.</span><span class="nf">SetAssets</span><span class="p">(</span><span class="s">&#34;font.woff&#34;</span><span class="p">,</span> <span class="s">&#34;img.gif&#34;</span><span class="p">,</span> <span class="s">&#34;style.css&#34;</span><span class="p">)</span>
    <span class="nx">dest</span> <span class="o">:=</span> <span class="s">&#34;result.pdf&#34;</span>
    <span class="nx">c</span><span class="p">.</span><span class="nf">Store</span><span class="p">(</span><span class="nx">req</span><span class="p">,</span> <span class="nx">dest</span><span class="p">)</span>
 <span class="p">}</span>
@@ -407,8 +411,8 @@ $assets = [
 ];
 $request = new HTMLRequest($index);
 $request-&gt;setAssets($assets);
-$dirPath = &#34;/foo&#34;;
-$filename = $client-&gt;store($request, $dirPath);
+$dest = &#34;result.pdf&#34;;
+$client-&gt;store($request, $dest);
 </pre>

 <h2 class="Heading"><a class="Anchor" aria-hidden="true" id="html.paper_size_margins_orientation" href="#html.paper_size_margins_orientation">
@@ -474,8 +478,74 @@ $request = new HTMLRequest($index);
 $request-&gt;setPaperSize(Request::A4);
 $request-&gt;setMargins(Request::NO_MARGINS);
 $request-&gt;setLandscape(true);
-$dirPath = &#34;/foo&#34;;
-$filename = $client-&gt;store($request, $dirPath);
+$dest = &#34;result.pdf&#34;;
+$client-&gt;store($request, $dest);
+</pre>
+
+              </div>
+            
+              <div class="Page" id="url">
+                <h1 class="Heading"><a class="Anchor" aria-hidden="true" id="url" href="#url">
+	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
+</a>URL</h1>
+                <p>Gotenberg provides the endpoint <code>/convert/url</code> for remote URL conversions.</p>
+
+<p>It accepts <code>POST</code> requests with a <code>multipart/form-data</code> Content-Type.</p>
+
+<h2 class="Heading"><a class="Anchor" aria-hidden="true" id="url.basic" href="#url.basic">
+	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
+</a>Basic</h2>
+
+<p>This endpoint does not accept an <code>index.html</code> file nor assets files but a form field
+named <code>remoteURL</code> instead. Otherwise, URL conversions work the same as HTML conversions.</p>
+
+<blockquote>
+<p><strong>Attention:</strong> when converting a website to PDF, you should remove all margins.
+If not, some of the content of the page might be hidden.</p>
+</blockquote>
+
+<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="url.basic.c_url" href="#url.basic.c_url">
+	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
+</a>cURL</h3>
+
+<pre class="chroma">$ curl --request POST <span class="se">\
+</span><span class="se"></span>    --url http://localhost:3000/convert/url <span class="se">\
+</span><span class="se"></span>    --header <span class="s1">&#39;Content-Type: multipart/form-data&#39;</span> <span class="se">\
+</span><span class="se"></span>    --form <span class="nv">remoteURL</span><span class="o">=</span>https://google.com
+    --form <span class="nv">marginTop</span><span class="o">=</span><span class="m">0</span> <span class="se">\
+</span><span class="se"></span>    --form <span class="nv">marginBottom</span><span class="o">=</span><span class="m">0</span> <span class="se">\
+</span><span class="se"></span>    --form <span class="nv">marginLeft</span><span class="o">=</span><span class="m">0</span> <span class="se">\
+</span><span class="se"></span>    --form <span class="nv">marginRight</span><span class="o">=</span><span class="m">0</span> <span class="se">\
+</span><span class="se"></span>    -o result.pdf
+</pre>
+
+<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="url.basic.go" href="#url.basic.go">
+	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
+</a>Go</h3>
+
+<pre class="chroma"><span class="kn">import</span> <span class="s">&#34;github.com/thecodingmachine/gotenberg/pkg&#34;</span>
+
+<span class="kd">func</span> <span class="nf">main</span><span class="p">()</span> <span class="p">{</span>
+    <span class="nx">c</span> <span class="o">:=</span> <span class="o">&amp;</span><span class="nx">gotenberg</span><span class="p">.</span><span class="nx">Client</span><span class="p">{</span><span class="nx">Hostname</span><span class="p">:</span> <span class="s">&#34;http://localhost:3000&#34;</span><span class="p">}</span>
+    <span class="nx">req</span> <span class="o">:=</span> <span class="nx">gotenberg</span><span class="p">.</span><span class="nf">NewURLRequest</span><span class="p">(</span><span class="s">&#34;https://google.com&#34;</span><span class="p">)</span>
+    <span class="nx">req</span><span class="p">.</span><span class="nf">SetMargins</span><span class="p">(</span><span class="nx">gotenberg</span><span class="p">.</span><span class="nx">NoMargins</span><span class="p">)</span>
+    <span class="nx">dest</span> <span class="o">:=</span> <span class="s">&#34;result.pdf&#34;</span>
+    <span class="nx">c</span><span class="p">.</span><span class="nf">Store</span><span class="p">(</span><span class="nx">req</span><span class="p">,</span> <span class="nx">dest</span><span class="p">)</span>
+<span class="p">}</span>
+</pre>
+
+<h3 class="Heading"><a class="Anchor" aria-hidden="true" id="url.basic.php" href="#url.basic.php">
+	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
+</a>PHP</h3>
+
+<pre class="chroma">use TheCodingMachine\Gotenberg\Client;
+use TheCodingMachine\Gotenberg\URLRequest;
+
+$client = new Client(&#39;http://localhost:3000&#39;, new \Http\Adapter\Guzzle6\Client());
+$request = new URLRequest(&#39;https://google.com&#39;);
+$request-&gt;setMargins(Request::NO_MARGINS);
+$dest = &#34;result.pdf&#34;;
+$filename = $client-&gt;store($request, $dest);
 </pre>

              </div>
@@ -531,7 +601,7 @@ in the file <code>index.html</code>. This function will convert a given markdown

 <span class="kd">func</span> <span class="nf">main</span><span class="p">()</span> <span class="p">{</span>
    <span class="nx">c</span> <span class="o">:=</span> <span class="o">&amp;</span><span class="nx">gotenberg</span><span class="p">.</span><span class="nx">Client</span><span class="p">{</span><span class="nx">Hostname</span><span class="p">:</span> <span class="s">&#34;http://localhost:3000&#34;</span><span class="p">}</span>
-    <span class="nx">req</span><span class="p">,</span> <span class="nx">_</span> <span class="o">:=</span> <span class="nx">gotenberg</span><span class="p">.</span><span class="nf">NewMarkdownRequest</span><span class="p">(</span><span class="s">&#34;index.html&#34;</span><span class="p">,</span> <span class="p">[]</span><span class="kt">string</span><span class="p">{</span><span class="s">&#34;file.md&#34;</span><span class="p">})</span>
+    <span class="nx">req</span><span class="p">,</span> <span class="nx">_</span> <span class="o">:=</span> <span class="nx">gotenberg</span><span class="p">.</span><span class="nf">NewMarkdownRequest</span><span class="p">(</span><span class="s">&#34;index.html&#34;</span><span class="p">,</span> <span class="s">&#34;file.md&#34;</span><span class="p">)</span>
    <span class="nx">dest</span> <span class="o">:=</span> <span class="s">&#34;result.pdf&#34;</span>
    <span class="nx">c</span><span class="p">.</span><span class="nf">Store</span><span class="p">(</span><span class="nx">req</span><span class="p">,</span> <span class="nx">dest</span><span class="p">)</span>
 <span class="p">}</span>
@@ -551,8 +621,8 @@ $markdowns = [
    DocumentFactory::makeFromPath(&#39;file.md&#39;, &#39;file.md&#39;),
 ];
 $request = new MarkdownRequest($index, $markdowns);
-$dirPath = &#34;/foo&#34;;
-$filename = $client-&gt;store($request, $dirPath);
+$dest = &#34;result.pdf&#34;;
+$filename = $client-&gt;store($request, $dest);
 </pre>

              </div>
@@ -613,7 +683,7 @@ See the <a href="#scalability">scalability section</a> to find how to mitigate t

 <span class="kd">func</span> <span class="nf">main</span><span class="p">()</span> <span class="p">{</span>
    <span class="nx">c</span> <span class="o">:=</span> <span class="o">&amp;</span><span class="nx">gotenberg</span><span class="p">.</span><span class="nx">Client</span><span class="p">{</span><span class="nx">Hostname</span><span class="p">:</span> <span class="s">&#34;http://localhost:3000&#34;</span><span class="p">}</span>
-    <span class="nx">req</span><span class="p">,</span> <span class="nx">_</span> <span class="o">:=</span> <span class="nx">gotenberg</span><span class="p">.</span><span class="nf">NewOfficeRequest</span><span class="p">([]</span><span class="kt">string</span><span class="p">{</span><span class="s">&#34;document.docx&#34;</span><span class="p">,</span> <span class="s">&#34;document2.docx&#34;</span><span class="p">})</span>
+    <span class="nx">req</span><span class="p">,</span> <span class="nx">_</span> <span class="o">:=</span> <span class="nx">gotenberg</span><span class="p">.</span><span class="nf">NewOfficeRequest</span><span class="p">(</span><span class="s">&#34;document.docx&#34;</span><span class="p">,</span> <span class="s">&#34;document2.docx&#34;</span><span class="p">)</span>
    <span class="nx">dest</span> <span class="o">:=</span> <span class="s">&#34;result.pdf&#34;</span>
    <span class="nx">c</span><span class="p">.</span><span class="nf">Store</span><span class="p">(</span><span class="nx">req</span><span class="p">,</span> <span class="nx">dest</span><span class="p">)</span>
 <span class="p">}</span>
@@ -633,8 +703,8 @@ $files = [
    DocumentFactory::makeFromPath(&#39;document2.docx&#39;, &#39;document2.docx&#39;),
 ];
 $request = new OfficeRequest($files);
-$dirPath = &#34;/foo&#34;;
-$filename = $client-&gt;store($request, $dirPath);
+$dest = &#34;result.pdf&#34;;
+$filename = $client-&gt;store($request, $dest);
 </pre>

 <h2 class="Heading"><a class="Anchor" aria-hidden="true" id="office.orientation" href="#office.orientation">
@@ -665,7 +735,7 @@ $filename = $client-&gt;store($request, $dirPath);

 <span class="kd">func</span> <span class="nf">main</span><span class="p">()</span> <span class="p">{</span>
    <span class="nx">c</span> <span class="o">:=</span> <span class="o">&amp;</span><span class="nx">gotenberg</span><span class="p">.</span><span class="nx">Client</span><span class="p">{</span><span class="nx">Hostname</span><span class="p">:</span> <span class="s">&#34;http://localhost:3000&#34;</span><span class="p">}</span>
-    <span class="nx">req</span><span class="p">,</span> <span class="nx">_</span> <span class="o">:=</span> <span class="nx">gotenberg</span><span class="p">.</span><span class="nf">NewOfficeRequest</span><span class="p">([]</span><span class="kt">string</span><span class="p">{</span><span class="s">&#34;document.docx&#34;</span><span class="p">})</span>
+    <span class="nx">req</span><span class="p">,</span> <span class="nx">_</span> <span class="o">:=</span> <span class="nx">gotenberg</span><span class="p">.</span><span class="nf">NewOfficeRequest</span><span class="p">(</span><span class="s">&#34;document.docx&#34;</span><span class="p">)</span>
    <span class="nx">req</span><span class="p">.</span><span class="nf">SetLandscape</span><span class="p">(</span><span class="kc">true</span><span class="p">)</span>
    <span class="nx">dest</span> <span class="o">:=</span> <span class="s">&#34;result.pdf&#34;</span>
    <span class="nx">c</span><span class="p">.</span><span class="nf">Store</span><span class="p">(</span><span class="nx">req</span><span class="p">,</span> <span class="nx">dest</span><span class="p">)</span>
@@ -686,23 +756,10 @@ $files = [
 ];
 $request = new OfficeRequest($files);
 $request-&gt;setLandscape(true);
-$dirPath = &#34;/foo&#34;;
-$filename = $client-&gt;store($request, $dirPath);
+$dest = &#34;result.pdf&#34;;
+$filename = $client-&gt;store($request, $dest);
 </pre>

-<h2 class="Heading"><a class="Anchor" aria-hidden="true" id="office.fonts" href="#office.fonts">
-	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
-</a>Fonts</h2>
-
-<p>By default, only <code>ttf-mscorefonts</code> fonts are installed.</p>
-
-<p>If you wish to use more fonts, you will have to create your own image:</p>
-
-<pre class="chroma"><span class="k">FROM</span><span class="s"> thecodingmachine/gotenberg:3</span><span class="err">
-</span><span class="err">
-</span><span class="err"></span><span class="k">RUN</span> apt-get -y install yourfonts<span class="err">
-</span></pre>
-
              </div>
            
              <div class="Page" id="merge">
@@ -740,7 +797,7 @@ will merge them and return the resulting PDF file.</p>

 <span class="kd">func</span> <span class="nf">main</span><span class="p">()</span> <span class="p">{</span>
    <span class="nx">c</span> <span class="o">:=</span> <span class="o">&amp;</span><span class="nx">gotenberg</span><span class="p">.</span><span class="nx">Client</span><span class="p">{</span><span class="nx">Hostname</span><span class="p">:</span> <span class="s">&#34;http://localhost:3000&#34;</span><span class="p">}</span>
-    <span class="nx">req</span><span class="p">,</span> <span class="nx">_</span> <span class="o">:=</span> <span class="nx">gotenberg</span><span class="p">.</span><span class="nf">NewMergeRequest</span><span class="p">([]</span><span class="kt">string</span><span class="p">{</span><span class="s">&#34;file.pdf&#34;</span><span class="p">,</span> <span class="s">&#34;file2.pdf&#34;</span><span class="p">})</span>
+    <span class="nx">req</span><span class="p">,</span> <span class="nx">_</span> <span class="o">:=</span> <span class="nx">gotenberg</span><span class="p">.</span><span class="nf">NewMergeRequest</span><span class="p">(</span><span class="s">&#34;file.pdf&#34;</span><span class="p">,</span> <span class="s">&#34;file2.pdf&#34;</span><span class="p">)</span>
    <span class="nx">dest</span> <span class="o">:=</span> <span class="s">&#34;result.pdf&#34;</span>
    <span class="nx">c</span><span class="p">.</span><span class="nf">Store</span><span class="p">(</span><span class="nx">req</span><span class="p">,</span> <span class="nx">dest</span><span class="p">)</span>
 <span class="p">}</span>
@@ -760,8 +817,8 @@ $files = [
    DocumentFactory::makeFromPath(&#39;file2.pdf&#39;, &#39;file2.pdf&#39;),
 ];
 $request = new MergeRequest($files);
-$dirPath = &#34;/foo&#34;;
-$filename = $client-&gt;store($request, $dirPath);
+$dest = &#34;result.pdf&#34;;
+$filename = $client-&gt;store($request, $dest);
 </pre>

              </div>
@@ -839,7 +896,7 @@ $resp = $client-&gt;post($request);
 </span><span class="w">  </span><span class="c"># your others services</span><span class="w">
 </span><span class="w">
 </span><span class="w">  </span>gotenberg<span class="p">:</span><span class="w">
-</span><span class="w">    </span>image<span class="p">:</span><span class="w"> </span>thecodingmachine/gotenberg<span class="p">:</span><span class="m">3</span><span class="w">
+</span><span class="w">    </span>image<span class="p">:</span><span class="w"> </span>thecodingmachine/gotenberg<span class="p">:</span><span class="m">4</span><span class="w">
 </span></pre>

 <p>You may now launch your services using:</p>
@@ -868,6 +925,21 @@ a simple <code>GET</code> request.</p>

              </div>
            
+              <div class="Page" id="fonts">
+                <h1 class="Heading"><a class="Anchor" aria-hidden="true" id="fonts" href="#fonts">
+	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
+</a>Fonts</h1>
+                <p>By default, a handful of fonts are installed. Asian characters are also supported out of the box.</p>
+
+<p>If you wish to use more fonts, you will have to create your own image:</p>
+
+<pre class="chroma"><span class="k">FROM</span><span class="s"> thecodingmachine/gotenberg:4</span><span class="err">
+</span><span class="err">
+</span><span class="err"></span><span class="k">RUN</span> apt-get -y install yourfonts<span class="err">
+</span></pre>
+
+              </div>
+            
              <div class="Page" id="links">
                <h1 class="Heading"><a class="Anchor" aria-hidden="true" id="links" href="#links">
 	<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>
--- a/go.mod
+++ b/go.mod
@@ -5,7 +5,7 @@ require (
 	github.com/google/go-cmp v0.2.0 // indirect
 	github.com/gorilla/websocket v1.4.0 // indirect
 	github.com/hhrutter/pdfcpu v0.1.19
-	github.com/labstack/echo v0.0.0-20181123063703-c7eb8da9ec73
+	github.com/labstack/echo v0.0.0-20190126223945-739700bf4ef7
 	github.com/labstack/gommon v0.2.8
 	github.com/mafredri/cdp v0.20.0
 	github.com/microcosm-cc/bluemonday v1.0.1
--- a/go.sum
+++ b/go.sum
@@ -14,6 +14,8 @@ github.com/hhrutter/pdfcpu v0.1.19 h1:J6GjNFDPjurQWallPW9gmz3CcNqBfvgB7Dad9T3e8H
 github.com/hhrutter/pdfcpu v0.1.19/go.mod h1:iaCmXGnOXPIvoGLELZZc4m/GpIopVsvLQ00thrbu8LU=
 github.com/labstack/echo v0.0.0-20181123063703-c7eb8da9ec73 h1:oQvA3Xy8274W5Ldgo6Nogy4lX8XO5AaIBsjF5Ggk0IU=
 github.com/labstack/echo v0.0.0-20181123063703-c7eb8da9ec73/go.mod h1:rS0D1UPvC8/3sXjhSwEq+K1olh7ipbDhjDWATN2KSgA=
+github.com/labstack/echo v0.0.0-20190126223945-739700bf4ef7 h1:kFheQLunLP9dCBrmg3D7y9FD44tlk/nvZQ7JCNvvWEA=
+github.com/labstack/echo v0.0.0-20190126223945-739700bf4ef7/go.mod h1:rS0D1UPvC8/3sXjhSwEq+K1olh7ipbDhjDWATN2KSgA=
 github.com/labstack/echo v3.3.5+incompatible h1:9PfxPUmasKzeJor9uQTaXLT6WUG/r+vSTmvXxvv3JO4=
 github.com/labstack/echo v3.3.5+incompatible/go.mod h1:0INS7j/VjnFxD4E2wkz67b8cVwCLbBmJyDaka6Cmk1s=
 github.com/labstack/gommon v0.2.7/go.mod h1:/tj9csK2iPSBvn+3NLM9e52usepMtrd5ilFYA+wQNJ4=
--- a/internal/app/api/api.go
+++ b/internal/app/api/api.go
@@ -71,6 +71,7 @@ func setup() *echo.Echo {
 	e.POST("/merge", merge)
 	g := e.Group("/convert")
 	g.POST("/html", convertHTML)
+	g.POST("/url", convertURL)
 	g.POST("/markdown", convertMarkdown)
 	g.POST("/office", convertOffice)
 	return e
--- a/internal/app/api/resource.go
+++ b/internal/app/api/resource.go
@@ -1,6 +1,7 @@
 package api

 import (
+	"errors"
 	"fmt"
 	"io"
 	"os"
@@ -12,6 +13,7 @@ import (
 )

 const (
+	remoteURL    string = "remoteURL"
 	webhookURL   string = "webhookURL"
 	paperWidth   string = "paperWidth"
 	paperHeight  string = "paperHeight"
@@ -31,6 +33,7 @@ type resource struct {

 func newResource(c echo.Context) (*resource, error) {
 	v := make(map[string]string)
+	v[remoteURL] = c.FormValue(remoteURL)
 	v[webhookURL] = c.FormValue(webhookURL)
 	v[paperWidth] = c.FormValue(paperWidth)
 	v[paperHeight] = c.FormValue(paperHeight)
@@ -180,5 +183,12 @@ func (r *resource) landscape() (bool, error) {
 	return landscape, nil
 }

+func (r *resource) remoteURL() (string, error) {
+	if r.values[remoteURL] == "" {
+		return "", errors.New("no remote URL")
+	}
+	return r.values[remoteURL], nil
+}
+
 func (r *resource) webhookURL() string { return r.values[webhookURL] }
 func (r *resource) removeAll() error   { return os.RemoveAll(r.dirPath) }
--- a/internal/app/api/url.go
+++ b/internal/app/api/url.go
@@ -0,0 +1,51 @@
+package api
+
+import (
+	"github.com/labstack/echo"
+	"github.com/thecodingmachine/gotenberg/internal/pkg/printer"
+)
+
+func convertURL(c echo.Context) error {
+	r, err := newResource(c)
+	if err != nil {
+		return hijackErr(err, r)
+	}
+	ctx, cancel := newContext(r)
+	if cancel != nil {
+		defer cancel()
+	}
+	p := &printer.HTML{Context: ctx}
+	URL, err := r.remoteURL()
+	if err != nil {
+		return hijackErr(err, r)
+	}
+	p.URL = URL
+	headerPath, _ := r.filePath("header.html")
+	if err := p.WithHeaderFile(headerPath); err != nil {
+		return hijackErr(err, r)
+	}
+	footerPath, _ := r.filePath("footer.html")
+	if err := p.WithFooterFile(footerPath); err != nil {
+		return hijackErr(err, r)
+	}
+	paperSize, err := r.paperSize()
+	if err != nil {
+		return hijackErr(err, r)
+	}
+	p.PaperWidth = paperSize[0]
+	p.PaperHeight = paperSize[1]
+	paperMargins, err := r.paperMargins()
+	if err != nil {
+		return hijackErr(err, r)
+	}
+	p.MarginTop = paperMargins[0]
+	p.MarginBottom = paperMargins[1]
+	p.MarginLeft = paperMargins[2]
+	p.MarginRight = paperMargins[3]
+	landscape, err := r.landscape()
+	if err != nil {
+		return hijackErr(err, r)
+	}
+	p.Landscape = landscape
+	return print(c, p, r)
+}
--- a/internal/app/api/url_test.go
+++ b/internal/app/api/url_test.go
@@ -0,0 +1,24 @@
+package api
+
+import (
+	"net/http"
+	"net/http/httptest"
+	"testing"
+
+	"github.com/labstack/echo"
+	"github.com/stretchr/testify/assert"
+	"github.com/thecodingmachine/gotenberg/test"
+)
+
+func TestURL(t *testing.T) {
+	body, contentType := test.URLTestMultipartForm(t)
+	req := httptest.NewRequest(http.MethodPost, "/convert/url", body)
+	req.Header.Set(echo.HeaderContentType, contentType)
+	rec := httptest.NewRecorder()
+	e := echo.New()
+	c := e.NewContext(req, rec)
+	if assert.NoError(t, convertURL(c)) {
+		assert.Equal(t, http.StatusOK, rec.Code)
+		assert.Equal(t, "application/pdf", rec.Header().Get(echo.HeaderContentType))
+	}
+}
--- a/pkg/README.md
+++ b/pkg/README.md
@@ -19,11 +19,11 @@ func main() {
    req, _ := gotenberg.NewHTMLRequest("index.html")
    req.SetHeader("header.html")
    req.SetFooter("footer.html")
-    req.SetAssets([]string{
+    req.SetAssets(
        "font.woff",
        "img.gif",
        "style.css",
-    })
+    )
    req.SetPaperSize(gotenberg.A4)
    req.SetMargins(gotenberg.NormalMargins)
    req.SetLandscape(false)
--- a/pkg/client.go
+++ b/pkg/client.go
@@ -13,6 +13,7 @@ import (
 )

 const (
+	remoteURL    string = "remoteURL"
 	webhookURL   string = "webhookURL"
 	paperWidth   string = "paperWidth"
 	paperHeight  string = "paperHeight"
@@ -71,7 +72,6 @@ type Request interface {
 type ChromeRequest interface {
 	SetHeader(fpath string) error
 	SetFooter(fpath string) error
-	SetAssets(fpaths []string) error
 	SetPaperSize(size [2]float64)
 	SetMargins(margins [4]float64)
 	SetLandscape(isLandscape bool)
--- a/pkg/doc.go
+++ b/pkg/doc.go
@@ -3,6 +3,6 @@ Package gotenberg is a Go client for
 interacting with a Gotenberg API.

 For more complete usages, head to the documentation:
-https://thecodingmachine.gotenberg.github.io.
+https://thecodingmachine.github.io/gotenberg/
 */
 package gotenberg
--- a/pkg/html.go
+++ b/pkg/html.go
@@ -48,7 +48,7 @@ func (html *HTMLRequest) SetFooter(fpath string) error {
 }

 // SetAssets sets assets form files.
-func (html *HTMLRequest) SetAssets(fpaths []string) error {
+func (html *HTMLRequest) SetAssets(fpaths ...string) error {
 	for _, fpath := range fpaths {
 		if !fileExists(fpath) {
 			return fmt.Errorf("%s: file does not exist", fpath)
--- a/pkg/html_test.go
+++ b/pkg/html_test.go
@@ -19,11 +19,11 @@ func TestHTML(t *testing.T) {
 	require.Nil(t, err)
 	err = req.SetFooter(test.HTMLTestFilePath(t, "footer.html"))
 	require.Nil(t, err)
-	err = req.SetAssets([]string{
+	err = req.SetAssets(
 		test.HTMLTestFilePath(t, "font.woff"),
 		test.HTMLTestFilePath(t, "img.gif"),
 		test.HTMLTestFilePath(t, "style.css"),
-	})
+	)
 	require.Nil(t, err)
 	req.SetPaperSize(A4)
 	req.SetMargins(NormalMargins)
--- a/pkg/markdown.go
+++ b/pkg/markdown.go
@@ -18,7 +18,7 @@ type MarkdownRequest struct {
 }

 // NewMarkdownRequest create MarkdownRequest.
-func NewMarkdownRequest(indexFilePath string, markdownFilePaths []string) (*MarkdownRequest, error) {
+func NewMarkdownRequest(indexFilePath string, markdownFilePaths ...string) (*MarkdownRequest, error) {
 	if !fileExists(indexFilePath) {
 		return nil, fmt.Errorf("%s: index file does not exist", indexFilePath)
 	}
@@ -58,7 +58,7 @@ func (markdown *MarkdownRequest) SetFooter(fpath string) error {
 }

 // SetAssets sets assets form files.
-func (markdown *MarkdownRequest) SetAssets(fpaths []string) error {
+func (markdown *MarkdownRequest) SetAssets(fpaths ...string) error {
 	for _, fpath := range fpaths {
 		if !fileExists(fpath) {
 			return fmt.Errorf("%s: file does not exist", fpath)
--- a/pkg/markdown_test.go
+++ b/pkg/markdown_test.go
@@ -15,22 +15,20 @@ func TestMarkdown(t *testing.T) {
 	c := &Client{Hostname: "http://localhost:3000"}
 	req, err := NewMarkdownRequest(
 		test.MarkdownTestFilePath(t, "index.html"),
-		[]string{
-			test.MarkdownTestFilePath(t, "paragraph1.md"),
-			test.MarkdownTestFilePath(t, "paragraph2.md"),
-			test.MarkdownTestFilePath(t, "paragraph3.md"),
-		},
+		test.MarkdownTestFilePath(t, "paragraph1.md"),
+		test.MarkdownTestFilePath(t, "paragraph2.md"),
+		test.MarkdownTestFilePath(t, "paragraph3.md"),
 	)
 	require.Nil(t, err)
 	err = req.SetHeader(test.MarkdownTestFilePath(t, "header.html"))
 	require.Nil(t, err)
 	err = req.SetFooter(test.MarkdownTestFilePath(t, "footer.html"))
 	require.Nil(t, err)
-	err = req.SetAssets([]string{
+	err = req.SetAssets(
 		test.MarkdownTestFilePath(t, "font.woff"),
 		test.MarkdownTestFilePath(t, "img.gif"),
 		test.MarkdownTestFilePath(t, "style.css"),
-	})
+	)
 	require.Nil(t, err)
 	req.SetPaperSize(A4)
 	req.SetMargins(NormalMargins)
--- a/pkg/merge.go
+++ b/pkg/merge.go
@@ -13,7 +13,7 @@ type MergeRequest struct {
 }

 // NewMergeRequest create MergeRequest.
-func NewMergeRequest(fpaths []string) (*MergeRequest, error) {
+func NewMergeRequest(fpaths ...string) (*MergeRequest, error) {
 	for _, fpath := range fpaths {
 		if !fileExists(fpath) {
 			return nil, fmt.Errorf("%s: file does not exist", fpath)
--- a/pkg/merge_test.go
+++ b/pkg/merge_test.go
@@ -13,10 +13,10 @@ import (

 func TestMerge(t *testing.T) {
 	c := &Client{Hostname: "http://localhost:3000"}
-	req, err := NewMergeRequest([]string{
+	req, err := NewMergeRequest(
 		test.PDFTestFilePath(t, "gotenberg.pdf"),
 		test.PDFTestFilePath(t, "gotenberg.pdf"),
-	})
+	)
 	require.Nil(t, err)
 	dirPath, err := rand.Get()
 	require.Nil(t, err)
--- a/pkg/office.go
+++ b/pkg/office.go
@@ -14,7 +14,7 @@ type OfficeRequest struct {
 }

 // NewOfficeRequest create OfficeRequest.
-func NewOfficeRequest(fpaths []string) (*OfficeRequest, error) {
+func NewOfficeRequest(fpaths ...string) (*OfficeRequest, error) {
 	for _, fpath := range fpaths {
 		if !fileExists(fpath) {
 			return nil, fmt.Errorf("%s: file does not exist", fpath)
--- a/pkg/office_test.go
+++ b/pkg/office_test.go
@@ -13,9 +13,7 @@ import (

 func TestOffice(t *testing.T) {
 	c := &Client{Hostname: "http://localhost:3000"}
-	req, err := NewOfficeRequest([]string{
-		test.OfficeTestFilePath(t, "document.docx"),
-	})
+	req, err := NewOfficeRequest(test.OfficeTestFilePath(t, "document.docx"))
 	require.Nil(t, err)
 	req.SetLandscape(false)
 	dirPath, err := rand.Get()
--- a/pkg/url.go
+++ b/pkg/url.go
@@ -0,0 +1,85 @@
+package gotenberg
+
+import (
+	"fmt"
+	"strconv"
+)
+
+// URLRequest facilitates remote URL conversion
+// with the Gotenberg API.
+type URLRequest struct {
+	headerFilePath string
+	footerFilePath string
+	values         map[string]string
+}
+
+// NewURLRequest create URLRequest.
+func NewURLRequest(URL string) *URLRequest {
+	req := &URLRequest{values: make(map[string]string)}
+	req.values[remoteURL] = URL
+	return req
+}
+
+// SetWebhookURL sets webhookURL form field.
+func (url *URLRequest) SetWebhookURL(webhookURL string) {
+	url.values[webhookURL] = webhookURL
+}
+
+// SetHeader sets header form file.
+func (url *URLRequest) SetHeader(fpath string) error {
+	if !fileExists(fpath) {
+		return fmt.Errorf("%s: header file does not exist", fpath)
+	}
+	url.headerFilePath = fpath
+	return nil
+}
+
+// SetFooter sets footer form file.
+func (url *URLRequest) SetFooter(fpath string) error {
+	if !fileExists(fpath) {
+		return fmt.Errorf("%s: footer file does not exist", fpath)
+	}
+	url.footerFilePath = fpath
+	return nil
+}
+
+// SetPaperSize sets paperWidth and paperHeight form fields.
+func (url *URLRequest) SetPaperSize(size [2]float64) {
+	url.values[paperWidth] = fmt.Sprintf("%f", size[0])
+	url.values[paperHeight] = fmt.Sprintf("%f", size[1])
+}
+
+// SetMargins sets marginTop, marginBottom,
+// marginLeft and marginRight form fields.
+func (url *URLRequest) SetMargins(margins [4]float64) {
+	url.values[marginTop] = fmt.Sprintf("%f", margins[0])
+	url.values[marginBottom] = fmt.Sprintf("%f", margins[1])
+	url.values[marginLeft] = fmt.Sprintf("%f", margins[2])
+	url.values[marginRight] = fmt.Sprintf("%f", margins[3])
+}
+
+// SetLandscape sets landscape form field.
+func (url *URLRequest) SetLandscape(isLandscape bool) {
+	url.values[landscape] = strconv.FormatBool(isLandscape)
+}
+
+func (url *URLRequest) getPostURL() string {
+	return "/convert/url"
+}
+
+func (url *URLRequest) getFormValues() map[string]string {
+	return url.values
+}
+
+func (url *URLRequest) getFormFiles() map[string]string {
+	files := make(map[string]string)
+	files["header.html"] = url.headerFilePath
+	files["footer.html"] = url.footerFilePath
+	return files
+}
+
+// Compile-time checks to ensure type implements desired interfaces.
+var (
+	_ = Request(new(URLRequest))
+	_ = ChromeRequest(new(URLRequest))
+)
--- a/pkg/url_test.go
+++ b/pkg/url_test.go
@@ -0,0 +1,41 @@
+package gotenberg
+
+import (
+	"fmt"
+	"os"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"github.com/thecodingmachine/gotenberg/internal/pkg/rand"
+	"github.com/thecodingmachine/gotenberg/test"
+)
+
+func TestURL(t *testing.T) {
+	c := &Client{Hostname: "http://localhost:3000"}
+	req := NewURLRequest("http://google.com")
+	err := req.SetHeader(test.URLTestFilePath(t, "header.html"))
+	require.Nil(t, err)
+	err = req.SetFooter(test.URLTestFilePath(t, "footer.html"))
+	require.Nil(t, err)
+	require.Nil(t, err)
+	req.SetPaperSize(A4)
+	req.SetMargins(NormalMargins)
+	req.SetLandscape(false)
+	dirPath, err := rand.Get()
+	require.Nil(t, err)
+	dest := fmt.Sprintf("%s/foo.pdf", dirPath)
+	err = c.Store(req, dest)
+	assert.Nil(t, err)
+	assert.FileExists(t, dest)
+	err = os.RemoveAll(dirPath)
+	assert.Nil(t, err)
+}
+
+func TestConcurrentURL(t *testing.T) {
+	for i := 0; i < 10; i++ {
+		go func() {
+			TestURL(t)
+		}()
+	}
+}
--- a/test/testdata/url/footer.html
+++ b/test/testdata/url/footer.html
@@ -0,0 +1,15 @@
+<html>
+    <head>
+        <style>
+            body {
+                font-size: 8rem;
+                margin: 4rem auto;
+            }
+        </style>
+    </head>
+    <body>
+        <p>
+            <span class="pageNumber"></span> of <span class="totalPages"></span>
+        </p>
+    </body>
+</html>
--- a/test/testdata/url/header.html
+++ b/test/testdata/url/header.html
@@ -0,0 +1,13 @@
+<html>
+    <head>
+        <style>
+            body {
+                font-size: 8rem;
+                margin: 4rem auto;
+            }
+        </style>
+    </head>
+    <body>
+        <span class="title"></span>
+    </body>
+</html>
--- a/test/testfunc.go
+++ b/test/testfunc.go
@@ -23,6 +23,13 @@ func HTMLTestMultipartForm(t *testing.T) (*bytes.Buffer, string) {
 	return multipartForm(t, "html")
 }

+// URLTestMultipartForm returns the body
+// for a multipate/form-data request with all
+// files under "url" folder.
+func URLTestMultipartForm(t *testing.T) (*bytes.Buffer, string) {
+	return multipartForm(t, "url")
+}
+
 // MarkdownTestMultipartForm returns the body
 // for a multipate/form-data request with all
 // files under "markdown" folder.
@@ -65,6 +72,10 @@ func multipartForm(t *testing.T, kind string) (*bytes.Buffer, string) {
 		_, err = io.Copy(part, file)
 		require.Nil(t, err)
 	}
+	if kind == "url" {
+		err := writer.WriteField("remoteURL", "http://google.com")
+		require.Nil(t, err)
+	}
 	return body, writer.FormDataContentType()
 }

@@ -74,6 +85,12 @@ func HTMLTestDirPath(t *testing.T) string {
 	return copyDir(t, "html")
 }

+// URLTestDirPath creates a copy
+// of "url" folder in test/testdata.
+func URLTestDirPath(t *testing.T) string {
+	return copyDir(t, "url")
+}
+
 // MarkdownTestDirPath creates a copy
 // of "markdown" folder in test/testdata.
 func MarkdownTestDirPath(t *testing.T) string {
@@ -127,6 +144,12 @@ func HTMLTestFilePath(t *testing.T, filename string) string {
 	return abs(t, "html", filename)
 }

+// URLTestFilePath returns the absolute file path
+// of a file in "url" folder in test/testdata.
+func URLTestFilePath(t *testing.T, filename string) string {
+	return abs(t, "url", filename)
+}
+
 // MarkdownTestFilePath returns the absolute file path
 // of a file in "markdown" folder in test/testdata.
 func MarkdownTestFilePath(t *testing.T, filename string) string {