mirror of
https://github.com/BookStackApp/BookStack.git
synced 2025-02-24 16:21:11 +08:00

Allows files to be placed within a "public" folder within a theme directory which the contents of will served by BookStack for access. - Only "web safe" content-types are provided. - A static 1 day cache time it set on served files. For #3904
82 lines
2.3 KiB
PHP
82 lines
2.3 KiB
PHP
<?php
|
|
|
|
namespace BookStack\Exports\Controllers;
|
|
|
|
use BookStack\Entities\Queries\BookQueries;
|
|
use BookStack\Exceptions\NotFoundException;
|
|
use BookStack\Exports\ExportFormatter;
|
|
use BookStack\Exports\ZipExports\ZipExportBuilder;
|
|
use BookStack\Http\Controller;
|
|
use Throwable;
|
|
|
|
class BookExportController extends Controller
|
|
{
|
|
public function __construct(
|
|
protected BookQueries $queries,
|
|
protected ExportFormatter $exportFormatter,
|
|
) {
|
|
$this->middleware('can:content-export');
|
|
$this->middleware('throttle:exports');
|
|
}
|
|
|
|
/**
|
|
* Export a book as a PDF file.
|
|
*
|
|
* @throws Throwable
|
|
*/
|
|
public function pdf(string $bookSlug)
|
|
{
|
|
$book = $this->queries->findVisibleBySlugOrFail($bookSlug);
|
|
$pdfContent = $this->exportFormatter->bookToPdf($book);
|
|
|
|
return $this->download()->directly($pdfContent, $bookSlug . '.pdf');
|
|
}
|
|
|
|
/**
|
|
* Export a book as a contained HTML file.
|
|
*
|
|
* @throws Throwable
|
|
*/
|
|
public function html(string $bookSlug)
|
|
{
|
|
$book = $this->queries->findVisibleBySlugOrFail($bookSlug);
|
|
$htmlContent = $this->exportFormatter->bookToContainedHtml($book);
|
|
|
|
return $this->download()->directly($htmlContent, $bookSlug . '.html');
|
|
}
|
|
|
|
/**
|
|
* Export a book as a plain text file.
|
|
*/
|
|
public function plainText(string $bookSlug)
|
|
{
|
|
$book = $this->queries->findVisibleBySlugOrFail($bookSlug);
|
|
$textContent = $this->exportFormatter->bookToPlainText($book);
|
|
|
|
return $this->download()->directly($textContent, $bookSlug . '.txt');
|
|
}
|
|
|
|
/**
|
|
* Export a book as a markdown file.
|
|
*/
|
|
public function markdown(string $bookSlug)
|
|
{
|
|
$book = $this->queries->findVisibleBySlugOrFail($bookSlug);
|
|
$textContent = $this->exportFormatter->bookToMarkdown($book);
|
|
|
|
return $this->download()->directly($textContent, $bookSlug . '.md');
|
|
}
|
|
|
|
/**
|
|
* Export a book to a contained ZIP export file.
|
|
* @throws NotFoundException
|
|
*/
|
|
public function zip(string $bookSlug, ZipExportBuilder $builder)
|
|
{
|
|
$book = $this->queries->findVisibleBySlugOrFail($bookSlug);
|
|
$zip = $builder->buildForBook($book);
|
|
|
|
return $this->download()->streamedFileDirectly($zip, $bookSlug . '.zip', true);
|
|
}
|
|
}
|