ANN: AsciiDoc 8.2.6

[Stuart Rackham]

Hi All

There have been a lot of small (hopefully useful) changes and bug fixes
since 8.2.5 so I thought it was time to formally release them:

http://www.methods.co.nz/asciidoc/CHANGELOG.html

The only noteworthy functional addition is embedded image support using
the data: URI Scheme (http://en.wikipedia.org/wiki/Data:_URI_scheme) for
XHTML documents (it's a nifty demonstration of the use of the {sys}
system attribute).

I've done limited testing on Windows and Python 2.3 (most testing and
development on Xubuntu 7.10 + Python 2.5.1), so yell out if you
experience regression problems.


Cheers, Stuart
_______________________________________________
asciidoc-discuss mailing list
asciidoc-discuss@...
http://lists.metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss

[Miklos Vajna]

On Wed, Apr 30, 2008 at 09:17:39AM +1200, Stuart Rackham <srackham@...> wrote:
> I've done limited testing on Windows and Python 2.3 (most testing and
> development on Xubuntu 7.10 + Python 2.5.1), so yell out if you
> experience regression problems.

hm, it seems the tex backend is somewhat broken. here is what i do:

wget -O test.txt http://frugalware.org/~boobaa/stuff/doc-u.txt

$ asciidoc --unsafe --backend=latex -a toc test.txt
WARNING: [music-block] missing template section
WARNING: [music-block] missing template section

but test.tex created properly

this is 8.2.5. after upgrading to 8.2.6:

$ asciidoc --unsafe --backend=latex -a toc test.txt
FAILED: malformed section entry: \\=\textbackslash{}

and no output created. feel free to correct me if this is just a pebkac
:)

thanks.


_______________________________________________
asciidoc-discuss mailing list
asciidoc-discuss@...
http://lists.metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss

[Stuart Rackham]

Please don't think I'm deliberately ignoring questions/patches etc on
the list, I do read everything, it's just that at the moment I'm really
busy -- I wish there were more hours in the day :-)

When I'm busy like this I tend to go for the low hanging fruit when it
comes to responses, leaving the big (usually more important) stuff till
later.


Cheers, Stuart
--
Stuart Rackham
_______________________________________________
asciidoc-discuss mailing list
asciidoc-discuss@...
http://lists.metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss

[Dag Wieers]

On Tue, 6 May 2008, Stuart Rackham wrote:

> When I'm busy like this I tend to go for the low hanging fruit when it
> comes to responses, leaving the big (usually more important) stuff till
> later.

Exactly the same emergency mode I tend to fall into too often. :)

--
--   dag wieers,  dag@...,  http://dag.wieers.com/   --
[Any errors in spelling, tact or fact are transmission errors]
_______________________________________________
asciidoc-discuss mailing list
asciidoc-discuss@...
http://lists.metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss

[Bill Harris]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Stuart Rackham <srackham@...> writes:

