Skip to content

GitHub pipeline#1

Merged
kyselejsyrecek merged 2 commits intomasterfrom
gitbook
Aug 29, 2025
Merged

GitHub pipeline#1
kyselejsyrecek merged 2 commits intomasterfrom
gitbook

Conversation

@kyselejsyrecek
Copy link
Copy Markdown
Owner

@kyselejsyrecek kyselejsyrecek commented Aug 29, 2025

Description

Inspired by @siddhpant's solution form 0xAX#837 (https://github.com/siddhpant/linux-insides/releases), it just uses the original gitbook-based solution.

I am quite confident that the pipeline could be improved:

  1. using the built-in YAML API for Docker that GitHub supports (https://docs.github.com/en/actions/how-tos/write-workflows/choose-where-workflows-run/run-jobs-in-a-container),
  2. with migration from gitbook to a maintained solution,
  3. by having the @0xAX's lrx0014/gitbook:3.2.3 Docker image updated (so that it does not have to be modified upon each invocation) and
  4. perhaps refactored somehow to run already in the target Docker container as I believe that what it is doing now is running a Docker container inside an already virtualized pipeline.

Yet, the solution just works now so I would consider these as next steps or nice to have. Would be great still if anyone interested has the time and abilities to do that on their own, as I almost certainly would not find the time for it.

All exported e-book versions of the book are in the A5 format. A PDF in the A4 format is provided too.

Related issues

@kyselejsyrecek kyselejsyrecek force-pushed the gitbook branch 3 times, most recently from ec602af to 30ee35e Compare August 29, 2025 19:57
Lukáš Chmela added 2 commits August 29, 2025 22:04
Apparently, draw.io spoils its SVG 1.1 output images with some HTML tags (invalid within the 1.1 standard). These are then rendered ad black blocks by the svgexport NPM package (required by gitbook to export the book).

These SVGs were re-exported using Inkscape 1.2 to make svgexport happy. They are still somewhat oversized and cropped in the A5 format, though. A CSS rule similar to the following one may be needed in a CSS file at the right location in the repository:

@media print {
    img {
        object-fit: scale-down;
    }
}
@kyselejsyrecek kyselejsyrecek merged commit 77c3a46 into master Aug 29, 2025
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant