Cloudron-Pandoc-PDF-Builder/index.html

30 lines
2.2 KiB
HTML
Raw Permalink Normal View History

2022-01-29 10:10:50 +00:00
<html>
<body>
<h1>Pandoc PDF Builder</h1>
<hr>
<p>Upload a source document in Markdown (.md) format plus any images to be included.</p>
<p>This app will process them using Pandoc (https://pandoc.com) with a tweaked <a href="https://github.com/Wandmalfarbe/pandoc-latex-template">eisvogel template</a> and <a href="https://www.ctan.org/tex-archive/graphics/awesomebox">awesomebox.sty</a> to create a beautiful PDF, without the hassle of manual formatting in Word etc.</p>
<p><strong>THIS IS IN ALPHA STATUS : STILL IN DEVELOPMENT.</strong></p>
<hr>
<p>Click here to upload (1) a .md Markdown file (2) any included images</p>
<form action="fileupload" method="post" enctype="multipart/form-data">
<input type="file" name="filetoupload"><br><br>
<input type="submit" value="Upload">
</form>
<br>
<hr>
<h3>Background</h3>
<p>This app is a custom (i.e. not officially developed or maintained) app packaged for Cloudron.</p>
<p>It packages an instance of the excellent document conversion utility <a href="https://pandoc.org">Pandoc</a>.</p>
<p>Pandoc only runs from the command line. By packaging it into a web app, a consistent publishing environment can be maintained in a single location (avoiding multiple local installs which might change over time) and be accessible from any device, even without Pandoc and its utilities installed.</p>
<p>It is based on Cloudron's tutorial-supervisor app and the "pandoc docker" app from <a href="https://github.com/vpetersson/docker-pandoc">Viktor Petersson</a>.</p>
<p>Once the source Markdown and related images files are uploaded, click the button to process them.</p>
<p>The app will create a PDF, which must be downloaded to the local computer, as it cannot be retrieved later.</p>
<p>The source Markdown file will be moved to /app/data/done (in future version, it will be deleted).</p>
<p>Image files will not be moved, in case they are required for subsequent PDF creations, e.g.on updating and re-uploading the source Markdown file.</p>
<p>NB : currently source image files might be overwritten by other users of the app uploading a file of the same name but different content. Your document will then be. reated with the wrong image. If so, re-upload them and retry. This issue will be addressed in a future version.</p>
</body>
</html>