I can't say I am experienced user myself, but I wanted even a bit more, as
in bootstrap variant (CSS parts) that was
used under Read the Docs (sphinx-bootstrap-theme to be found under various
places). Issues I had found:
- folding under dynamic use, as on large monitor, was a bit quirky
- Tables would never be wrapped on content. Awful reading, multiline
content I wanted to enable for larger displays.
- I wanted more ability to play around with sizes and things like colour of
header bar or such. In my line of
work (chip design/inventions) handy to distinguish between ideas,
functional model, math modeling, embedded software, GUI, etc etc.
Tested quite a few things but to not much avail.
Finally I ended up doing the following:
- I got the various source files from github or somesuch
- read instructions for compiling from the sources. This work centered
around the different layers making up the structure of CSS. For
sphinx bootstrap these are especially wyrm, which give the base classes
for adaptive sizing, with the settings called in the actual top
structure files, the actual theme files. Other stuff like the fonts
not touching and only
- Mind: there was a lot of experimenting going on with versioning of the
various components. It was not hell but very supple it was not either.
Anyhow: the real source files for that variant was made with sass files.
Sass is the predecessor of current scss, but having a workable flow without
all was more of interest to me than rewriting all to get SCSS sources.
Maybe I should consider doing that after all, but for the moment one step
page in such
a way that your aims are achieved. Definitions you then put in the sass
files and you simply recompile: your css will be updated then to cover your
I myself figured out where the various parts were set (mostly in a file
like wyrm/sass/wyrm_core/_table.sass) and made them appropriate to my ends,
being much more often aimed at non-mobile than current bootstrap theme
(mobile only). That was pretty soon working like a dream, and I am now even
considering to develop a look like Tofte (sidebar left and right, with
right bar usable for small figures and side notes). But that would take
sphinx extensions. That is in itself not very complex, but again time
I have not published my stuff as my tooling is awfully structured (read:
just erroneous) as I was clueless when I started. Had to use grunt and ran
into version issues pretty soon.
Maybe a nice cleanup very feasible, but again takes time...
elements like these works most structured with sass or scss. Getting it all
work together only really okay
with existing sources, which you may still want to choose as classic style.
I have not looked for you where to find sources for that style, but quite
likely not very different
One thing I decided: to not make my left sidebar very dynamic: it only
folds for very small displays into a top menu entry. It contains under RTD
the contents and is for me too much
a navigation thing to allow dynamic resizing. Troublesome parts are for
instance that the contents indent/wrap combo then also needs covering, and
that would probably mean all hell breaks loose :-(
Can help you of course further with rtd variants, in as far as I have
Post by Ranjani Hathaway
I am relatively new to Sphinx, and I am trying to create some
documentation- and one of the things I needed to do was widen the sidebar.
I am using the Classic theme, and I am currently specifying 'sidebarwidth'
in my html_theme_options to widen it from the default 230 px.
I have it look the way I like when the browser window is maximized, but as
I shrink and resize the page, the sidebar does not shrink accordingly, and
it ends up looking out of proportion. Is there a way to define the width to
be a certain percentage of the page, so that it keeps the proportion even
when the window resizes?
As of right now, as far as I know, I can only specify the width in
absolute pixel width.
Thanks in advance!
You received this message because you are subscribed to the Google Groups "sphinx-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to email@example.com.
For more options, visit https://groups.google.com/d/optout.