An open API service indexing awesome lists of open source software.

https://github.com/jcook3701/sphinx-cookiecutter

Sphinx cookiecutter project for python3 project documentation.
https://github.com/jcook3701/sphinx-cookiecutter

cookiecutter documentation python3 sphinx

Last synced: about 1 month ago
JSON representation

Sphinx cookiecutter project for python3 project documentation.

Awesome Lists containing this project

README

          

sphinx-cookiecutter

License

Author: Jared Cook

Version: 0.1.0

Overview

sphinx cookiecutter template generation.


CI/CD Check List:


  • dependency-check

  • format-check

  • lint-check

  • security-audit

  • spellcheck

  • tests

  • typecheck


Usage Examples

Example: Pull from main branch.



  1. Pull Project with cookiecutter command:

    $ cookiecutter git@github.com:jcook3701/sphinx-cookiecutter.git  
    

    Example: Pull from develop branch.



  2. Pull code from development branch while testing updates.

    $ cookiecutter git@github.com:jcook3701/sphinx-cookiecutter.git --checkout develop  
    


Advance Examples

Note: The real intention of this project is to call it as a hook within other cookiecutter projects as shown below.

Explanation: ansible-galaxy-cookiecutter template utilizes nutri-matic hooks to pull both this documentation template along with github-docs-cookiecutter template into generated project $(PROJECT_ROOT)/docs/.

Utilization of nutri-matic is the optimal way of integrating this template in projects.


Getting Started

Documentation

The sphinx-cookiecutter documentation is available at docs.

Contributing

If you’re interested in contributing to the sphinx-cookiecutter project:


Authors Notes


  1. This code currently works with cookiecutter (2.6+) from PyPi repositories.


License

Copyright (c) 2025-2026, Jared Cook

This project is licensed under the AGPL-3.0-or-later License.

See the LICENSE file for the full license text.

SPDX-License-Identifier: AGPL-3.0-or-later