hi-folks / ibis-next Goto Github PK

I would like to explore the opportunity to create and ship a standalone PHP binary on Linux, macOS, FreeBSD using this amazing tool: https://static-php.dev/en/

• split workflows
• execute pint and rector in dry run mode
• execute tests
• launch ibis-next command

Following along with the installation instructions we find we can easily generate a PDF file but epub generation errors out:

./vendor/bin/ibis-next epub
PHP Warning:  Module "curl" is already loaded in Unknown on line 0
PHP Warning:  Module "gd" is already loaded in Unknown on line 0
✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨
✨ EPUB generation is a Working in Progress!! ✨
✨                Stay tuned!!                ✨
✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨
Loading config/assets from: ./
Loading config file from: .//ibis.php
Loading content from: .//content
==> Preparing Export Directory ...
==> Parsing Markdown ...
==> Adding Book Cover .//assets/cover-ibis.webp ...
PHP Fatal error:  Uncaught Error: Class "DOMDocument" not found in /home/johnb/Desktop/my-first-ebook/vendor/hi-folks/phpepub/src/PHPePub/Core/EPub.php:397
Stack trace:
#0 /home/johnb/Desktop/my-first-ebook/vendor/hi-folks/phpepub/src/PHPePub/Core/EPub.php(420): PHPePub\Core\EPub->findIdAttributes()
#1 /home/johnb/Desktop/my-first-ebook/vendor/hi-folks/phpepub/src/PHPePub/Core/EPub.php(1424): PHPePub\Core\EPub->extractIdAttributes()
#2 /home/johnb/Desktop/my-first-ebook/vendor/hi-folks/phpepub/src/PHPePub/Core/EPub.php(1380): PHPePub\Core\EPub->addReferencePage()
#3 /home/johnb/Desktop/my-first-ebook/vendor/hi-folks/ibis-next/src/Commands/BuildEpubCommand.php(140): PHPePub\Core\EPub->setCoverImage()
#4 /home/johnb/Desktop/my-first-ebook/vendor/hi-folks/ibis-next/src/Commands/BuildEpubCommand.php(70): Ibis\Commands\BuildEpubCommand->buildEpub()
#5 /home/johnb/Desktop/my-first-ebook/vendor/symfony/console/Command/Command.php(326): Ibis\Commands\BuildEpubCommand->execute()
#6 /home/johnb/Desktop/my-first-ebook/vendor/symfony/console/Application.php(1078): Symfony\Component\Console\Command\Command->run()
#7 /home/johnb/Desktop/my-first-ebook/vendor/symfony/console/Application.php(324): Symfony\Component\Console\Application->doRunCommand()
#8 /home/johnb/Desktop/my-first-ebook/vendor/symfony/console/Application.php(175): Symfony\Component\Console\Application->doRun()
#9 /home/johnb/Desktop/my-first-ebook/vendor/hi-folks/ibis-next/ibis-next(31): Symfony\Component\Console\Application->run()
#10 /home/johnb/Desktop/my-first-ebook/vendor/bin/ibis-next(117): include('...')
#11 {main}
  thrown in /home/johnb/Desktop/my-first-ebook/vendor/hi-folks/phpepub/src/PHPePub/Core/EPub.php on line 397

The message does say that epub generation is a work in progress so perhaps I'm being impatient ??

Supporting Aside (or admonitions or callouts) in the markdown.
Asides (also known as “admonitions” or “callouts”) are useful for displaying secondary information alongside a page’s main content.
Provide a custom Markdown syntax for rendering asides. Aside blocks are indicated using a pair of triple colons ::: to wrap your content, and can be of type note, tip, caution or danger.

• Astro Starlight : https://starlight.astro.build/guides/authoring-content/#asides
• Vuepress : https://vuepress.vuejs.org/guide/markdown.html#custom-containers

Example:

:::note
This is a note
:::

Adding an option for build and epub command for allowing the user to define a content directory. By default, the content/ directory in the current directory is used as content directory where to load the markdown files.

Adding the support for creating Microsoft Office Open XML (OOXML or OpenXML), OASIS Open Document Format for Office Applications (OpenDocument or ODF), Rich Text Format (RTF) via https://github.com/PHPOffice/PHPWord

Add the -d option to the init command in order to set a different directory.
This is helpful for example if you want to install Ibis Next once and you want to create and manage multiple books.

The init command initialize the book folder with assets and content, with an example of a small book. Creating the stub content with the instructions for using Ibis Next could be useful.
So, the content creators who want to start using the tool to create the book can have an example book as a boilerplate.
The sample book about Ibis Next can have:

• a cover png image
• a chapter about what Ibis Next is
• a chapter about installation (with requirements)
• a chapter about configuration (explaining all the ibis.php parameters)
• a chapter about how to write the content
• a chapter about how to build PDF and EPUB

Creating a command for exporting in EPUB format

ibis-next epub

So I was building a very large PDF file with over 5,000 pages. Before ibis-next finished building it an error occurred:

✨✨ 5870 PDF pages ✨✨

In Mpdf.php line 27072:

The HTML code size is larger than pcre.backtrack_limit 1000000. You should use WriteHTML() with smaller string lengths. Pass your HTML in smaller chunks.

pdf [-c|--content [CONTENT]] [-d|--workingdir [WORKINGDIR]] [--] [<theme>]

The fix is to edit /etc/php/8.1/cli/php.ini and find the line where pcre.backtrack_limit is defined. It's commented out. Remove the leading semicolon and change the value to 5000000.