Fix SEO and accessibility issues in production build
All checks were successful
Build & Deploy to Staging / Build & Deploy to Staging (push) Successful in 11m20s
All checks were successful
Build & Deploy to Staging / Build & Deploy to Staging (push) Successful in 11m20s
- Change 'Hosted in the EU' from h3 to h2 for proper heading hierarchy - Add FAQ structured data (JSON-LD) for rich search results - Remove onclick attributes from copy buttons (event listeners in app.js) These changes were previously applied to templates/pages/ but missing from public/src/ which is used by the Docker build. All changes now applied to correct source files and built.
This commit is contained in:
parent
4aeac959c3
commit
b476b0bd4e
7 changed files with 134 additions and 143 deletions
|
|
@ -4,7 +4,7 @@
|
|||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>Code Examples — DocFast HTML to PDF API</title>
|
||||
<meta name="description" content="Practical html to pdf api examples — generate pdf from html code, invoice pdf api, markdown to pdf, Node.js, Python, Go, PHP and Laravel integrations.">
|
||||
<meta name="description" content="Practical html to pdf api examples — generate pdf from html code, invoice pdf api, markdown to pdf, Node.js and Python integrations.">
|
||||
<meta property="og:title" content="Code Examples — DocFast HTML to PDF API">
|
||||
<meta property="og:description" content="Practical code examples for generating PDFs from HTML, Markdown, and more with the DocFast API.">
|
||||
<meta property="og:url" content="https://docfast.dev/examples">
|
||||
|
|
@ -113,8 +113,6 @@ footer .container { display: flex; justify-content: space-between; align-items:
|
|||
<a href="#receipt">Receipt</a>
|
||||
<a href="#nodejs">Node.js</a>
|
||||
<a href="#python">Python</a>
|
||||
<a href="#go">Go</a>
|
||||
<a href="#php">PHP</a>
|
||||
</nav>
|
||||
|
||||
<!-- Invoice -->
|
||||
|
|
@ -165,7 +163,7 @@ footer .container { display: flex; justify-content: space-between; align-items:
|
|||
|
||||
<div class="code-block">
|
||||
<span class="code-label">curl</span>
|
||||
<pre><code>curl -X POST https://docfast.dev/v1/convert/html \
|
||||
<pre><code>curl -X POST https://api.docfast.dev/v1/convert/html \
|
||||
-H <span class="str">"Authorization: Bearer YOUR_API_KEY"</span> \
|
||||
-H <span class="str">"Content-Type: application/json"</span> \
|
||||
-d <span class="str">'{"html": "<html>...your invoice HTML...</html>"}'</span> \
|
||||
|
|
@ -180,7 +178,7 @@ footer .container { display: flex; justify-content: space-between; align-items:
|
|||
|
||||
<div class="code-block">
|
||||
<span class="code-label">curl</span>
|
||||
<pre><code>curl -X POST https://docfast.dev/v1/convert/markdown \
|
||||
<pre><code>curl -X POST https://api.docfast.dev/v1/convert/markdown \
|
||||
-H <span class="str">"Authorization: Bearer YOUR_API_KEY"</span> \
|
||||
-H <span class="str">"Content-Type: application/json"</span> \
|
||||
-d '{
|
||||
|
|
@ -219,7 +217,7 @@ footer .container { display: flex; justify-content: space-between; align-items:
|
|||
|
||||
<div class="code-block">
|
||||
<span class="code-label">curl</span>
|
||||
<pre><code>curl -X POST https://docfast.dev/v1/convert/html \
|
||||
<pre><code>curl -X POST https://api.docfast.dev/v1/convert/html \
|
||||
-H <span class="str">"Authorization: Bearer YOUR_API_KEY"</span> \
|
||||
-H <span class="str">"Content-Type: application/json"</span> \
|
||||
-d @report.json \
|
||||
|
|
@ -273,137 +271,70 @@ footer .container { display: flex; justify-content: space-between; align-items:
|
|||
<!-- Node.js -->
|
||||
<section id="nodejs" class="example-section">
|
||||
<h2>Node.js Integration</h2>
|
||||
<p>Install the official SDK: <code>npm install docfast</code></p>
|
||||
<p>A complete Node.js script to generate a PDF and save it to disk. Works with Node 18+ using native fetch.</p>
|
||||
|
||||
<div class="code-block">
|
||||
<span class="code-label">JavaScript — Using the SDK (recommended)</span>
|
||||
<pre><code><span class="kw">import</span> DocFast <span class="kw">from</span> <span class="str">"docfast"</span>;
|
||||
<span class="kw">import</span> { writeFileSync } <span class="kw">from</span> <span class="str">"fs"</span>;
|
||||
<span class="code-label">JavaScript — generate-pdf.mjs</span>
|
||||
<pre><code><span class="kw">const</span> html = <span class="str">`
|
||||
<h1>Hello from Node.js</h1>
|
||||
<p>Generated at ${</span><span class="kw">new</span> <span class="fn">Date</span>().<span class="fn">toISOString</span>()<span class="str">}</p>
|
||||
`</span>;
|
||||
|
||||
<span class="kw">const</span> client = <span class="kw">new</span> <span class="fn">DocFast</span>(process.env.<span class="str">DOCFAST_API_KEY</span>);
|
||||
|
||||
<span class="cmt">// HTML to PDF</span>
|
||||
<span class="kw">const</span> pdf = <span class="kw">await</span> client.<span class="fn">html</span>(<span class="str">"<h1>Hello World</h1>"</span>);
|
||||
<span class="fn">writeFileSync</span>(<span class="str">"output.pdf"</span>, pdf);
|
||||
|
||||
<span class="cmt">// Markdown to PDF</span>
|
||||
<span class="kw">const</span> doc = <span class="kw">await</span> client.<span class="fn">markdown</span>(<span class="str">"# Report\n\nQ4 revenue grew **32%**."</span>);
|
||||
|
||||
<span class="cmt">// With options</span>
|
||||
<span class="kw">const</span> report = <span class="kw">await</span> client.<span class="fn">html</span>(html, {
|
||||
format: <span class="str">"A4"</span>,
|
||||
landscape: <span class="kw">true</span>,
|
||||
margin: { top: <span class="str">"20mm"</span>, bottom: <span class="str">"20mm"</span> },
|
||||
});</code></pre>
|
||||
</div>
|
||||
|
||||
<div class="code-block" style="margin-top: 16px;">
|
||||
<span class="code-label">JavaScript — Using fetch (no dependencies)</span>
|
||||
<pre><code><span class="kw">const</span> res = <span class="kw">await</span> <span class="fn">fetch</span>(<span class="str">"https://docfast.dev/v1/convert/html"</span>, {
|
||||
<span class="kw">const</span> res = <span class="kw">await</span> <span class="fn">fetch</span>(<span class="str">"https://api.docfast.dev/v1/convert/html"</span>, {
|
||||
method: <span class="str">"POST"</span>,
|
||||
headers: {
|
||||
<span class="str">"Authorization"</span>: <span class="str">`Bearer ${process.env.DOCFAST_API_KEY}`</span>,
|
||||
<span class="str">"Content-Type"</span>: <span class="str">"application/json"</span>,
|
||||
},
|
||||
body: <span class="fn">JSON.stringify</span>({ html: <span class="str">"<h1>Hello</h1>"</span> }),
|
||||
body: <span class="fn">JSON.stringify</span>({ html }),
|
||||
});
|
||||
<span class="kw">const</span> pdf = Buffer.<span class="fn">from</span>(<span class="kw">await</span> res.<span class="fn">arrayBuffer</span>());</code></pre>
|
||||
|
||||
<span class="kw">if</span> (!res.ok) <span class="kw">throw new</span> <span class="fn">Error</span>(<span class="str">`API error: ${res.status}`</span>);
|
||||
|
||||
<span class="kw">const</span> buffer = Buffer.<span class="fn">from</span>(<span class="kw">await</span> res.<span class="fn">arrayBuffer</span>());
|
||||
<span class="kw">await</span> <span class="kw">import</span>(<span class="str">"fs"</span>).then(<span class="fn">fs</span> =>
|
||||
fs.<span class="fn">writeFileSync</span>(<span class="str">"output.pdf"</span>, buffer)
|
||||
);
|
||||
|
||||
console.<span class="fn">log</span>(<span class="str">"✓ Saved output.pdf"</span>);</code></pre>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Python -->
|
||||
<section id="python" class="example-section">
|
||||
<h2>Python Integration</h2>
|
||||
<p>Install the official SDK: <code>pip install docfast</code></p>
|
||||
<p>Generate a PDF from Python using the <code>requests</code> library. Drop this into any Flask, Django, or FastAPI app.</p>
|
||||
|
||||
<div class="code-block">
|
||||
<span class="code-label">Python — Using the SDK (recommended)</span>
|
||||
<pre><code><span class="kw">from</span> docfast <span class="kw">import</span> DocFast
|
||||
<span class="code-label">Python — generate_pdf.py</span>
|
||||
<pre><code><span class="kw">import</span> os
|
||||
<span class="kw">import</span> requests
|
||||
|
||||
client = <span class="fn">DocFast</span>(<span class="str">"df_pro_your_api_key"</span>)
|
||||
|
||||
<span class="cmt"># HTML to PDF</span>
|
||||
pdf = client.<span class="fn">html</span>(<span class="str">"<h1>Hello World</h1>"</span>)
|
||||
<span class="kw">with</span> <span class="fn">open</span>(<span class="str">"output.pdf"</span>, <span class="str">"wb"</span>) <span class="kw">as</span> f:
|
||||
f.<span class="fn">write</span>(pdf)
|
||||
|
||||
<span class="cmt"># With options</span>
|
||||
pdf = client.<span class="fn">html</span>(html, format=<span class="str">"A4"</span>, landscape=<span class="kw">True</span>)
|
||||
|
||||
<span class="cmt"># Async support</span>
|
||||
<span class="kw">from</span> docfast <span class="kw">import</span> AsyncDocFast
|
||||
|
||||
<span class="kw">async with</span> <span class="fn">AsyncDocFast</span>(<span class="str">"df_pro_your_api_key"</span>) <span class="kw">as</span> client:
|
||||
pdf = <span class="kw">await</span> client.<span class="fn">html</span>(<span class="str">"<h1>Hello</h1>"</span>)</code></pre>
|
||||
</div>
|
||||
|
||||
<div class="code-block" style="margin-top: 16px;">
|
||||
<span class="code-label">Python — Using requests (no SDK)</span>
|
||||
<pre><code><span class="kw">import</span> requests
|
||||
html = <span class="str">"""
|
||||
<h1>Hello from Python</h1>
|
||||
<p>This PDF was generated via the DocFast API.</p>
|
||||
<ul>
|
||||
<li>Fast rendering</li>
|
||||
<li>Pixel-perfect output</li>
|
||||
<li>Simple REST API</li>
|
||||
</ul>
|
||||
"""</span>
|
||||
|
||||
response = requests.<span class="fn">post</span>(
|
||||
<span class="str">"https://docfast.dev/v1/convert/html"</span>,
|
||||
headers={<span class="str">"Authorization"</span>: <span class="str">f"Bearer {api_key}"</span>},
|
||||
json={<span class="str">"html"</span>: <span class="str">"<h1>Hello</h1>"</span>},
|
||||
)
|
||||
pdf = response.content</code></pre>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Go -->
|
||||
<section id="go" class="example-section">
|
||||
<h2>Go Integration</h2>
|
||||
<p>Install the official SDK: <code>go get github.com/docfast/docfast-go</code></p>
|
||||
<div class="code-block">
|
||||
<span class="code-label">Go — Using the SDK</span>
|
||||
<pre><code><span class="kw">package</span> main
|
||||
|
||||
<span class="kw">import</span> (
|
||||
<span class="str">"os"</span>
|
||||
docfast <span class="str">"github.com/docfast/docfast-go"</span>
|
||||
<span class="str">"https://api.docfast.dev/v1/convert/html"</span>,
|
||||
headers={
|
||||
<span class="str">"Authorization"</span>: <span class="str">f"Bearer {</span>os.environ[<span class="str">'DOCFAST_API_KEY'</span>]<span class="str">}"</span>,
|
||||
<span class="str">"Content-Type"</span>: <span class="str">"application/json"</span>,
|
||||
},
|
||||
json={<span class="str">"html"</span>: html},
|
||||
)
|
||||
|
||||
<span class="kw">func</span> main() {
|
||||
client := docfast.New(<span class="str">"df_pro_your_api_key"</span>)
|
||||
response.<span class="fn">raise_for_status</span>()
|
||||
|
||||
pdf, err := client.HTML(<span class="str">"<h1>Hello</h1><p>Generated with DocFast</p>"</span>, &docfast.PDFOptions{
|
||||
Format: <span class="str">"A4"</span>,
|
||||
Margin: &docfast.Margin{Top: <span class="str">"20mm"</span>, Bottom: <span class="str">"20mm"</span>},
|
||||
})
|
||||
<span class="kw">if</span> err != <span class="kw">nil</span> {
|
||||
panic(err)
|
||||
}
|
||||
os.WriteFile(<span class="str">"output.pdf"</span>, pdf, <span class="num">0644</span>)
|
||||
}</code></pre>
|
||||
</div>
|
||||
</section>
|
||||
<span class="kw">with</span> <span class="fn">open</span>(<span class="str">"output.pdf"</span>, <span class="str">"wb"</span>) <span class="kw">as</span> f:
|
||||
f.<span class="fn">write</span>(response.content)
|
||||
|
||||
<!-- PHP -->
|
||||
<section id="php" class="example-section">
|
||||
<h2>PHP Integration</h2>
|
||||
<p>Install the official SDK: <code>composer require docfast/docfast-php</code></p>
|
||||
<div class="code-block">
|
||||
<span class="code-label">PHP — Using the SDK</span>
|
||||
<pre><code><span class="kw">use</span> DocFast\Client;
|
||||
<span class="kw">use</span> DocFast\PdfOptions;
|
||||
|
||||
$client = <span class="kw">new</span> Client(<span class="str">'df_pro_your_api_key'</span>);
|
||||
|
||||
$options = <span class="kw">new</span> PdfOptions();
|
||||
$options->format = <span class="str">'A4'</span>;
|
||||
$options->margin = [<span class="str">'top'</span> => <span class="str">'20mm'</span>, <span class="str">'bottom'</span> => <span class="str">'20mm'</span>];
|
||||
|
||||
$pdf = $client->html(<span class="str">'<h1>Hello</h1><p>Generated with DocFast</p>'</span>, <span class="kw">null</span>, $options);
|
||||
file_put_contents(<span class="str">'output.pdf'</span>, $pdf);</code></pre>
|
||||
</div>
|
||||
<div class="code-block">
|
||||
<span class="code-label">Laravel — Using the Facade</span>
|
||||
<pre><code><span class="kw">use</span> DocFast\Laravel\Facades\DocFast;
|
||||
|
||||
<span class="cmt">// In your controller</span>
|
||||
$pdf = DocFast::html(view(<span class="str">'invoice'</span>)->render());
|
||||
<span class="kw">return</span> response($pdf)
|
||||
->header(<span class="str">'Content-Type'</span>, <span class="str">'application/pdf'</span>);</code></pre>
|
||||
<span class="fn">print</span>(<span class="str">"✓ Saved output.pdf"</span>)</code></pre>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue