mirror of
https://github.com/VitexSoftware/multiflexi-doc-en.git
synced 2026-10-03 21:38:00 +00:00
MultiFlexi English documentation (Sphinx/RST)
https://multiflexi.eu
|
|
||
|---|---|---|
| .github | ||
| _audit | ||
| debian | ||
| gdpr | ||
| source | ||
| .gitignore | ||
| .readthedocs.yaml | ||
| ACTIVATION_WIZARD.md | ||
| DOCUMENTATION_RESTRUCTURING.md | ||
| GDPR_ARTICLE_15_IMPLEMENTATION.md | ||
| Jenkinsfile | ||
| Jenkinsfile.release | ||
| Makefile | ||
| multiflexi-doc.svg | ||
| README.md | ||
| requirements.txt | ||
MultiFlexi Documentation
English documentation for MultiFlexi — a PHP-based task scheduling and automation framework for accounting and business system integrations.
Read online: https://multiflexi.readthedocs.io/en/latest/
Contents
- Getting Started — quickstart, installation, first-run setup
- Core Concepts — system overview, data model, job lifecycle, credential management, execution architecture
- How-To Guides — adding companies, installing applications, creating run templates, scheduling jobs, assigning credentials, debugging
- Integration Guides — AbraFlexi, Pohoda, Zabbix, OpenTelemetry, Ansible, Kubernetes
- Reference — REST API, CLI commands, configuration, application schema, executors, actions
- System Administration — Docker deployment, systemd services, database maintenance, backup, upgrading
- Development — architecture, project structure, application development, testing, contributing
Building Locally
Prerequisites
sudo apt install python3-sphinx python3-shibuya-sphinx-theme
Or with pip:
pip install -r requirements.txt
Build HTML
make html
# Output: build/html/index.html
Build other formats
make epub # EPUB e-book
make latex # LaTeX (requires texlive)
make text # Plain text
Automatic Publishing
Every push to main triggers a rebuild on ReadTheDocs via GitHub Actions.
Debian Package
The documentation is also distributed as a Debian package (multiflexi-doc) that installs the built HTML to /usr/share/doc/multiflexi/html/.
# Build the .deb
dpkg-buildpackage -b --no-sign
# Install
sudo apt install ./multiflexi-doc_*.deb
# Browse at http://localhost/multiflexi-doc/ (requires Apache or Nginx)
Apache configuration is enabled automatically on install.
Nginx snippet is installed to /usr/share/doc/multiflexi/multiflexi-doc.nginx.
Documentation Standards
See AGENTS.md for language, formatting, and content rules that apply to all contributions.
Key rules:
- English only; active voice; second person ("you")
- reStructuredText (
.rst) for all source files - Always specify language in code blocks
- Provide working, copy-paste-ready examples
- Only document released, implemented behaviour
- Cross-check app/credential-type field docs against the canonical JSON schemas
Contributing
- Edit the relevant
.rstfile undersource/ - Build locally and verify:
make html - Commit and push — ReadTheDocs rebuilds automatically
Related Projects
| Project | Description |
|---|---|
| MultiFlexi | Main web application |
| multiflexi-cli | Command-line interface |
| multiflexi-tui | Terminal UI |
| php-vitexsoftware-multiflexi-core | Core PHP library |
| multiflexi-api | REST API server |