You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@velocity.apache.org by Will Glass-Husain <wg...@forio.com> on 2006/03/31 19:17:34 UTC

quick comments on XMLMind

Hi,

Henning / Mike -- Thanks for getting the instructions for XMLMind on
the Wiki.  Nice to have a little better tool.

One quick note.  It confused me that the attachment was labeled
"XMLMind_XDOC" not "XMLMind_XDOC.tar.gz".  Had to re-read the
directions, realize it needed to be renamed.  Actually, a zip file
might be more intuitive, but perhaps that's just me.

Also, since the files are provided, why did I have to hand-edit them?

I'll have to play with it, see if this helps editing docs.  My quick
take is that it's harder to read than well-formatted text, primarily
because <A> and <B> type tags break up the flow.  But it does look
easier to validate.

Best,
WILL


--
Forio Business Simulations

Will Glass-Husain
wglass@forio.com
www.forio.com

---------------------------------------------------------------------
To unsubscribe, e-mail: velocity-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: velocity-dev-help@jakarta.apache.org


Re: quick comments on XMLMind

Posted by "Henning P. Schmiedehausen" <hp...@intermeta.de>.
"Will Glass-Husain" <wg...@forio.com> writes:

>One quick note.  It confused me that the attachment was labeled
>"XMLMind_XDOC" not "XMLMind_XDOC.tar.gz".  Had to re-read the
>directions, realize it needed to be renamed.  Actually, a zip file
>might be more intuitive, but perhaps that's just me.

Yeah, I was in a bit of a hurry to get this stuff up. I was getting
ready to fetch my new car from the dealer... ;-)

I've cleaned this up a bit more today. It should be easier to use now.

>Also, since the files are provided, why did I have to hand-edit them?

Because they were buggy. This should be better now.

>I'll have to play with it, see if this helps editing docs.  My quick
>take is that it's harder to read than well-formatted text, primarily
>because <A> and <B> type tags break up the flow.  But it does look
>easier to validate.

I like the fact that I can now see (roughly) what the resulting page
will look like. This is IMHO a big win over the "xml forest in an
editor window".

Major drawback is that XMLMind nukes some of the formatting. The docs
will be harder to edit by hand. But then again, XMLMind is free and
runs on all platforms.

	Best regards
		Henning

-- 
Dipl.-Inf. (Univ.) Henning P. Schmiedehausen          INTERMETA GmbH
hps@intermeta.de        +49 9131 50 654 0   http://www.intermeta.de/

RedHat Certified Engineer -- Jakarta Turbine Development  -- hero for hire
   Linux, Java, perl, Solaris -- Consulting, Training, Development

Social behaviour: Bavarians can be extremely egalitarian and folksy.
                                    -- http://en.wikipedia.org/wiki/Bavaria
Most Franconians do not like to be called Bavarians.
                                    -- http://en.wikipedia.org/wiki/Franconia

---------------------------------------------------------------------
To unsubscribe, e-mail: velocity-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: velocity-dev-help@jakarta.apache.org


Re: quick comments on XMLMind

Posted by Mike Kienenberger <mk...@gmail.com>.
There's a "spell" empty folder in the installation as well as a
disabled "check spelling" menu item.  Perhaps it's just a matter of
dropping the "Java Spell Checker product" into it, or purchasing the
non-free version.

Now that I have this working, I've cloned the velocity page, corrected
the errors, and dropped a copy onto the myfaces wiki.   The version
there also has a MyFaces component template and stylesheet defined.

There's no reason why you couldn't replace what's on the current
velocity page with this packaging if you wanted, but I wanted to get
the MyFaces folks editing component docs as easily as possible.

---------------------------------------------------------------------
To unsubscribe, e-mail: velocity-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: velocity-dev-help@jakarta.apache.org


Re: quick comments on XMLMind

