My goal is to publish multiple books/manuals inside of an existing Grav site.
- Each book and manual is managed as an independent Github repository and its structure is defined by a project file (json/yaml)
- The books will be multilingual.
Here are the details:
I have create a Grav site:
- The core gets updated through bin/gpm
- The theme is pulled in through webhooks from
- The pages are pulled in from
(the two links above are not clickable, since I’m not allowed to put more than two links in my posts…)
The first book that should published is: https://github.com/aoloe/scribus-book-starting-with.
The basic idea is that a webhook will trigger a pull and update the markdown files that the Grav plugin can then “intelligently” serve as a book.
Has anybody already done something similar? Any hints how I can achieve this?
Here are some more details:
- I’m an experienced PHP programmer.
- The structure of the book can be modified to better suit Grav.
- I don’t wish to use the directory names for the order of the chapters (01.abcd, 02.efgh, …; reordering is too “hard”)
- Putting all chapter’s file in separate directories is possible.
- The content will be translated in multiple languages. (The Grav site will also be translated, but the book might be in more languages than the website).
- Chapter might be missing or be outdated in some languages.
.mdfiles should display correctly (mind the images!) in the web view for the Github repository (but it will be “optimized” for Grav).
- Multiple “chapters” might be rendered in one Grav page.
- The resulting Grav plugin (if any must be created) will be open source.
I don’t mind collaborating with other people and create a solution that can be published in the plugin directory.