glenux/docmachine-containers
glenux/docmachine-containers
1
0
Fork 0
Code Issues Pull requests Projects1 Releases Packages Wiki Activity
🟢 | Docker images for use with docmachine-cli
256 commits 5 branches 0 tags 1.1 MiB
Makefile 32.1%
Ruby 18.1%
SCSS 17.4%
Python 17%
Dockerfile 4.5%
Other 10.9%
Find a file
Glenn Y. Rolland c2893c30a6 refactor(docker, utils): streamline Dockerfile and update PDF build script 
This change removes unnecessary dependencies and optimizes the PDF build
process, enhancing maintainability and reducing potential errors.

- Removed `python3-pypandoc` from Dockerfile to minimize dependency
  footprint.
- Replaced `texlive-xetex` with `texlive` in Dockerfile for broader TeX
  support.
- Introduced `subprocess` in `build_pdf.py` to replace `pypandoc`,
  improving process control.
- Added `run_process_with_params` function to handle command execution,
  increasing code modularity and error handling.
- Created `build_pdf.old.py` as a backup of the original script for
  reference.

Signed-off-by: Glenn Y. Rolland <glenux@glenux.net>
2025-03-27 15:23:11 +01:00
.github/workflows ci: fix command in test job 2021-12-21 17:26:22 +01:00
.makefiles@d5627404e1 Update .makefiles 2021-07-23 16:16:58 +02:00
.marp style(theme): Enhance section styling and comment out unused variables 2025-03-27 10:29:11 +01:00
docker refactor(docker, utils): streamline Dockerfile and update PDF build script 2025-03-27 15:23:11 +01:00
docs style: improve filesystem organization 2021-06-27 23:45:49 +02:00
docs.assets refactor(docs): reorganize assets and update styling 2025-03-27 10:16:07 +01:00
images refactor(docs): reorganize assets and update styling 2025-03-27 10:16:07 +01:00
scripts chore: Remove script/docmachine* scripts now we have real tools 2023-04-06 20:22:22 +02:00
slides Add support for mdpp slides 2021-07-23 16:15:53 +02:00
tasks chore(slides): add commented theme-set option in watch-slides-internal 2025-03-27 10:17:18 +01:00
utils/docs refactor(docker, utils): streamline Dockerfile and update PDF build script 2025-03-27 15:23:11 +01:00
.dockerignore fix: ignore md files in docs/ and slides/ 2024-09-22 23:43:32 +02:00
.drone.yml ci: remove useless build step 2023-01-16 12:18:02 +01:00
.gitignore chore: update Dockerfile dependencies and improve PDF build process 2024-12-12 09:19:29 +01:00
.gitmodules Add dependency to makefiles-forever 2021-07-23 15:51:26 +02:00
caddy.conf Merge branch 'master' of code.apps.glenux.net:glenux/docmachine-containers 2024-06-11 22:29:31 +02:00
docker-compose.yml feat(docker): modularize Docker setup for docs and slides 2025-03-27 10:14:38 +01:00
Makefile fix(Makefile): resolve recursive variable expansion issues 2025-03-18 14:19:53 +01:00
mkdocs-source.yml refactor(docs): reorganize assets and update styling 2025-03-27 10:16:07 +01:00
overlay.sh feat: add overlay testing script 2024-09-23 00:09:21 +02:00
package-lock.json chore(dependencies): update caniuse-lite to latest version 2025-03-27 10:16:44 +01:00
package.json fix: switch to recent version of sass 2024-09-22 23:24:30 +02:00
Pipfile Bump debian and python versions 2024-02-01 14:12:24 +01:00
Pipfile.lock fix: bump versions in pipfile 2024-09-22 23:43:02 +02:00
Procfile refactor: move tasks in subfiles 2024-09-22 23:42:26 +02:00
README.md Update README.md 2024-06-02 07:11:52 +00:00

README.md

Build Status License LGPL3.0-or-later Donate on patreon

ℹ️ This project is available on our self-hosted server and on CodeBerg and GitHub as mirrors. For the latest updates and comprehensive version of our project, please visit our primary repository at: https://code.apps.glenux.net/glenux/docmachine-containers.

DocMachine Containers

Prerequisites

Make sure you have Docker installed.

Writing content

Create your directory tree

.           # project directory
|- docs     # where website documents go
|  `- *.md
|- slides   # where presentation documents go
|  `- *.md
|- images/  # where images go
|- ...

Content for docs

FIXME: tree structure

FIXME: autoslide feature

Content for slides

FIXME: tree structure

Watch mode

This mode allows you the result on-the-fly as you makea changes in the content.

To use watch mode, type:

docmachine -a watch

To use watch mode for slides only type:

docmachine -a watch-slides

To use watch mode for docs only type:

docmachine -a watch-docs

Build mode

This mode builds final content for delivery (website, PDF files)

Building HTML

To use build mode:

docmachine build

Building PDF