How-To Guides

How-To Guides#

Goal-oriented recipes for common tasks. Each guide answers a specific “how do I…” question.

Install plone.meta

Clone the repository and install plone.meta into a virtual environment.

Install plone.meta
Customize via .meta.toml

Add custom configuration for flake8, tox, pyproject.toml, pre-commit, and more without editing generated files.

Customize via .meta.toml
Configure GitHub Actions

Set up CI jobs, Python version matrices, OS dependencies, and environment variables for GitHub-hosted repositories.

Configure GitHub Actions
Configure GitLab CI

Set up CI pipelines for GitLab-hosted repositories, including custom Docker images and OS dependencies.

Configure GitLab CI
Re-enable GitHub Actions

Re-enable GitHub Actions workflows that were auto-disabled due to repository inactivity.

Re-enable GitHub Actions
Use a Custom Branch Name

Control the git branch name created by config-package, or update the current branch.

Use a Custom Branch Name
Write Custom Templates

Create a custom configuration type with your own Jinja2 templates when extra_lines is not enough.

Write Custom Templates