#9850: make style of documentation consistent with sagemath.org
-----------------------------+----------------------------------------------
Reporter: niles | Owner: mvngu
Type: defect | Status: new
Priority: major | Milestone:
Component: documentation | Keywords: style
Author: Niles Johnson | Upstream: N/A
Reviewer: | Merged:
Work_issues: |
-----------------------------+----------------------------------------------
Comment(by niles):
Replying to [comment:2 mpatel]:
> Niles, could you later rework the patch to move the changes to
>
> `SAGE_ROOT/devel/sage/doc/common/themes/sage/theme.conf`
I did try this, but I'm afraid it didn't seem to work. I tried both
uncommenting the lines that were already there, such as
{{{
footerbgcolor = #B8B9F6
}}}
and also adding the dict `html_theme_options` from `conf.py`, but neither
of these were recognized . . . in fact, when I change `theme.conf` and try
to rebuild the documentation, I get "all targets are up to date", so maybe
I need to issue a different rebuild command (rather than, e.g. `sage
-docbuild constructions html`).
>
> You can set [http://sphinx.pocoo.org/config.html#confval-pygments_style
pygments_style] to use alternate syntax highlights.
this also doesn't seem to work from `theme.conf`, but does from `conf.py`.
> Here's a list of Pygments' builtin styles:
>
{{{
#!python
sage: from pygments.styles import STYLE_MAP
sage: STYLE_MAP.keys()
['manni', 'colorful', 'murphy', 'autumn', 'bw', 'pastie', 'native',
'perldoc', 'borland', 'trac', 'default', 'fruity', 'vs', 'emacs',
'friendly']
}}}
>
I tried these out, but most of them are worse than the default (which is
not the same as when I set `pygments_style = 'default'`). `manni` comes
the closest to being usable (and better), but the color of sage output is
too-light gray.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/9850#comment:3>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/sage-trac?hl=en.
