{"id":25404866,"url":"https://github.com/mistercalvin/mkdocs-plex-guide-template","last_synced_at":"2026-04-26T23:31:02.939Z","repository":{"id":277773599,"uuid":"933424226","full_name":"MisterCalvin/mkdocs-plex-guide-template","owner":"MisterCalvin","description":"A customizable Plex documentation template built with Material for MkDocs. Automatically deploys to GitHub Pages and includes pre-built guides for common Plex topics like streaming quality, content requests, and troubleshooting.","archived":false,"fork":false,"pushed_at":"2025-02-16T02:08:35.000Z","size":4838,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-16T02:23:45.148Z","etag":null,"topics":["mkdocs","plex-documentation","plex-guide","plex-server"],"latest_commit_sha":null,"homepage":"https://mistercalvin.github.io/mkdocs-plex-guide-template/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MisterCalvin.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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-15T23:08:55.000Z","updated_at":"2025-02-16T02:12:32.000Z","dependencies_parsed_at":"2025-02-16T02:23:50.452Z","dependency_job_id":"3f8931a9-3d5c-48c3-b9b2-be23f613fb57","html_url":"https://github.com/MisterCalvin/mkdocs-plex-guide-template","commit_stats":null,"previous_names":["mistercalvin/mkdocs-plex-guide-template"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MisterCalvin%2Fmkdocs-plex-guide-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MisterCalvin%2Fmkdocs-plex-guide-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MisterCalvin%2Fmkdocs-plex-guide-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MisterCalvin%2Fmkdocs-plex-guide-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MisterCalvin","download_url":"https://codeload.github.com/MisterCalvin/mkdocs-plex-guide-template/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248622170,"owners_count":21134988,"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":["mkdocs","plex-documentation","plex-guide","plex-server"],"created_at":"2025-02-16T04:24:56.077Z","updated_at":"2026-04-26T23:31:02.879Z","avatar_url":"https://github.com/MisterCalvin.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Plex Documentation Guide\n\n[![Build and Deploy MkDocs Site](https://github.com/MisterCalvin/mkdocs-plex-guide-template/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/MisterCalvin/mkdocs-plex-guide-template/actions/workflows/ci.yml)\n\nA standardized documentation template for your Plex server, built with Material for MkDocs and deployed via GitHub Pages. This template includes pre-built pages covering common Plex topics like streaming quality, content requests, transcoding, and more.\n\n## ✨ Features\n- 📚 Pre-built pages for common Plex topics\n- 🔄 Automatic deployment via GitHub Actions\n- 🎨 Material for MkDocs theme with custom styling\n- 🔧 Easy configuration through environment variables\n\n## 🚀 Getting Started\n\u003e [!IMPORTANT]\n\u003e Complete all steps below to ensure your site deploys correctly. Missing any step will cause the deployment to fail.\n\n1. Fork this repository to your own GitHub account\n\n2. Enable GitHub Pages:\n   * Go to [Settings \u003e Pages](../../settings/pages)\n   * Under \"Build and deployment\", change Source to \"GitHub Actions\"\n   * Wait for the blue success message \"GitHub Pages source saved\"\n\n3. Enable GitHub Actions:\n   * Go to [Actions tab](../../actions)\n   * Click \"I understand my workflows, go ahead and enable them\"\n\n4. Run the workflow:\n   * Option 1: Modify and push a change (e.g., customize variables in [main.py](main.py))\n   * Option 2: Manually trigger the workflow\n     * Go to [Build and Deploy MkDocs Site](../../actions/workflows/ci.yml) in the Actions tab\n     * Click \"Run workflow\" dropdown button\n     * Select branch (main) and click \"Run workflow\"\n\nYour site will be available at `https://yourusername.github.io/mkdocs-plex-guide-template` after the workflow completes.\n\nThe template will automatically use your GitHub username and repository name throughout the site. You can see this in action at my demo site: https://mistercalvin.github.io/mkdocs-plex-guide-template\n\n## 📝 Customization\n\n### Basic Configuration\nThe following values are automatically set via environment variables in [`ci.yml`](.github/workflows/ci.yml) and used in the header + footer of your MKDocs site:\n- `username` - Your GitHub username (lowercase)\n- `repo_name` - Repository name\n- `year` - Current year\n\n# Required Variables and Default Values\n\n\u003e [!NOTE]\n\u003e If you want to use GitHub environment variables (like having different URLs for staging/production), you'll need to define them in your repository's [Settings \u003e Security \u003e Secrets and variables \u003e Actions \u003e Variables](../../settings/variables/actions). Use the `!ENV` syntax in `mkdocs.yml` to reference these variables. If you don't need this functionality, you can use plaintext values directly.\n\nVariables are defined in the `extra:` section of [`mkdocs.yml`](mkdocs.yml#L126) and can be used throughout your markdown pages. For repository variables like `username` and `repo_name`, we use GitHub's built-in environment variables. For custom variables, we use plaintext values:\n\n```yaml\nextra:\n  vars:\n    # GitHub environment variables\n    username: !ENV GITHUB_REPOSITORY_OWNER\n    repo_name: !ENV GITHUB_REPOSITORY\n    # Custom plaintext values\n    request_url: \"request.example.com\"\n    plex_url: \"plex.example.com\"\n    plex_libraries: \"Movies and TV Shows\"\n    noreply_email: \"noreply@example.com\"\n```\n\nYou can reference these variables in your markdown files using the syntax `{{ vars.variable_name }}`.\n\n### Content Customization\nKey files to modify:\n- `docs/*.md` - Documentation pages\n- `docs/stylesheets/extra.css` - [Custom admonitions](https://squidfunk.github.io/mkdocs-material/reference/admonitions/#custom-admonitions)\n- `docs/assets/` - Images and video\n\n## 🔧 Troubleshooting\n\nIf your deployment fails, check:\n1. [GitHub Pages](../../settings/pages) is enabled and set to \"GitHub Actions\" as the source\n2. [GitHub Actions](../../actions) is enabled for your repository\n\n## 📚 Resources\n\n### Documentation / Plugins\n- [Material for MkDocs - Getting started](https://squidfunk.github.io/mkdocs-material/getting-started/)\n- [MkDocs Plugins Catalog](https://github.com/mkdocs/catalog)\n- [MKDocs Password Encryption Plugin](https://github.com/unverbuggt/mkdocs-encryptcontent-plugin)\n\n### Video Tutorials\n- [Creating Documentation with MkDocs Material Theme](https://www.youtube.com/watch?v=Q-YA_dA8C20) - James Willett\n- [Hosting MkDocs on Cloudflare Pages](https://www.youtube.com/watch?v=7-HhLascLuM) - Techdox\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmistercalvin%2Fmkdocs-plex-guide-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmistercalvin%2Fmkdocs-plex-guide-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmistercalvin%2Fmkdocs-plex-guide-template/lists"}