#10637: Implement sage -sws2rst
-------------------------------------------------------+--------------------
       Reporter:  nthiery                              |         Owner:  jason, 
mpatel, was                                             
           Type:  enhancement                          |        Status:  
needs_work                                                     
       Priority:  major                                |     Milestone:  
sage-5.1                                                       
      Component:  notebook                             |    Resolution:         
                                                        
       Keywords:  ReST, worksheet                      |   Work issues:         
                                                        
Report Upstream:  Reported upstream. No feedback yet.  |     Reviewers:  
Nicolas ThiƩry, Jason Grout, Karl-Dieter Crisman, Jason Bandlow
        Authors:  Pablo Angulo                         |     Merged in:         
                                                        
   Dependencies:  #11080                               |      Stopgaps:         
                                                        
-------------------------------------------------------+--------------------

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 {{{local/bin/sage-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!
>
> Edit:
> == Install instructions ==
>
>  * Install the beautifulsoup spkg
>
>  * A first patch (add_sws2rst_4.patch) adds the sage-sws2rst script, and
> it must be imported on the local/bin dir
>
>  * A second patch (tools_sws2rst_4.patch) sends three files to
> sagenb/misc and it must be imported on the devel/sagenb dir, and followed
> by a
>
> {{{
>     sage -python setup.py install && sage -python setup.py develop
> }}}

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 {{{local/bin/sage-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!

 Edit:
 == Install instructions ==

  * Install the beautifulsoup spkg
 [http://sage.math.washington.edu/home/kcrisman/beautifulsoup-3.2.1.spkg
 here]

  * A first patch (add_sws2rst_4.patch) adds the sage-sws2rst script, and
 it must be imported on the local/bin dir

  * A second patch (tools_sws2rst_4.patch) sends three files to sagenb/misc
 and it must be imported on the devel/sagenb dir, and followed by a

 {{{
     sage -python setup.py install && sage -python setup.py develop
 }}}

--

Comment (by kcrisman):

 New Beautiful Soup spkg at
 [http://sage.math.washington.edu/home/kcrisman/beautifulsoup-3.2.1.spkg]
 this location.  I'm going with the maintenance release for now because I
 don't want to have to think about licenses.

 I'll try to figure out what to do with the other stuff soon; shouldn't be
 hard, but I always have trouble with the new notebook upstream business...

-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/10637#comment:34>
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.

Reply via email to