Dialog Flow Framework Sphinx Theme is a sphinx theme for building DFF distributed website
Project description
Dialog Flow Framework Sphinx Theme
Dialog Flow Framework Sphinx Theme is a sphinx theme for building DFF distributed website
Install project with demo module: make DEMO_BASE_URL="[DEMO_MODULE_BASE_PATH]" demo-build
NB! Requires NodeJS >= 8.4.0 and Python >= 3.7 (compatible with dff).
Analyzed and updated source files (.ts
and .scss
) are marked with following header:
/**
* Final redaction
**/
WARNING! SASS styling is still under way. By the time this inscription is being made, designing (mobile, middle-size) is still in process. After website is finished and all required elements added, we should revisit SASS files once again. We should:
- Restore everything that was useful and for any reason was deleted (regarding not-yet-included Sphinx addons and possibilities).
- Finish styling for website to match design.
- If needed, revisit TypeScript files too, some (most) of them were untouched since PyTorch import, only God knows if (and how) they work.
- Remove everything unused (RTD and PyTorch classes or Sphinx addons we don't need).
- Remove big files (
_sphinx_base.scss
), split them into smaller ones, specifying design for one particular element of website.
I'm sorry to release the theme in this condition. However, I don't have enough time to fix it and most importantly I don't know what website will look like yet, so it's impossible to check if most of the elements work, how they work and if they are needed at all. Dear future programmer of DFF Sphinx theme, please accept my apologies and be strong.
Global TODO:
- Add
format
rules to Makefile - Add testing
- Add docs (maybe insert demo module into docs)
Local TODO:
- Replace
.ts
string concatenation with `-wrapped strings - Add pencil icon (if needed)
_static/pencil-16.png
- Fix button from
sphinx_copybutton
plugin - Finish color replacement with variables in
.scss
files + clean variables - Check jinja nested blocks, flatten
- Fix extra-long function definitions (in documented packages)
- Check top-bar height, adjust logo height if necessary
- Fix TODOs and FIXMEs (multiple)
- Transfer build process to
collect_documentation.py
- Extract
theme_tutorial_name
variable to examples build (sphinx gallery)
NOTES:
- Jupyter Notebooks:
- Use this: https://github.com/ngoldbaum/RunNotebook
- Use Google Colab
- Extra beautiful features:
- Use examples from here: https://pytorch.org/tutorials/
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 dff_sphinx_theme-0.1.21-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e110b11924a724679dcfcdb0b9919602e968a57549e2cec2e7e3ffd608f25c93 |
|
MD5 | f04b9aff150f42fa8f58dcbe1f9e746a |
|
BLAKE2b-256 | 5d606f2186309fd42b77afc012c980c7f9ce487690ff5a17bd4b37c10907974a |