Hiroki Sato | 5 May 2005 10:25
Picon

Re: Problem building pkgsrc guide

Hi,

Thomas Klausner <wiz <at> NetBSD.org> wrote
  in <20050428145308.GI20624 <at> dmath5.geometrie.tuwien.ac.at>:

wi> On Sun, Apr 24, 2005 at 01:00:49AM +0900, Hiroki Sato wrote:
wi> >  In most cases,
wi> >  you do not need to set {SGML,XML}_CATALOG_FILES manually.
wi> 
wi> I was trying (so far without success) to use the psgml-mode in emacs
wi> for editing NetBSD XML files, and setting the variables was one
wi> of the steps I found somewhere.
wi> 
wi> Any hints on how to make this work are very welcome.

 I committed the latest version of textproc/psgml-mode and
 switch-over of the Website DOCTYPE declaration in each htdocs/*.xml files.
 Putting the following lines (with replacing /home/hrs/work/NetBSD/htdocs
 part with a pathname of your htdocs/ tree) into your ~/.emacs file
 should make the psgml-mode work.  Could you try this?

---(cut here)

 (autoload 'sgml-mode "psgml" "Major mode to edit SGML files." t)
 (autoload 'xml-mode "psgml" "Major mode to edit XML files." t)

 (setq sgml-catalog-files '("/usr/pkg/share/sgml/catalog"
                           "/home/hrs/work/NetBSD/htdocs/guide/en/share/catalog"
                           "/home/hrs/work/NetBSD/htdocs/share/xml/catalog"
                           ))
(Continue reading)

Klaus Heinz | 5 May 2005 14:21
Picon

Re: Empezando la traducción de "The NetBSD Guide"

Hugo Rivera wrote:

> I want to start the translation of "The NetBSD Guide" from english to 
> spanish, has anybody already started?.
> I'll wait for an answer for 2 or 3 days.

I would recommend to do that chapter by chapter and make them available
somewhere as you go. This way you may get some feedback (I hope there are
some Spanish readers here and/or on netbsd-docs-es, willing to proofread).

ciao
     Klaus

Mike M. Volokhov | 5 May 2005 15:54
Picon

Re: CVS commit: htdocs/guide/en

On Thu,  5 May 2005 12:21:23 +0000 (UTC)
Hiroki Sato <hrs <at> NetBSD.org> wrote:

[snip commit messages]
> XML markup police:
>  - normalize indent and whitespaces.
>  - remove trailing-whitespaces.

Hiroki-san,

How do you done XML normalization? Is this was powered by some tools or
it was achieved by hand work?

--
Mishka.

Rui Paulo | 5 May 2005 15:53

Re: CVS commit: htdocs/guide/en

On 2005-05-05, Mike M. Volokhov <mishka <at> apk.od.ua> wrote:
> On Thu,  5 May 2005 12:21:23 +0000 (UTC)
> Hiroki Sato <hrs <at> NetBSD.org> wrote:
>
> [snip commit messages]
>> XML markup police:
>>  - normalize indent and whitespaces.
>>  - remove trailing-whitespaces.
>
> Hiroki-san,
>
> How do you done XML normalization? Is this was powered by some tools or
> it was achieved by hand work?

FYI, I asked something similar in www-changes <at> ,
http://mail-index.netbsd.org/www-changes/2005/05/05/0004.html.

--

-- 
Rui Paulo <rpaulo <at> netbsd-pt.org>

Mike M. Volokhov | 5 May 2005 16:31
Picon

Re: CVS commit: htdocs/guide/en

On Thu, 5 May 2005 13:53:06 +0000 (UTC)
Rui Paulo <rpaulo <at> netbsd-pt.org> wrote:

> On 2005-05-05, Mike M. Volokhov <mishka <at> apk.od.ua> wrote:
> > On Thu,  5 May 2005 12:21:23 +0000 (UTC)
> > Hiroki Sato <hrs <at> NetBSD.org> wrote:
> >
> > [snip commit messages]
> >> XML markup police:
> >>  - normalize indent and whitespaces.
> >>  - remove trailing-whitespaces.
> >
> > Hiroki-san,
> >
> > How do you done XML normalization? Is this was powered by some tools or
> > it was achieved by hand work?
> 
> FYI, I asked something similar in www-changes <at> ,
> http://mail-index.netbsd.org/www-changes/2005/05/05/0004.html.

Yes, I've seen this. My questions was addressed to recent discussion
on automatic XML formatting:

http://mail-index.netbsd.org/netbsd-docs/2005/04/20/0004.html

--
Mishka.

Hiroki Sato | 5 May 2005 19:26
Picon

Re: CVS commit: htdocs/guide/en

"Mike M. Volokhov" <mishka <at> apk.od.ua> wrote
  in <20050505165459.484d3fc1.mishka <at> apk.od.ua>:

mi> On Thu,  5 May 2005 12:21:23 +0000 (UTC)
mi> Hiroki Sato <hrs <at> NetBSD.org> wrote:
mi> 
mi> [snip commit messages]
mi> > XML markup police:
mi> >  - normalize indent and whitespaces.
mi> >  - remove trailing-whitespaces.
mi> 
mi> Hiroki-san,
mi> 
mi> How do you done XML normalization? Is this was powered by some tools or
mi> it was achieved by hand work?

 Unfortunately, some are by psgml-mode and some are by hand.
 The most part of the indent normalization is done by psgml-mode and
 an additional function like this:

(defun sgml-normalize-buffer ()
  ""
  (interactive)
  (beginning-of-buffer)
  (delete-trailing-whitespace)
  (while (not (eobp))
    (beginning-of-line)
    (if (not (looking-at "^$"))
	(let ((elem (split-string (funcall sgml-show-context-function (sgml-last-element)) " *in +"))
	      (elem-found 0))
(Continue reading)

Mike M. Volokhov | 6 May 2005 11:02
Picon

Re: CVS commit: htdocs/guide/en

On Fri, 06 May 2005 02:26:24 +0900 (JST)
Hiroki Sato <hrs <at> NetBSD.org> wrote:

> "Mike M. Volokhov" <mishka <at> apk.od.ua> wrote
>   in <20050505165459.484d3fc1.mishka <at> apk.od.ua>:
> 
> mi> On Thu,  5 May 2005 12:21:23 +0000 (UTC)
> mi> Hiroki Sato <hrs <at> NetBSD.org> wrote:
> mi> 
> mi> [snip commit messages]
> mi> > XML markup police:
> mi> >  - normalize indent and whitespaces.
> mi> >  - remove trailing-whitespaces.
> mi> 
> mi> Hiroki-san,
> mi> 
> mi> How do you done XML normalization? Is this was powered by some tools or
> mi> it was achieved by hand work?
> 
>  Unfortunately, some are by psgml-mode and some are by hand.
[snip]

Oh my! 

>  The newline and whitespace normalization can partially be done by
>  xmlformat but needs some additional tweaks by hand because xmlformat
>  cannot control line-breaks of inline element and indentation of
>  #PCDATA.

Hmmm... I'm not sure I've understand you properly, because AFAIK
(Continue reading)

Mike M. Volokhov | 6 May 2005 17:56
Picon

Location of NetBSD DTDs

Greetings!

After all, most XML documents on web-site are declared within following
identifier:

<!DOCTYPE webpage PUBLIC "-//NetBSD//DTD Website-based NetBSD Extension//EN"
	"http://www.NetBSD.org/XML/htdocs/lang/share/xml/website-netbsd.dtd">

But specified path to DTD is not available. Is this correct? Or it (and
all descending paths) should be fixed to the:

	"http://www.NetBSD.org/share/xml/website-netbsd.dtd"

Possible I've missing something?

--
Kind regards,
Mishka.
Hiroki Sato | 6 May 2005 19:49
Picon

Re: CVS commit: htdocs/guide/en

"Mike M. Volokhov" <mishka <at> apk.od.ua> wrote
  in <20050506120242.4b6ce58e.mishka <at> apk.od.ua>:

mi> On Fri, 06 May 2005 02:26:24 +0900 (JST)
mi> Hiroki Sato <hrs <at> NetBSD.org> wrote:
mi> >  The newline and whitespace normalization can partially be done by
mi> >  xmlformat but needs some additional tweaks by hand because xmlformat
mi> >  cannot control line-breaks of inline element and indentation of
mi> >  #PCDATA.
mi> 
mi> Hmmm... I'm not sure I've understand you properly, because AFAIK
mi> xmlformat can do indent #PCDATA (with normalize & subindent). If some
mi> content is disallowed to change (like <screen>), it must not be
mi> indented as well.
mi> 
mi> Excuse me again, what exactly you meant about "control line-breaks of
mi> inline element"?

 Ah, sorry for the confusion.  I got the wrong idea about xmlformat.
 I thought that it cannot realize a format like <foo>text</foo>
 when format=block is specified (it can be done with normalize=yes,
 format=block, entry-break=0, exit-break=0, element-break=2).

 The diff for your netbsd.xmlformat is attached.  This is close to
 the rules I described in the previous mail.

--

-- 
| Hiroki SATO
(Continue reading)

Hiroki Sato | 6 May 2005 20:29
Picon

Re: Location of NetBSD DTDs

"Mike M. Volokhov" <mishka <at> apk.od.ua> wrote
  in <20050506185608.2f10b61a.mishka <at> apk.od.ua>:

mi> But specified path to DTD is not available. Is this correct? Or it (and
mi> all descending paths) should be fixed to the:
mi> 
mi> 	"http://www.NetBSD.org/share/xml/website-netbsd.dtd"
mi> 
mi> Possible I've missing something?

 I intentionally choose the different prefix from ones used in
 the webpages in www.NetBSD.org.  This is because the URI in the
 doctype declaration is used as a namespace and actually it
 has nothing to do with the WWW server.  This URI is resolved by XML
 catalogs in htdocs/share/xml/catalog-common.xml and
 htdocs/share/xml/catalog.xml and then always points one of
 local files.

 This resolution provides some sort of flexibility and consistency
 which is especially useful for localization.  For example,
 "/lang/" in the URI can be replaced with language name such as
 "/de/" by using an additional XML catalog for German, without modification
 of XML files themselves.  I am planning to implement separation of
 localized part of XSLT stylesheets and entity sets with this
 mechanism (and eliminate DOCLANG hack).

--

-- 
| Hiroki SATO

Gmane