From doxiaadamswilliam@example.net Wed Sep 29 06:38:52 2010
Return-Path: <doxiaadamswilliam@example.net>
Delivered-To: adamswilliam@example.net
Received: (qmail 17560 invoked from network); 29 Sep 2010 06:38:51 -0000
Received: from unknown (HELO mail.apache.org) (83.161.120.155)
  by 83.161.120.155 with SMTP; 29 Sep 2010 06:38:51 -0000
Received: (qmail 46163 invoked by uid 500); 29 Sep 2010 06:38:51 -0000
Delivered-To: adamswilliam@example.net
Received: (qmail 46104 invoked by uid 500); 29 Sep 2010 06:38:49 -0000
Mailing-List: contact adamswilliam@example.net; run by ezmlm
Precedence: bulk
List-Help: <mailto:adamswilliam@example.net>
List-Unsubscribe: <mailto:adamswilliam@example.net>
List-Post: <mailto:adamswilliam@example.net>
List-Id: <doxia-dev.maven.apache.org>
Reply-To: adamswilliam@example.net
Delivered-To: mailing list adamswilliam@example.net
Delivered-To: moderator for adamswilliam@example.net
Received: (qmail 96623 invoked by uid 99); 28 Sep 2010 19:07:01 -0000
X-ASF-Spam-Status: No, hits=0.0 required=10.0
	tests=FREEMAIL_FROM,RCVD_IN_DNSWL_NONE,SPF_PASS,T_TO_NO_BRKTS_FREEMAIL
X-Spam-Check-By: apache.org
Received-SPF: pass (athena.apache.org: domain of adamswilliam@example.net designates 83.161.120.155 as permitted sender)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=gamma;
        h=domainkey-signature:mime-version:received:received:date:message-id
         :subject:from:to:content-type;
        bh=vFVM6eHVDNsj2R+jrIFiFe1wmLXITXeuIOOjBiTxvg0=;
        b=V6SJzXOasnU1beTZtSjwrpfxBw7M3YVI7Eh6xf3g1uttZdNihLUUEHk435LOgZ4GaG
         bc3CHDeADPea0hb66Sa09cIE5DmRvJD2mzeBUqxv61ZYo3E0rUsawdhJ/xMDZ1E8OPvs
         tXL2Co0kYWQ5WynBc72RXG+FUW0++WS2KBoJU=
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:date:message-id:subject:from:to:content-type;
        b=Cjq2YIkni2AKNC+21HvQeRNG3zQmHjKwxmbcmgo4lKtNDSjVksDXk3+P7J/XHvP+15
         X8Zkk635aoPO2b8p0mR4QYCQtrSPMUqEinCHAgzPR/xUO5atKE3cVs5hTfb4uuoe/2cm
         9Ax8hPRjnhxNNuozL0zmSRNODqFTFvda6hbIw=
MIME-Version: 1.0
Date: Tue, 28 Sep 2010 21:06:32 +0200
Message-ID: <adamswilliam@example.net>
Subject: Macro for yuml.me
From: Rune Flobakk <adamswilliam@example.net>
To: adamswilliam@example.net
Content-Type: text/plain; charset=ISO-8859-1

Hello,

After recently discovering the http://yuml.me site I wanted to be able
easily to include some UML in my APT documents, and started on a Doxia
macro for this. I intend to open source it once I get some actual
functionality up and running.

I picture the macro as something like this: it should accept yuml.me's
textual UML syntax (or maybe some parametrization), forward it to
yuml.me and retrieve the generated picture, store the picture with the
generated documentation, and call figure() etc on the Sink to insert
the picture into the resulting document. The problem which I quickly
encountered is where exactly do I store the pictures which I get from
yuml.me? I believe the usual case for Doxia macros is to reference
resources which are known beforehand, but in this case I essentially
want my macro to output a file which should be included in the
resulting document.

I can get the basedir from the provided MacroRequest, but this gives
me the root of the current Maven project, and I was hoping to avoid
hardcoding e.g. "target/site/images/uml". I could of course output a
yuml.me URL to Sink.figureGraphics() but that would potentially
generate a lot of unnecessary traffic to the yuml.me, and the
generated site will depend on yuml.me being online.

So is this a viable approach at all?
Thanks for any pointers!

- Rune


{'source': 'Apache Software Foundation Public Mail Archives'}