Hello, everyone. I know that as a first post this is quite shallow, but I
am trying to learn ATS by reading the official book, and I find the default
CSS quite unreadable.
I have taken the liberty to write a few lines of CSS that have improved my
experience - one can apply them in Firefox using the style editor, and I am
sure a similar mechanism exists in other browsers - so I wanted to share
this with the group.
Sphinx is two things: a structured markup language and a
processing/presentation tool. What’s noticeable in this case, is the
presentation. IMO, choosing a markup language for the presentations its
standard tool offers, may be an error. As an example, DITA is an OASIS
standard (better standard to my opinion than Sphinx) and can be used to
produce presentation similar to the good one at the link above.
I personally enjoy Sphinx’s generated presentations, but less its markup
language and processing model.
This comment was just to avoid a confusion, and was not to say Sphinx is
not good (even if I personally believe DITA is a better standard than
Sphinx, there are people who have the opposite opinion).
The source of the intro-to-ATS book is written in something I called ATEXT;
it was planned for supporting so-called literate programming. Now this
plan is
pretty much abandoned (and the new plan uses PHP instead). From ATEXT, I
can generate DocBook format.
DocBook is standard and is XML, so it would be a good option. There must
some XSLT already available for this on the web.
But I will wait until the intro-to-ATS book is pretty much completed. Right
now, I still need to add Part V
on template-based programming.
Cheers!On Wednesday, January 28, 2015 at 4:30:17 AM UTC-5, Andrea Ferretti wrote:
Hello, everyone. I know that as a first post this is quite shallow, but I
am trying to learn ATS by reading the official book, and I find the default
CSS quite unreadable.
I have taken the liberty to write a few lines of CSS that have improved my
experience - one can apply them in Firefox using the style editor, and I am
sure a similar mechanism exists in other browsers - so I wanted to share
this with the group.
If it can be done using XSLT, then it is really the best.
Another option for me is to turn ATEXT into whatever that can be presented
nicely. I will think about this once the book is finished.On Thursday, January 29, 2015 at 7:44:17 AM UTC-5, Yannick Duchêne wrote:
Le jeudi 29 janvier 2015 13:33:47 UTC+1, Andrea Ferretti a écrit :
It would be really nice to use Sphinx and obtain an output such as in
ATS Foundations.
What are the sources whence the current book HTML is compiled? It may
not be that difficult to translate it to a format that Sphinx can
understand
If the original sources are XML, then probably an XSLT sheet could do the
job without the need to use Sphinx at all (by the way, DITA‑OT rely a lot
on XSLT for its presentations generation).
Appearances are important in my opinion, look forward to seeing it myself
later. Though, I didn’t have any particular issues with the book
previously, it admittedly doesn’t look like it was designed by a silicon
valley startup.On Wed, Jan 28, 2015 at 4:30 AM, Andrea Ferretti ferrett...@gmail.com wrote:
Hello, everyone. I know that as a first post this is quite shallow, but I
am trying to learn ATS by reading the official book, and I find the default
CSS quite unreadable.
I have taken the liberty to write a few lines of CSS that have improved my
experience - one can apply them in Firefox using the style editor, and I am
sure a similar mechanism exists in other browsers - so I wanted to share
this with the group.
It would be really nice to use Sphinx and obtain an output such as in
ATS Foundations.
What are the sources whence the current book HTML is compiled? It may
not be that difficult to translate it to a format that Sphinx can
understand
If the original sources are XML, then probably an XSLT sheet could do the
job without the need to use Sphinx at all (by the way, DITA‑OT rely a lot
on XSLT for its presentations generation).
The source of the intro-to-ATS book is written in something I called ATEXT;
it was planned for supporting so-called literate programming. Now this plan
is
pretty much abandoned (and the new plan uses PHP instead). From ATEXT, I
can generate DocBook format. For instance, you can take a look at the files
in the following directory:
There must be a better way to present contents written in DocBook format
than what I use. Unfortunately, I do not know.On Thursday, January 29, 2015 at 7:50:53 AM UTC-5, Andrea Ferretti wrote:
Yeah, I was wondering whether these XML source are available
somewhere, so that I could try and see if I come up with something
useful
2015-01-29 13:44 GMT+01:00 ‘Yannick Duchêne’ via ats-lang-users
<ats-l...@googlegroups.com <javascript:>>:
Le jeudi 29 janvier 2015 13:33:47 UTC+1, Andrea Ferretti a écrit :
It would be really nice to use Sphinx and obtain an output such as in
ATS Foundations.
What are the sources whence the current book HTML is compiled? It may
not be that difficult to translate it to a format that Sphinx can
understand
If the original sources are XML, then probably an XSLT sheet could do
the
job without the need to use Sphinx at all (by the way, DITA‑OT rely a
lot on
XSLT for its presentations generation).