Posted by Daniel Dekany <dd...@freemail.hu>.
BTW, XMLMind XML Editor... Anybody knows about a similar editor (i.e.
something that you can use to edit XML documents like XDobBook and
like) that can do spell checking like in MS World or Open Office? You
know, when the mistakes are underlined with red immediately when you
type them. Looks like Arbortext can do it, but it must be damn
expensive (I didn't even find it's price... so you can imagine), also
maybe Adobe Framemaker (couldn't try it yet), but that's also very
expensive.

The funny is that XMLmind (the company) do have Java Spell Checker
product, and still...

-- 
Best regards,
 Daniel Dekany


---------------------------------------------------------------------
To unsubscribe, e-mail: velocity-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: velocity-dev-help@jakarta.apache.org


Re: quick comments on XMLMind

Posted by Will Glass-Husain <wg...@forio.com>.
Ah-ha!

This line is the key:

<!DOCTYPE document PUBLIC "-//Apache Software Foundation//DTD XDOC 1.0//EN"
                          "http://www.apache.org/dtds/xdoc_1_0.dtd">

Originally I opened an xdoc and it displayed in an un-intelligable
tree.  But when I added this line, it opened in nice readable format. 
Much better.

Thanks,
WILL

On 4/1/06, Henning P. Schmiedehausen <hp...@intermeta.de> wrote:
> "Mike Kienenberger" <mk...@gmail.com> writes:
>
> >Hey Will,  I noticed the same things, but I didn't feel it was my
> >place to change the attachment, particularly since I wasn't sure if
> >the changes I was making were the right ones.   I also would prefer a
> >zip file.
>
> I've put up a zip file. I thought so that you Windows types will find
> that easier to use ;-) ;-)
>
>         Best regards
>                 Henning
>
>
> --
> Dipl.-Inf. (Univ.) Henning P. Schmiedehausen          INTERMETA GmbH
> hps@intermeta.de        +49 9131 50 654 0   http://www.intermeta.de/
>
> RedHat Certified Engineer -- Jakarta Turbine Development  -- hero for hire
>    Linux, Java, perl, Solaris -- Consulting, Training, Development
>
> Social behaviour: Bavarians can be extremely egalitarian and folksy.
>                                     -- http://en.wikipedia.org/wiki/Bavaria
> Most Franconians do not like to be called Bavarians.
>                                     -- http://en.wikipedia.org/wiki/Franconia
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: velocity-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: velocity-dev-help@jakarta.apache.org
>
>


--
Forio Business Simulations

Will Glass-Husain
wglass@forio.com
www.forio.com

---------------------------------------------------------------------
To unsubscribe, e-mail: velocity-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: velocity-dev-help@jakarta.apache.org


Re: quick comments on XMLMind

Posted by "Henning P. Schmiedehausen" <hp...@intermeta.de>.
"Mike Kienenberger" <mk...@gmail.com> writes:

>Hey Will,  I noticed the same things, but I didn't feel it was my
>place to change the attachment, particularly since I wasn't sure if
>the changes I was making were the right ones.   I also would prefer a
>zip file.

I've put up a zip file. I thought so that you Windows types will find
that easier to use ;-) ;-)

	Best regards
		Henning


-- 
Dipl.-Inf. (Univ.) Henning P. Schmiedehausen          INTERMETA GmbH
hps@intermeta.de        +49 9131 50 654 0   http://www.intermeta.de/

RedHat Certified Engineer -- Jakarta Turbine Development  -- hero for hire
   Linux, Java, perl, Solaris -- Consulting, Training, Development

Social behaviour: Bavarians can be extremely egalitarian and folksy.
                                    -- http://en.wikipedia.org/wiki/Bavaria
Most Franconians do not like to be called Bavarians.
                                    -- http://en.wikipedia.org/wiki/Franconia

---------------------------------------------------------------------
To unsubscribe, e-mail: velocity-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: velocity-dev-help@jakarta.apache.org


Re: quick comments on XMLMind

Posted by Mike Kienenberger <mk...@gmail.com>.
On 3/31/06, Will Glass-Husain <wg...@forio.com> wrote:
> One quick note.  It confused me that the attachment was labeled
> "XMLMind_XDOC" not "XMLMind_XDOC.tar.gz".  Had to re-read the
> directions, realize it needed to be renamed.  Actually, a zip file
> might be more intuitive, but perhaps that's just me.
>
> Also, since the files are provided, why did I have to hand-edit them?

Hey Will,  I noticed the same things, but I didn't feel it was my
place to change the attachment, particularly since I wasn't sure if
the changes I was making were the right ones.   I also would prefer a
zip file.


> I'll have to play with it, see if this helps editing docs.  My quick
> take is that it's harder to read than well-formatted text, primarily
> because <A> and <B> type tags break up the flow.  But it does look
> easier to validate.

Once I got the css connection in place, at least for the myfaces
xdocs, it's very readable!  It's really not much different than our
web pages.   Maybe you're also seeing it without the css?  Under the
"view" menu you should be able to see "1 stylesheet" selected.

I would also think that because it's a css style sheet, it should be
possible to further customize it until it looks identical to the final
web page.  I'm not sure how hard it is to provide multiple style
sheets, but it look possible.  Unfortunately I'm completely ignorant
when it comes to css.

---------------------------------------------------------------------
To unsubscribe, e-mail: velocity-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: velocity-dev-help@jakarta.apache.org


Re: quick comments on XMLMind

Posted by Mike Kienenberger <mk...@gmail.com>.
On 3/31/06, Will Glass-Husain <wg...@forio.com> wrote:
> I'll have to play with it, see if this helps editing docs.  My quick
> take is that it's harder to read than well-formatted text, primarily
> because <A> and <B> type tags break up the flow.  But it does look
> easier to validate.

Yep.  Looks like you can list out multiple css elements in xdoc.xxe,
each of which will go into the view menu:

  <css name="Style sheet" location="css/xdoc_1_0.css" />
  <css name="Style sheet - Myfaces component"
location="css/xdoc_1_0-myfaces.css" />

I still don't know what to do with it, but I try to find someone who does :)

---------------------------------------------------------------------
To unsubscribe, e-mail: velocity-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: velocity-dev-help@jakarta.apache.org