publish is a consolidated repository designed to streamline and enhance the Sphinx documentation framework.

This project integrates custom components, themes, and configurations into a unified system, making it easier to manage Sphinx projects. It supports project-specific settings, conversion of Grav themes into Jinja templates, and extends Ablog to support diverse content types.

• Unified Theme: A single, customizable theme for all PHOTON platform documentation, ensuring a consistent and professional look.
• Custom Components: Reusable Sphinx components, such as custom directives and roles, to simplify content creation.
• Centralized Configuration: A global conf.py that can be imported into local configurations, reducing boilerplate and ensuring consistency.
• Grav Theme Conversion: Tools to convert Grav themes into Jinja templates compatible with Sphinx.
• Extended Ablog Support: Enhanced Ablog functionality to support different content types, such as events, tasks, and updates.
• Streamlined Project Integration: Provides a structured approach for integrating publish into existing and new Sphinx projects, ensuring consistency and efficiency in documentation deployment.
• Enhanced Article Navigation: Styled article navigation buttons for improved prominence and theme consistency.

You can install publish using pip:

pip install photon-platform-publish

After installation, you can use the publish command to manage your documentation projects:

publish build  # build the documentation for a project
publish test  # build and serve the documentation locally

publish depends on the following Python packages:

• Sphinx
• Ablog
• click
• libsass

Contributions are welcome! Please see our [GitHub issues](https://github.com/photon-platform/publish/issues) for ways to contribute.

publish is licensed under the MIT License. See the LICENSE file for more details.