{"id":14156461,"url":"https://github.com/traefik/mixtus","last_synced_at":"2025-05-07T05:48:05.530Z","repository":{"id":43062294,"uuid":"285302362","full_name":"traefik/mixtus","owner":"traefik","description":"🤖 [Lasius Mixtus 🐜] Bot: Publish Documentation to a GitHub Repository from another","archived":false,"fork":false,"pushed_at":"2023-04-04T09:20:06.000Z","size":40,"stargazers_count":5,"open_issues_count":0,"forks_count":5,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-19T19:05:20.677Z","etag":null,"topics":["documentation-tool","github-bot"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/traefik.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-08-05T13:52:25.000Z","updated_at":"2025-01-10T00:23:37.000Z","dependencies_parsed_at":"2024-01-14T04:54:29.607Z","dependency_job_id":"441edba3-00bd-44ce-ac04-575c2b94454b","html_url":"https://github.com/traefik/mixtus","commit_stats":{"total_commits":37,"total_committers":5,"mean_commits":7.4,"dds":"0.32432432432432434","last_synced_commit":"3eade9199ede8c01bb069eb621e47778c4b16e5f"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/traefik%2Fmixtus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/traefik%2Fmixtus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/traefik%2Fmixtus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/traefik%2Fmixtus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/traefik","download_url":"https://codeload.github.com/traefik/mixtus/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252823687,"owners_count":21809708,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["documentation-tool","github-bot"],"created_at":"2024-08-17T08:05:29.975Z","updated_at":"2025-05-07T05:48:05.509Z","avatar_url":"https://github.com/traefik.png","language":"Go","funding_links":[],"categories":["others"],"sub_categories":[],"readme":"# Lasius Mixtus - Publish Documentation to a GitHub Repository From Another\n\n[![GitHub release](https://img.shields.io/github/release/traefik/mixtus.svg)](https://github.com/traefik/mixtus/releases/latest)\n[![Build Status](https://github.com/traefik/mixtus/workflows/Main/badge.svg?branch=master)](https://github.com/traefik/mixtus/actions)\n[![Docker Build Status](https://img.shields.io/docker/cloud/build/traefik/mixtus.svg)](https://hub.docker.com/r/traefik/mixtus/builds/)\n\n## Description\n\nLasius Mixtus is a cross-ci tool (GitHub Actions, SemaphoreCI 1 and 2, TravisCI, ...) used to aggregate documentation from different projects into one repository.\n\nIt is useful for building an aggregated documentation from different sources.\n\nIt creates PRs instead of commits to avoid conflicts and be able to validate the whole documentation before the merge.\n\n```yml\nLasius Mixtus\n\nFlags:\n  -debug\n        Debug mode\n  -dst-doc-path string\n        Path to put the documentation. (default \"./traefik\")\n  -dst-owner string\n        Owner of the targeted doc repo. (default \"traefik\")\n  -dst-repo-name string\n        Name of the targeted doc repo. (default \"doc\")\n  -git-user-email string\n        Email used to commit the documentation. [GIT_USER_EMAIL]\n  -git-user-name string\n        UserName used to commit the documentation. [GIT_USER_NAME]\n  -h    Show this help.\n  -src-doc-path string\n        Path to the documentation. (default \"./docs/site\")\n  -src-owner string\n        Owner of the source repository. (default \"traefik\")\n  -src-repo-name string\n        Name of the source repo. (default \"traefik\")\n  -token string\n        GitHub Token [GITHUB_TOKEN]\n```\n\n## Workflow Example\n\n![mixtus-workflow](https://user-images.githubusercontent.com/5674651/110240947-993cb000-7f4e-11eb-9b23-ce429cfdebf1.png)\n\nThis workflow also uses:\n\n- [structor](https://github.com/traefik/structor): creates multiple versions of a Mkdocs documentation \n- [seo-doc](https://github.com/traefik/seo-doc): enrich HTML files with pre-requisites for improving SEO\n- [mixtus](https://github.com/traefik/mixtus): creates PRs with documentation changes\n- [lobicornis](https://github.com/traefik/lobicornis): rebases and merges PRs automatically\n\nThe result is here: https://doc.traefik.io/\n\n## Examples\n\n```bash\nGITHUB_TOKEN=xxx ./mixtus \\\n--src-owner=containous \\\n--src-repo-name=traefik \\\n--src-doc-path=\"./docs/site/\" \\\n--dst-repo-name=doc \\\n--dst-doc-path=\"./traefik\" \\\n--git-user-name=botname \\\n--git-user-email=bot@example.com\n```\n\n## The Mymirca colony\n\n- [Myrmica Lobicornis](https://github.com/traefik/lobicornis) 🐜: Update and merge pull requests.\n- [Myrmica Aloba](https://github.com/traefik/aloba) 🐜: Add labels and milestone on pull requests and issues.\n- [Messor Structor](https://github.com/traefik/structor) 🐜: Manage multiple documentation versions with Mkdocs.\n- [Lasius Mixtus](https://github.com/traefik/mixtus) 🐜: Publish documentation to a GitHub repository from another.\n- [Myrmica Bibikoffi](https://github.com/traefik/bibikoffi) 🐜: Closes stale issues\n- [Chalepoxenus Kutteri](https://github.com/traefik/kutteri) 🐜: Track a GitHub repository and publish on Slack.\n- [Myrmica Gallienii](https://github.com/traefik/gallienii) 🐜: Keep Forks Synchronized\n\n## What does Lasius Mixtus mean?\n\n![Lasius Mixtus](https://antwiki.org/wiki/images/0/00/Lasius_mixtus_casent0172710_head_1.jpg)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftraefik%2Fmixtus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftraefik%2Fmixtus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftraefik%2Fmixtus/lists"}