On Fri, 02 May 2014 06:06:53 +0200, Lex Trotman <[email protected]> wrote:

[...]
The diff in the link I gave actually looks like it would still apply,
to xhtml.conf.  It just needs documenting and an equivalent for
html5.conf needs creating though.


FYI: despite my aversion against git (which is not based on any experience with it, of course but only on a comparison of `hg help log' with `git help log' ;-)) I've followed your advice and tried to fix it. so since today I
have a github account, tried hard to understand what I am expected to do
(fork, clone, pull request) and hopefully succeeded w.r.t. expected
workflow. (if not, please advice).

Thanks for doing this.

pure selfishness ;-). the "asymmetric" support for mathematical equations (just fine with pdf/dblatex, but not so much with html)
was always a problem for me.


Minor comments in a PS, but well done :)


I've put the matjax script block essentially where the original author put
it (see mailing list) but avoided putting it within
the ifdef latexmath block since I believe it should go outside of it.

That makes sense to me.

In the long run I would want to look at how it could be made easier
for user configuration, a custom asciidoc.conf would have to include
the whole of the [header] section which is of course the largest and
messiest, and we just made it bigger.

yes, and, while it sure is nice to have potentially full control via customization of all the *.conf files it also is quite over the top in my view regarding the average (but possibly demanding) user. something like a _single_ simple key/value resource file
without conditionals and deep magic
(think `.hgrc' or `.gitconfig') would be more accessible I believe. at least all the basic needs could be satisfied in this way, I would say. what do you think? currently, there are 25 conf-files (10 w/o the lang*.conf files), which is quite something...


But lets get initial support into Asciidoc first :)

yep.



I also tried to augment the user guide. does the edit make sense?

Minor suggestion on the commit, but otherwise sure.

If you just add the comment that I think the PR should be ok to add as
is, I will assume you have tested both XHTML11 and HTML5 (hint hint
:).

as far as my tests go, yes: I put some equations (inline plus display) in the middle of a 60+ pages document and checked that they were rendered correctly with both backends. and the dblatex backend also is still happy (as it should be, but I've checked just to be sure). in this context: I have never understood what happens to the latexmath passthrough blocks when going through xml (i.e. when using `a2x'): `dblatex' finds the stuff and happily uses it, but `xsltproc' does not, it seems. if I look into the intermediate xml-file, the equations are there in some CDATA blocks (whatever that is -- I don't know nothing of docbook...) so why don't they make it into the final html (where they would be taken care
of by mathjax)?

best,

joerg


Cheers
Lex

PS On the git/github workflow, two points, which will also almost
certainly apply to any other git projects.

1. Make commit messages have a short summary as the first line < 80
chars, as a sentence with leading capital letter.  Just describe the
commit, don't add "tentatively" or such, it gets copied into the
repository.  If you are unsure about a change, put that in the github
comments not the commit message.

2. Although not essential on a low rate project like Asciidoc, making
the changes in a branch other than "master" lets people test your
changes without messing up their master branch, which should track the
repository.  This is essential on a high rate project to keep your

understood.

changes separate from other peoples, and also helps to prevent
accidental commits of unwanted changes.  Some projects are very
authoritarian on this.

I'll try to find out how this is done in `git' (in `mercurial' or `fossil' I would know ...). btw: in the asciidoc user guide the `hg' repo at google code is still referenced. what exactly is the state of affairs here? where are the future official releases to be found? also, out of curiosity: what triggered the move from `hg' to `git'? it cannot have been "it has a better design and
is simpler to use" ;-)



greetings,


joerg


Cheers
Lex


thanks

joerg



Cheers
Lex



thanks

joerg



Cheers
Lex


I believe that improving support for mathematical typesetting could
increase
asciidocs popularity in the corresponding communities.

thank you

joerg

--
You received this message because you are subscribed to the Google
Groups
"asciidoc" 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/asciidoc.
For more options, visit https://groups.google.com/d/optout.






--
Using Opera's revolutionary email client: http://www.opera.com/mail/


--
You received this message because you are subscribed to the Google
Groups
"asciidoc" 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/asciidoc.
For more options, visit https://groups.google.com/d/optout.





--
Using Opera's revolutionary email client: http://www.opera.com/mail/

--
You received this message because you are subscribed to the Google Groups
"asciidoc" 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/asciidoc.
For more options, visit https://groups.google.com/d/optout.




--
Using Opera's revolutionary email client: http://www.opera.com/mail/

--
You received this message because you are subscribed to the Google Groups
"asciidoc" 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/asciidoc.
For more options, visit https://groups.google.com/d/optout.



--
Using Opera's revolutionary email client: http://www.opera.com/mail/

--
You received this message because you are subscribed to the Google Groups 
"asciidoc" 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/asciidoc.
For more options, visit https://groups.google.com/d/optout.

Reply via email to