Contribute to this theme

感谢你有兴趣为 sphinx-book-theme 做出贡献! 你真了不起✨。

本项目遵循 Executable Books Project 贡献指南。它包含了关于我们在编码风格、拉取请求工作流程、提交信息等方面的惯例。

The rest of these sections contain information about developing the sphinx-book-theme specifically.

贡献指南

• Set up your development workflow
  • 设置开发环境
  • Build the documentation
  • Update the theme’s assets (CSS/JS)
  • 当你进行修改时，自动构建文档
  • Run the tests
  • The {example} directive
• Architecture of the repository
  • src/sphinx_book_theme/ - Theme source files
  • docs/ - Site documentation
  • webpack.config.js and package.json - Webpack and dependencies
  • tests/ - Testing infrastructure
  • .github/workflows/ - Continuous Integration and Deployment
  • Parent theme - pydata-sphinx-theme
• Style and design
  • Design principles and inspiration
  • SCSS build process
  • CSS/SCSS naming conventions
  • SCSS folder structure
• Testing infrastructure
  • Run the tests with a single environment
  • List all test environments
  • Supply arguments to pytest
  • Re-build an environment from scratch
  • Test audits with lighthouse
  • Test multiple Sphinx versions
• Translation workflow
  • Structure of translation files
  • Workflow of translations
  • To update a translation
• Creating sub-themes
  • Hashing your assets
  • Defining your own CSS