Janik von Rotz
323f81a45f
- Replace 11ty static site generator with Zensical (Material for MkDocs)
- Remove Node.js dependencies, `package.json`, `pnpm-lock.yaml`, and `node_modules`
- Refactor directory structure: move docs to `docs/`, assets to `docs/{img, stylesheets, javascripts}`, and build output to `site/`
- Create modular bin scripts for Zensical, 11ty, and Vuepress workflows (init, dev, build, serve)
- Update `.gitignore` to track `.venv` and `site` instead of `node_modules` and `_site`
- Rewrite `README.md` and `AGENTS.md` to reflect new tooling and structure
- Update `task` and `task.template` with new documentation commands and help rows
- Implement `install` and `uninstall` scripts to fetch scripts from remote repository
- Add `zensical.toml` configuration with Material theme, dark mode toggle, and navigation
- Fix shellcheck issues in `task.template` and `save-pass-to-keepass`
- Update `prompt.md` with completion status and worklog
1.6 KiB
1.6 KiB
Taskfile
The standalone Makefile.
The Taskfile is a simple bash script and standardized interface for any software project.
Read the docs at taskfile.build.
Development
The development environment requires these tools:
Setup
Clone this repo and enter the folder:
git clone https://git.taskfile.build "$HOME/taskfile.build"
cd "$HOME/taskfile.build"
Initialize the documentation build dependencies:
task init-zensical-docs
Commands
Run the documentation development server:
task dev-zensical-docs
Build the documentation website:
task build-zensical-docs
Serve the built documentation:
task serve-zensical-docs
Lint the code:
task lint
Run tests:
task run-tests
Build the Docker image:
task build-image
Run the Docker container:
task run-container
Show all available commands:
task help
Specification
The Taskfile is a bash script with a standardized interface. It provides:
- 🛠️ Configuration: Install and configure software and tools with ease.
- 🐳 Docker Build: Build and publish Docker images for your project.
- 🔑 KeePass / Pass: Store and load secrets from KeePass and pass.
- 📄 .env / dotenv: Manage multiple dotenv files for your projects.
- 🔄 CI Pipelines: Simplify CI pipelines by making the executed task reproducible.
- 📚 Library commands: A collection of reusable commands for common scripting tasks.