On 04/21/2014 09:12 PM, Bill Page wrote:
>> The documentation especially the ++ stuff should be readable also
>> in plain text form. So it's more for the ++ stuff that I want to go
>> reStructuredText+Sphinx.
>
> Do you mean changing the source code in .spad files, i.e. no longer
> use a subset of LaTeX?
Yes.
> Do you find their contents difficult to read?
> Can you give an example?
I cannot give an example. The problem rather is: What *is* this subset
of LaTeX? Do you think you are allowed to use
\begin{table}...\end{table} or \begin{pmatrix}...\end{pmatrix}? Where is
the specification of what is allowed?
Switching to reStructuredText would at least fix that and it would be
certainly sufficient for the ++ docstrings and comes with the benefit of
1) rst+mathjax would allow to write proper latex math strings into ++
docstrings. I don't remember that I have seen proper $...$ or $$...$$
there. And this is due to the fact that HyperDoc doesn't understand such
TeX stuff.
2) rst can be automatically translated into pdf. There is no need to
write an extra program that turns the "subset of latex" into pdf (or HTML).
>> I'm not so much in favour of the book format, since I think that
>> only a few people are really printing the book.
>
> Printing might be unlikely but there is still the possibility of
> publishing an actual FriCAS book at one of the self-publishing sites
> such as Lulu. For example:
>
> http://www.lulu.com/shop/timothy-daly/axiom-volume-1-tutorial/paperback/product-243128.html
>
> There might be some advantage for people using FriCAS in courses etc.
> if a hard copy could be purchased at regular book stores or on
> Amazon.com.
Do you also want to print a book of the API of FriCAS, i.e. ++
docstrings, or only tutorials?
> OK. But a general solution for breaking FriCAS TeX/LaTeX output might
> still be very desirable, for example for use on axiom-wiki.
I don't conider the axiom-wiki the best form for users to interact with
FriCAS on the web. If we had something like SageNotebook, that would be
much more comfortable.
But as always in opensource, whoever wants something has the chance to
do it him/herself, pay someone to do it or wait until somebody comes
along and does it.
Ralf
--
You received this message because you are subscribed to the Google Groups
"FriCAS - computer algebra system" 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/fricas-devel.
For more options, visit https://groups.google.com/d/optout.