> The only noteworthy functional addition is embedded image support using
> the data: URI Scheme (http://en.wikipedia.org/wiki/Data:_URI_scheme) for
> XHTML documents (it's a nifty demonstration of the use of the {sys}
> system attribute).

That sounded cool (although I think most of my clients use IE7), so I
tried it out.  While 8.2.6 looks good so far, I can't make this feature
work.  I'd appreciate a clean and full example.

To make life easy (or so I thought -- I'll try cygwin's base64.exe
later, when I can make this work), I went to
http://www.sveinbjorn.org/cgi-bin/dataurlmaker-cgi.pl and converted a
small picture I had on my computer.  It gave me a string of the form

<img src="data:image/jpeg;base64,/9j/4AAQ ... bunch of stuff elided ... WrCk460UVYH//Z" width="172" height="243">

I prepended image:: and pasted the resultant into my previously working
document.  

I ran asciidoc.py --unsafe -a data-uri -a toc file.txt.

The resulting HTML file shows image::<"data:image/jpeg... in the output
instead of a picture.  I tested my browser (FF 2.0.0.14) at
http://www.mozilla.org/quality/networking/testing/datatests.html, and it
seems to work.

I also tried it without the toc attribute, and I tried something like
the format in asciidoc.html:

,----
| .Main circuit board
| [caption="Figure 2:"]
| image::images/layout.png
`----

except that I used the <> enclosed stuff after image::, too.

Any tips?

Thanks,

Bill
- --
Bill Harris                      http://facilitatedsystems.com/weblog/
Facilitated Systems                              Everett, WA 98208 USA
http://facilitatedsystems.com/                  phone: [phone]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.7 (MingW32)
Comment: For more information, see http://www.gnupg.org

iD8DBQFII3Hg3J3HaQTDvd8RAvI2AJ91xXHpQf+fX/LtQIp/J9+n8dd/ugCdEf/0
MALQ03MvxLLzffiZV8jNm8Q=
=xjrL
-----END PGP SIGNATURE-----
_______________________________________________
asciidoc-discuss mailing list
asciidoc-discuss@...
http://lists.metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss

[Stuart Rackham]

Hi Bill

Bill Harris wrote:

> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> Stuart Rackham <srackham@...> writes:
>
>> The only noteworthy functional addition is embedded image support using
>> the data: URI Scheme (http://en.wikipedia.org/wiki/Data:_URI_scheme) for
>> XHTML documents (it's a nifty demonstration of the use of the {sys}
>> system attribute).
>
> That sounded cool (although I think most of my clients use IE7), so I
> tried it out.  While 8.2.6 looks good so far, I can't make this feature
> work.  I'd appreciate a clean and full example.
>
> To make life easy (or so I thought -- I'll try cygwin's base64.exe
> later, when I can make this work), I went to
> http://www.sveinbjorn.org/cgi-bin/dataurlmaker-cgi.pl and converted a
> small picture I had on my computer.  It gave me a string of the form
>
> <img src="data:image/jpeg;base64,/9j/4AAQ ... bunch of stuff elided ... WrCk460UVYH//Z" width="172" height="243">
>
> I prepended image:: and pasted the resultant into my previously working
> document.  
>
> I ran asciidoc.py --unsafe -a data-uri -a toc file.txt.
>
> The resulting HTML file shows image::<"data:image/jpeg... in the output
> instead of a picture.  I tested my browser (FF 2.0.0.14) at
> http://www.mozilla.org/quality/networking/testing/datatests.html, and it
> seems to work.
>
> I also tried it without the toc attribute, and I tried something like
> the format in asciidoc.html:
>
> ,----
> | .Main circuit board
> | [caption="Figure 2:"]
> | image::images/layout.png
> `----
>
> except that I used the <> enclosed stuff after image::, too.
>
> Any tips?

You're running under Windows so as I had only tested on Linux (Xubuntu
7.10) I tried the AsciiDoc distribution article.txt under Windows
(Windows XP SP2, Python 2.5.2 (I'm not using Cygwin)).

Which rendered the embedded images fine fine (see
http://www.methods.co.nz/misc/article.html), though I did get non-zero
exit codes (seems be Python related, doesn't affect the output but I
haven't got to the bottom of it):

C:\bin\asciidoc>asciidoc -a data-uri --unsafe doc/article.txt
WARNING: article.txt: line 37: {sys:python -uc "import base64,sys;
base64.encode(sys.stdin,sys.stdout)" < "images/smallnew.png"}: non-zero
exit status
WARNING: article.txt: line 40: {sys:python -uc "import base64,sys;
base64.encode(sys.stdin,sys.stdout)" < "images/tiger.png"}: non-zero
exit status

You can run the same encoding command that asciidoc runs from the DOS
prompt e.g. (one line)

C:\bin\asciidoc>python -uc "import base64,sys;
base64.encode(sys.stdin,sys.stdout)" < "images/tiger.png"

This spews out the base64 encoding that the {sys} attribute embeds in
the XHTML output document (why the exit code is non-zero eludes me, but
as I said before this doesn't affect the output).


Cheers, Stuart
_______________________________________________
asciidoc-discuss mailing list
asciidoc-discuss@...
http://lists.metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss

[Bill Harris]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Stuart Rackham <srackham@...> writes:

> You're running under Windows so as I had only tested on Linux (Xubuntu
> 7.10) I tried the AsciiDoc distribution article.txt under Windows
> (Windows XP SP2, Python 2.5.2 (I'm not using Cygwin)).
>
> Which rendered the embedded images fine fine (see
> http://www.methods.co.nz/misc/article.html), though I did get non-zero
> exit codes (seems be Python related, doesn't affect the output but I
> haven't got to the bottom of it):

Ah, I see.  Your script encodes the image and embeds it.  I thought that
it merely embedded it, and so I encoded the image separately.  Not
surprisingly, asciidoc didn't seem to know what to do with a
base64-encoded image as input to the process.

Thanks; it worked easily for me today.  Now if you'd only get MS to
retrofit this into IE 6 and 7 or get all my clients to switch to FF, I'd
be set. :-)

Thanks again,

Bill
- --
Bill Harris                      http://facilitatedsystems.com/weblog/
Facilitated Systems                              Everett, WA 98208 USA
http://facilitatedsystems.com/                  phone: [phone]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.7 (MingW32)
Comment: For more information, see http://www.gnupg.org

iD8DBQFIKMRO3J3HaQTDvd8RAoSiAJ9GIVB8H3J2clIn9I50lqyJ0HH+2wCeKeyU
oMYMqmovGZeLjIREgTIFIb4=
=6nHG
-----END PGP SIGNATURE-----
_______________________________________________
asciidoc-discuss mailing list
asciidoc-discuss@...
http://lists.metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss