#9850: make style of documentation consistent with sagemath.org
------------------------------------------------------------+---------------
Reporter: niles | Owner:
mvngu
Type: defect | Status:
needs_review
Priority: major | Milestone:
sage-4.6
Component: documentation | Keywords:
style
Author: Niles Johnson | Upstream: N/A
Reviewer: Mitesh Patel, John Palmieri, Minh Van Nguyen | Merged:
Work_issues: |
------------------------------------------------------------+---------------
Changes (by mvngu):
* status: new => needs_review
* reviewer: => Mitesh Patel, John Palmieri, Minh Van Nguyen
* milestone: => sage-4.6
Old description:
> This was proposed in the following thread at `sage-devel`:
>
> http://groups.google.com/group/sage-
> devel/browse_thread/thread/73e3c4c995577df0
>
> and a few people voiced support, so a patch will be attached.
New description:
This was proposed in the following thread at `sage-devel`:
http://groups.google.com/group/sage-
devel/browse_thread/thread/73e3c4c995577df0
and a few people voiced support, so a patch will be attached.
'''Apply:'''
1. [attachment:trac_9850_doc_style.patch]
1. [attachment:trac_9850-reviewer.patch]
--
Comment:
When (re)building documentation, I would first delete the whole output
directory and then proceed with the (re)building:
{{{
#!sh
$ cd SAGE_ROOT
$ rm -rf devel/sage-main/doc/output/
$ ./sage -docbuild --no-pdf-links all html 2>&1 | tee -a dochtml.log
}}}
This guarantees that the documentation I'm interested in (re)building
would build, regardless of whether I have made any changes. In niles' case
where changes were observed to not take place, I find the approach above
worked for me. With that in mind, I have attached a reviewer patch with
the following changes:
* Use a very pale yellow for the code background colour.
* Annotate most of the hex colour code with descriptive English names.
All names were taken from [http://www.perbang.dk this site].
See the attachment [attachment:reviewer-style.png] for a preview of the
new colour for the code background. I'm OK with niles' patch. What we need
now is for someone other than me to look over my changes.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/9850#comment:6>
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.
