sphinx-design
A sphinx extension for designing beautiful, view size responsive web components.
Created with inspiration from Bootstrap (v5), Material Design and Material-UI design frameworks.
Usage
Simply pip install sphinx-design and add the extension to your conf.py:
extensions = ["sphinx_design"]
Supported browsers
- Chrome >= 60
- Firefox >= 60
- Firefox ESR
- iOS >= 12
- Safari >= 12
- Explorer >= 12
(Mirrors: https://github.com/twbs/bootstrap/blob/v5.0.2/.browserslistrc)
Theme support
View the documentation in multiple themes:
Comparison to sphinx-panels
This package is an iteration on sphinx-panels and intends to replace it. See Migrating from sphinx-panels for more information.
Development
It is recommended to use tox to run the tests and document builds.
Run tox -va to see all the available tox environments.
To run linting, formatting and SASS compilation, use pre-commit.
pre-commit run --all css will run the SASS compiler, for which you will need node and npm installed,
or you can directly run npm run css.
TODO
- note design goal; to be flexible, but limit the amount of directive nesting required.
This factors in to
- card header/footer syntax? (don't really want to have to use separate directives for these, hence
^^^/+++syntax) - auto-wrap
grid-itemandtab-item, if not already insidegridortab-set?
- card header/footer syntax? (don't really want to have to use separate directives for these, hence
grids items cannot contain headers; is this in anyway possible with docutils structure?
naming of directives/roles: standard prefix?
why are cards setup with "word-wrap: break-word;"?
handle latex
Use autoprefixer when compiling SASS (see https://getbootstrap.com/docs/5.0/getting-started/browsers-devices/#supported-browsers)
horizontal card (grid row inside card, picture on left)
subtitle for card (see https://material.io/components/cards#anatomy)
1 maintainer
Release files for sphinx_design 0.7.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sphinx_design-0.7.0.tar.gz | 2.2 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sphinx_design-0.7.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.4 MB
Release files / sphinx_design-0.7.0.tar.gz
| Download URL | sphinx_design-0.7.0.tar.gz |
|---|---|
| Size | 2.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d2a3f5b19c24b916adb52f97c5f00efab4009ca337812001109084a740ec9b7a
|
|
BLAKE2b-256 checksum How to use checksums |
137b804f311da4663a4aecc6cf7abd83443f3d4ded970826d0c958edc77d4527
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.32.5
|
Release files / sphinx_design-0.7.0-py3-none-any.whl
| Download URL | sphinx_design-0.7.0-py3-none-any.whl |
|---|---|
| Size | 2.2 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f82bf179951d58f55dca78ab3706aeafa496b741a91b1911d371441127d64282
|
|
BLAKE2b-256 checksum How to use checksums |
30cf45dd359f6ca0c3762ce0490f681da242f0530c49c81050c035c016bfdd3a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.32.5
|
