🟢 | Docker images for use with docmachine-cli

Find a file

Glenn Y. Rolland 6a2abc6235 feat(docker): modularize Docker setup for docs and slides Introduces distinct Dockerfiles for documentation and slide projects, enhancing modularity and build efficiency. The previous monolithic structure was less flexible and caused longer build times. - Added `DOCMACHINE_DOCS_ENABLE` and `DOCMACHINE_SLIDES_ENABLE` env variables to toggle features. - Created `docker/Dockerfile.docs` for documentation builds, including necessary tools and dependencies. - Created `docker/Dockerfile.slides` for slide builds to streamline setup. - Updated main Dockerfile to include `python-is-python3` for compatibility, removing redundant symlinks. - Enhanced LaTeX tools by adding `texlive-xetex` and extra fonts for improved PDF output.		2025-03-27 10:14:38 +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	chore(makefile): enhance CSS build output readability	2025-03-18 14:30:04 +01:00
docker	feat(docker): modularize Docker setup for docs and slides	2025-03-27 10:14:38 +01:00
docs	style: improve filesystem organization	2021-06-27 23:45:49 +02:00
docs.extra	Add extra JS & CSS	2022-11-18 16:13:28 +01:00
images	Add sample images for .dot and .circo	2021-07-23 16:52:57 +02: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: update Dockerfile dependencies and improve PDF build process	2024-12-12 09:19:29 +01:00
utils/docs	refactor(docs): enhance PDF build process and font settings	2025-03-27 09:59:17 +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	fix: makefile tasks for watch	2024-09-30 18:12:26 +02:00
overlay.sh	feat: add overlay testing script	2024-09-23 00:09:21 +02:00
package-lock.json	fix: switch to recent version of sass	2024-09-22 23:24:30 +02: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

ℹ️ 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

README.md Unescape Escape