Re: xdoc DTD - Do we already have a PUBLIC identifier?

2006-04-01 Thread Henning Schmiedehausen
On Fri, 2006-03-31 at 19:12 +, Lukas Theussl wrote:
 No, there is none. The DTD is currently only available in SVN, it was 
 added in the 1.10 version of the maven-1 xdoc plugin which is not 
 released yet. As such, it is still work in progress, so I don't know if 
 it's a good idea to publish it at this point. However, as far as I'm 
 concerned, the xdoc-1.10 plugin could be released very soon, we will 
 consider your demand as soon as it's done (please remind us if we 
 forget, I know you are good at that! ;) )

;-)

I've created MPXDOC-192, please make sure to resolve it before releasing
1.10

Best regards
Henning



 
 -Lukas
 
 
 Henning Schmiedehausen wrote:
  Hi,
  
  I finally was able to make heads and tails of the xdoc DTD as included
  in the maven 1 xdoc plugin (thanks a lot for this, Lukas  Arnaud!) . To
  make XMLMind to automatically identify these files, we do need a DTD
  public identifier. Do you already have one? Googling for this didn't
  really help me here.
  
  If you don't have decided for an identifier, I'd like to propose:
  
  !DOCTYPE document PUBLIC -//Apache Software Foundation//DTD XDOC 1.0//EN
http://www.apache.org/dtds/xdoc_1_0.dtd;
  
  as DTD identifier for the XDOC format. As I understand, we then must
  make this DTD visible at the designated location, which needs
  coordination with the infra people. However, putting it under
  www.apache.org means, that the mirror system will pick up these DTDs.
  
  Any opinions? If you agree, you can take a look at
  http://wiki.apache.org/jakarta-velocity/EditXdocs
  
  to get my XMLMind hackery for actually editing xdocs (not just painfully
  writing them... :-) ).
  
  Best regards
  Henning
  
-- 
Dipl.-Inf. (Univ.) Henning P. Schmiedehausen  INTERMETA GmbH
[EMAIL PROTECTED]+49 9131 50 654 0   http://www.intermeta.de/

  RedHat Certified Engineer -- Jakarta Turbine Development
   Linux, Java, perl, Solaris -- Consulting, Training, Engineering

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: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: xdoc DTD - Do we already have a PUBLIC identifier?

2006-04-01 Thread Henning Schmiedehausen
Hi,

getting XDOC out of the maven/velocity realm and making an  official
format would IMHO help its visibility tremendously. That's why I
proposed to adopt it as 

-//Apache Software Foundation//DTD XDOC 1.0//EN

and removed all the maven and velocity references from it. Having it
online is good, having it at www.apache.org/dtds with an official
location and version number (1.0) is IMHO much better.

It would also avoid sneaking stuff in. ;-) (navbar...)

Best regards
Henning




On Fri, 2006-03-31 at 22:25 +0200, Arnaud HERITIER wrote:
 Hi, in fact it's not yet documented but the dtd is already online :
 http://maven.apache.org/maven-1.x/plugins/xdoc/maven-xdoc.dtd
 
 cheers 
 
 arnaud
 
 On 3/31/06, Lukas Theussl [EMAIL PROTECTED] wrote:
 
 No, there is none. The DTD is currently only available in SVN,
 it was
 added in the 1.10 version of the maven-1 xdoc plugin which is
 not
 released yet. As such, it is still work in progress, so I
 don't know if
 it's a good idea to publish it at this point. However, as far
 as I'm
 concerned, the xdoc-1.10 plugin could be released very soon,
 we will
 consider your demand as soon as it's done (please remind us if
 we
 forget, I know you are good at that! ;) ) 
 
 -Lukas
 
 
 Henning Schmiedehausen wrote:
  Hi,
 
  I finally was able to make heads and tails of the xdoc DTD
 as included
  in the maven 1 xdoc plugin (thanks a lot for this, Lukas 
 Arnaud!) . To 
  make XMLMind to automatically identify these files, we do
 need a DTD
  public identifier. Do you already have one? Googling for
 this didn't
  really help me here.
 
  If you don't have decided for an identifier, I'd like to
 propose: 
 
  !DOCTYPE document PUBLIC -//Apache Software
 Foundation//DTD XDOC 1.0//EN
 
 http://www.apache.org/dtds/xdoc_1_0.dtd;
 
  as DTD identifier for the XDOC format. As I understand, we
 then must
  make this DTD visible at the designated location, which
 needs
  coordination with the infra people. However, putting it
 under 
  www.apache.org means, that the mirror system will pick up
 these DTDs.
 
  Any opinions? If you agree, you can take a look at
  http://wiki.apache.org/jakarta-velocity/EditXdocs
 
  to get my XMLMind hackery for actually editing xdocs (not
 just painfully
  writing them... :-) ).
 
Best regards
Henning 
 
 
 -
 To unsubscribe, e-mail: [EMAIL PROTECTED]
 For additional commands, e-mail: [EMAIL PROTECTED]
 
 
-- 
Dipl.-Inf. (Univ.) Henning P. Schmiedehausen  INTERMETA GmbH
[EMAIL PROTECTED]+49 9131 50 654 0   http://www.intermeta.de/

  RedHat Certified Engineer -- Jakarta Turbine Development
   Linux, Java, perl, Solaris -- Consulting, Training, Engineering

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: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: xdoc DTD - Do we already have a PUBLIC identifier?

2006-04-01 Thread Lukas Theussl


Actually, the navbar is in there already...

