Name | Date | Size | #Lines | LOC | ||
---|---|---|---|---|---|---|
.. | 03-May-2022 | - | ||||
sphinx_press_theme/ | H | 03-May-2022 | - | 287 | 204 | |
sphinx_press_theme.egg-info/ | H | 03-May-2022 | - | 86 | 62 | |
PKG-INFO | H A D | 01-Oct-2019 | 2.7 KiB | 86 | 62 | |
README.md | H A D | 01-Oct-2019 | 1.1 KiB | 58 | 35 | |
setup.cfg | H A D | 01-Oct-2019 | 38 | 5 | 3 | |
setup.py | H A D | 01-Oct-2019 | 1.7 KiB | 50 | 47 |
README.md
1A modern responsive theme for python's [Sphinx](http://www.sphinx-doc.org) documentation generator. 2 3See it in action on Press Theme own [website](https://schettino72.github.io/sphinx_press_site/) 4 5 6This theme is based on [VuePress](https://vuepress.vuejs.org/). 7It uses [Vue.js](https://vuejs.org/) & [Stylus](http://stylus-lang.com/) managed by 8[webpack](https://webpack.js.org/) (through [vue-cli](https://cli.vuejs.org/)). 9 10 11**Press** theme is still in **BETA**. 12Contributions are welcome. 13 14## Usage 15 16First install the theme: 17 18``` 19$ pip install sphinx_press_theme 20``` 21 22On Sphinx project's ``conf.py``: set the theme name to ``press``. 23 24``` 25html_theme = "press" 26``` 27 28See details on [Sphinx theming docs](http://www.sphinx-doc.org/en/master/theming.html#using-a-theme). 29 30 31## Development 32 33First build web assets: 34 35``` 36cd ui 37npm run build 38``` 39 40Sphinx theme has a soft link to built assets... 41Install theme locally with `pip install -e .`. 42 43`docs` folder contains theme's own documentantion. 44 45``` 46cd docs 47make clean; make html 48``` 49 50 51## Website 52 53To update website: 54 55cd ../press_site 56rsync -rvi ../sphinx_vuepress_theme/docs/build/html/ . 57git add --all 58