A sphinx extension for designing beautiful, view size responsive web components.
Project description
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-item
andtab-item
, if not already insidegrid
ortab-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)
rtd PRs not working
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for sphinx_design-0.4.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 23bf5705eb31296d4451f68b0222a698a8a84396ffe8378dfd9319ba7ab8efd9 |
|
MD5 | e3e23282cabcd60ed9739ba9b6a983f0 |
|
BLAKE2b-256 | c28a7538087272110d010cd27024c392dca176315ad7dfc3f3df3f99798cc21b |