#10637: Implement sage -sws2rst
------------------------------------------------------------+---------------
Reporter: nthiery | Owner:
jason, mpatel, was
Type: enhancement | Status:
positive_review
Priority: major | Milestone:
sage-pending
Component: notebook | Resolution:
Keywords: ReST, worksheet | Work issues:
Report Upstream: Workaround found; Bug reported upstream. | Reviewers:
Nicolas M. Thiéry, Jason Grout, Karl-Dieter Crisman, Jason Bandlow, John
Palmieri, Simon King, Karl-Dieter Crisman, Pablo Angulo
Authors: Pablo Angulo, Karl-Dieter Crisman | Merged in:
Dependencies: #14330 | Stopgaps:
------------------------------------------------------------+---------------
Description changed by jdemeyer:
Old description:
> Implement:
>
> {{{
> sage -sws2rst bla.sws bli.sws ...
> }}}
>
> which given worksheets
>
> {{{bla.sws, bli.sws, ...}}} would create ReST files {{{bla.rst, bli.rst,
> ...}}} together with media directories:
>
> {{{
> media/bla/
> media/bla/data/
> media/bla/7/sage0.png
> ...
> media/bli/
> ...
> }}}
>
> The proposed implementation adds a script
> {{{local/bin/sage-sws2rst}}}, edits {{{spkg/bin/sage}}} to add
> the sws2rst option, and add some libraries in
> {{{sagenb-main/sagenb/notebook/}}}. It further depends on the
> !BeautifulSoup Python library (released under Python's license).
>
> The script builds the ReST file from the worksheet.html file included in
> the .sws as follow:
>
> - Preparsing to handle the input / output fields
> - Parsing of the resulting html using !BeautifulSoup
> - Manipulation on the obtained tree
>
> Suggestions for better file layout or implementation welcome!
>
> == Install instructions ==
>
> * Install sagenb 0.10.6 (#14330)
> * Install the beautifulsoup spkg
> [http://sage.math.washington.edu/home/kcrisman/beautifulsoup-3.2.1.spkg
> here].
> * Apply [attachment:trac_10637-root.patch] to the root repository
> * Apply [attachment:trac_10637-scripts.patch] and [attachment:trac_10637
> -scripts-docsandmore.patch] to the scripts repository
>
> == Release Manager Instructions ==
> * Add beautiful soup to the optional spkg directory
> * Apply [attachment:trac_10637-root.patch] to the root repository
> * Apply [attachment:trac_10637-scripts.patch] and [attachment:trac_10637
> -scripts-docsandmore.patch] to the scripts repository
> * Merge at the same time as
> [https://groups.google.com/forum/?fromgroups=#!topic/sage-
> notebook/oHcBEL7_vLA sagenb 0.10.6] (#14330)
New description:
Implement:
{{{
sage -sws2rst bla.sws bli.sws ...
}}}
which given worksheets
{{{bla.sws, bli.sws, ...}}} would create ReST files {{{bla.rst, bli.rst,
...}}} together with media directories:
{{{
media/bla/
media/bla/data/
media/bla/7/sage0.png
...
media/bli/
...
}}}
The proposed implementation adds a script
{{{local/bin/sage-sws2rst}}}, edits {{{spkg/bin/sage}}} to add
the sws2rst option, and add some libraries in
{{{sagenb-main/sagenb/notebook/}}}. It further depends on the
!BeautifulSoup Python library (released under Python's license).
The script builds the ReST file from the worksheet.html file included in
the .sws as follow:
- Preparsing to handle the input / output fields
- Parsing of the resulting html using !BeautifulSoup
- Manipulation on the obtained tree
Suggestions for better file layout or implementation welcome!
== Install instructions ==
* Install sagenb 0.10.6 (#14330)
* Install the beautifulsoup spkg
[http://sage.math.washington.edu/home/kcrisman/beautifulsoup-3.2.1.spkg
here].
* Apply [attachment:trac_10637-root.patch] to the root repository
* Apply [attachment:trac_10637-scripts.patch] and [attachment:trac_10637
-scripts-docsandmore.patch] to the scripts repository
== Release Manager Instructions ==
* Add beautiful soup to the optional spkg directory
* Apply [attachment:trac_10637-root.patch] to the root repository
* Apply [attachment:trac_10637-scripts.patch] and [attachment:trac_10637
-scripts-docsandmore.patch] to the scripts repository
--
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/10637#comment:139>
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 unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.