I tried to discuss the question of what an xdoc is once on the maven dev 
list [1] but didn't get too much feedback. I then adopted the definition 
of an xdoc as something that is transformed into a valid 
xhtml1-transitional by the xdoc plugin.  This of course links it 
intimately to maven and the xdoc plugin (which is also reflected in the 
current versioning scheme - the dtd in svn is called maven-xdoc-1.10.dtd 
and I assumed that we would publish a new version with every xdoc 
plugin). I never thought of '... getting XDOC out of the maven/velocity 
realm and making an  official format'.


As for now, the only difference between an xdoc and an 
xhtml1-transitional is the addition of the elements section, 
subsection, escapeXml, source and navbar.


Any comments welcome.

-Lukas


[1] http://www.nabble.com/What-is-an-xdoc--t370461.html#a1023611


Henning Schmiedehausen wrote:

Hi,

getting XDOC out of the maven/velocity realm and making an  official
format would IMHO help its visibility tremendously. That's why I
proposed to adopt it as 


-//Apache Software Foundation//DTD XDOC 1.0//EN

and removed all the maven and velocity references from it. Having it
online is good, having it at www.apache.org/dtds with an official
location and version number (1.0) is IMHO much better.

It would also avoid sneaking stuff in. ;-) (navbar...)

Best regards
Henning




-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



xdoc DTD - Do we already have a PUBLIC identifier?

2006-03-31 Thread Henning Schmiedehausen
Hi,

I finally was able to make heads and tails of the xdoc DTD as included
in the maven 1 xdoc plugin (thanks a lot for this, Lukas  Arnaud!) . To
make XMLMind to automatically identify these files, we do need a DTD
public identifier. Do you already have one? Googling for this didn't
really help me here.

If you don't have decided for an identifier, I'd like to propose:

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

as DTD identifier for the XDOC format. As I understand, we then must
make this DTD visible at the designated location, which needs
coordination with the infra people. However, putting it under
www.apache.org means, that the mirror system will pick up these DTDs.

Any opinions? If you agree, you can take a look at
http://wiki.apache.org/jakarta-velocity/EditXdocs

to get my XMLMind hackery for actually editing xdocs (not just painfully
writing them... :-) ).

Best regards
Henning

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

  RedHat Certified Engineer -- Jakarta Turbine Development
   Linux, Java, perl, Solaris -- Consulting, Training, Engineering

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: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: xdoc DTD - Do we already have a PUBLIC identifier?

2006-03-31 Thread Lukas Theussl


No, there is none. The DTD is currently only available in SVN, it was 
added in the 1.10 version of the maven-1 xdoc plugin which is not 
released yet. As such, it is still work in progress, so I don't know if 
it's a good idea to publish it at this point. However, as far as I'm 
concerned, the xdoc-1.10 plugin could be released very soon, we will 
consider your demand as soon as it's done (please remind us if we 
forget, I know you are good at that! ;) )


-Lukas


Henning Schmiedehausen wrote:

Hi,

I finally was able to make heads and tails of the xdoc DTD as included
in the maven 1 xdoc plugin (thanks a lot for this, Lukas  Arnaud!) . To
make XMLMind to automatically identify these files, we do need a DTD
public identifier. Do you already have one? Googling for this didn't
really help me here.

If you don't have decided for an identifier, I'd like to propose:

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

as DTD identifier for the XDOC format. As I understand, we then must
make this DTD visible at the designated location, which needs
coordination with the infra people. However, putting it under
www.apache.org means, that the mirror system will pick up these DTDs.

Any opinions? If you agree, you can take a look at
http://wiki.apache.org/jakarta-velocity/EditXdocs

to get my XMLMind hackery for actually editing xdocs (not just painfully
writing them... :-) ).

Best regards
Henning



-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]



Re: xdoc DTD - Do we already have a PUBLIC identifier?

2006-03-31 Thread Arnaud HERITIER
Hi, in fact it's not yet documented but the dtd is already online :
http://maven.apache.org/maven-1.x/plugins/xdoc/maven-xdoc.dtd

cheers

arnaud

On 3/31/06, Lukas Theussl [EMAIL PROTECTED] wrote:


 No, there is none. The DTD is currently only available in SVN, it was
 added in the 1.10 version of the maven-1 xdoc plugin which is not
 released yet. As such, it is still work in progress, so I don't know if
 it's a good idea to publish it at this point. However, as far as I'm
 concerned, the xdoc-1.10 plugin could be released very soon, we will
 consider your demand as soon as it's done (please remind us if we
 forget, I know you are good at that! ;) )

 -Lukas


 Henning Schmiedehausen wrote:
  Hi,
 
  I finally was able to make heads and tails of the xdoc DTD as included
  in the maven 1 xdoc plugin (thanks a lot for this, Lukas  Arnaud!) . To
  make XMLMind to automatically identify these files, we do need a DTD
  public identifier. Do you already have one? Googling for this didn't
  really help me here.
 
  If you don't have decided for an identifier, I'd like to propose:
 
  !DOCTYPE document PUBLIC -//Apache Software Foundation//DTD XDOC 1.0
 //EN
http://www.apache.org/dtds/xdoc_1_0.dtd;
 
  as DTD identifier for the XDOC format. As I understand, we then must
  make this DTD visible at the designated location, which needs
  coordination with the infra people. However, putting it under
  www.apache.org means, that the mirror system will pick up these DTDs.
 
  Any opinions? If you agree, you can take a look at
  http://wiki.apache.org/jakarta-velocity/EditXdocs
 
  to get my XMLMind hackery for actually editing xdocs (not just painfully
  writing them... :-) ).
 
Best regards
Henning
 

 -
 To unsubscribe, e-mail: [EMAIL PROTECTED]
 For additional commands, e-mail: [EMAIL PROTECTED]