[Nobug] Asciidoc and pdf: see no difference in output

Sun Sep 9 23:01:34 CEST 2012

Am Sun, 09 Sep 2012 20:44:47 +0200
schrieb "Benny Lyons" <Benny.Lyons at gmx.net>:

> Hi, 
> I've been looking at the pdf output produced by 2 different versions
> of Asciidoc, but cannot see any difference.  
> 
> Here's what I've been doing:
> 
> I'm using Squeeze, so, per default I'm using Asciidoc 8.6.6. Instead
> of doing an update to Wheezy, I downloaded the latest Asciidoc and
> installed it under /usr/local. That's version 8.6.8. 
> 
> To be able to use both versions of Asciidoc, side-by-side, I wrote a
> small wrapper for Asciidoc that allows me to easily switch between
> versions.
> 
> I produce the NoBug LaTeX manual as follows:
>    
>     asciidoc -f /${asciidoc_version}/latex.conf --unsafe
> --backend=latex nobug_manual.txt
> 
> 
> Unfortunately, I see no difference between either versions. Is my
> scheme in error?  Are my versions of Asciidoc ok? or should I be
> checking other versions?  What versions of Asciidoc are you using.
> 
> The pdf produced by both versions is not terribly inspiring.

Maybe it was even Lenny when i first tried? back that time the pdf
output looked even more worse (aka not only ugly but some brokenness).
The direct Latex backend looks way better, while I think this should be
only some stylesheet issue (where I have no clue either). I'll
investigate later what would be simpler to do for me, upgrading the
latex backend or figuring out how to make a stylesheet to generate a
compareable pleasing output with dblatex. I imagine fixing the latex
backend is the low hanging fruit while having a dblatex stylesheet
might be more future proof. So lets se.

	Christian

> 
> Cheers 
> 
> Benny
> 
> 
> 
> 
> -------- Original-Nachricht --------
> > Datum: Sat, 1 Sep 2012 00:03:49 +0200
> > Von: Christian Thaeter <ct at pipapo.org>
> > An: "Benny Lyons" <Benny.Lyons at gmx.net>
> > CC: General Discussion about Lumiera <lumiera at lists.lumiera.org>,
> > nobug at lists.pipapo.org Betreff: Re: [Nobug] [Lumiera] Back in
> > business...
> 
> > Am Fri, 31 Aug 2012 19:35:04 +0200
> > schrieb "Benny Lyons" <Benny.Lyons at gmx.net>:
> > 
> > > Hi, 
> > > 
> > > > ...Thats why I'd
> > > > like to ask if anyone fond of LaTeX and asciidoc would like to
> > > > help me to reinstate the asciidoc latex backend. Or helping to
> > > > communicate and push the code upstream (Stuart was always very
> > > > kind and positive about our submissions, I only don't want a
> > > > google account and therefore can't participate on the asciidoc
> > > > google group).
> > > Yes, I can certainly take a look into it.  I'm well into Plain
> > > TeX, less so into LaTeX, and less still into Asciidoc.  However,
> > > we still have a problem with a Google account: I don't have one.
> > > 
> > > I've had a quick look into Asciidoc and it looks like that the
> > > said tweekings will have to be made in /etc/asciidoc/latex.conf
> > > on a Debian based system.
> > > Then generate LaTeX via
> > >     asciidoc --unsafe --backend=latex foox.txt
> > > (or are you generating pdf directly? or some other way?)
> > > 
> > > As far as I can see, the LaTeX code is more or less configured
> > > using this file, so the work required will be confined to this
> > > file?
> > 
> > Exactly, this latex.conf is not maintained upstream but we improved
> > it for Nobug and upstream eventually merged some things.
> > Now I upgraded to wheezy with a much newer asciidoc version and the
> > latex.conf is very outdated and needs to be brought up to date (as
> > well as our documentation which uses some deprecated things)
> > 
> > > 
> > > Looks like an iterative process: modify this file, and have a
> > > look at the LaTeX that is generated etc (please correct me if I'm
> > > wrong).
> > 
> > its a ugly syntax but very regular and usable after one gets over
> > the initial barrier. I have to look at it again. Making the first
> > Version (which was based on a dysfunctional latex.conf) was quite
> > some work but i expect things now become simpler.
> > 
> > 
> > 	Christian
> > 
> > > 
> > > Cheers 
> > > Benny
> > > 
> > > -------- Original-Nachricht --------
> > > > Datum: Thu, 30 Aug 2012 04:40:36 +0200
> > > > Von: Christian Thaeter <ct at pipapo.org>
> > > > An: nobug at lists.pipapo.org, General Discussion about Lumiera
> > > > <lumiera at lists.lumiera.org> Betreff: [Lumiera] Back in
> > > > business...
> > > 
> > > > Hi,
> > > > 
> > > > after a (very) long break I am finally coming back to
> > > > Programming on Lumiera and NoBug and all other stuff what left
> > > > around! It will certainly take me some time to catch up where I
> > > > left but thinks looking good so far.
> > > > 
> > > > As warm-up I am finishing the final bits on the 'builddrone'
> > > > continuous integration System which will soon be deployed on our
> > > > Development Server to build, test and package the software we
> > > > maintain.
> > > > 
> > > > After that a long outstanding release of NoBug with some new
> > > > features is planned. Then Lumiera is on the plan. First some
> > > > infrastructure improvements we talked about (on FrOSCon) and
> > > > then finally core programming.
> > > > 
> > > > Now with builddrone testing (building NoBug) locally I already
> > > > ran in some Issues. The Latex backend we once made/improved for
> > > > asciidoc is quite broken and outdated and needs a makeover. This
> > > > was meant to be the backbone for creating high quality printed
> > > > user documentation (for NoBug and Lumiera). You can check the
> > > > old docs on the NoBug page
> > > > (http://nobug.pipapo.org/releases/nobug_manual.pdf). I am quite
> > > > excited about the quality over the normal dblatex generated PDF.
> > > > Thats why I'd like to ask if anyone fond of LaTeX and asciidoc
> > > > would like to help me to reinstate the asciidoc latex backend.
> > > > Or helping to communicate and push the code upstream (Stuart was
> > > > always very kind and positive about our submissions, I only
> > > > don't want a google account and therefore can't participate on
> > > > the asciidoc google group).
> > > > 
> > > > 
> > > > 	Christian
> > > > 
> > > > 
> > > > _______________________________________________
> > > > Lumiera mailing list
> > > > Lumiera at lists.lumiera.org
> > > > http://lists.lumiera.org/cgi-bin/mailman/listinfo/lumiera
> > > > http://lumiera.org/donations.html
> > > 
> 