New Volunteer

Hello All !
My name is Brad Smith. I am a DBA, Trainer and Linux Nut. I have been
working on Linux for 3+ years and wandered into this thread because I've
found the documentation for Fedora spotty.

I started by looking for Fedora tutorials and HOWTO's, but am joining to
learn DocBook skills and help write some tutorials I wish I'd found
online.

I have set Cygwin up on the WinBox at work and am finishing install of
OpenJade on my own Server. Are there templates that I can grab from
outside the CVS for the DTD and DocBook for the WinBox? I have
DocBook-xsl-1.60.1 on it now.

I am a newbie at CVS and DocBook creation so please bear with me if some
of my question seem simplistic.

Thanks,

Brad

[Dave Pawson]

At 15:52 16/06/2004, you wrote:
> Hello All !
> My name is Brad Smith. 
Hi Brad.


> I have set Cygwin up on the WinBox at work and am finishing install
> of
> OpenJade on my own Server. Are there templates that I can grab from
> outside the CVS for the DTD and DocBook for the WinBox? I have
> DocBook-xsl-1.60.1 on it now.
>
> I am a newbie at CVS and DocBook creation so please bear with me if some
> of my question seem simplistic. 
We all ask stupid questions at first.
The surprise comes when we start answering them,
thinking we know nothing :)

Gentle suggestion.
Try the xslt docbook stylesheets,
rationale: they are about an order more recent
than the dsssl ones.

Then you don't even need cygwin....
  (or you could use Fedora... and still not need cygwin :-)

regards DaveP

[Karsten Wade]

On Thu, 2004-06-17 at 09:36, Dave Pawson wrote:

>  >I have set Cygwin up on the WinBox at work and am finishing
> install of
>  >OpenJade on my own Server. Are there templates that I can grab from
>  >outside the CVS for the DTD and DocBook for the WinBox? I have
>  >DocBook-xsl-1.60.1 on it now.
>  > 
>    (or you could use Fedora... and still not need cygwin :-) 
It sounds as if you are trying to get part or all of the DocBook
toolchain running under Windows.  While I won't say this is futile, it
will definitely exercise the edges of your sanity.

Instead, have you considered connecting from your Windows OS via PuTTY
(http://www.chiark.greenend.org.uk/~sgtatham/putty/) to a Fedora Core
server with the Authoring and Publishing package group installed (i.e.,
docbook-*, tetex, xmlto, etc.)?  You can edit using 'emacs -nw', build
on the FC server, and publish the pages with Apache to view with your
browser under Windows.

Even the Fedora Core 2 install I have running on a P-200 MMX with 64 MB
RAM will build our documents in reasonable time. :)

hth - Karsten
-- 
Karsten Wade, RHCE, Tech Writer
this .signature subject to random changes
http://people.redhat.com/kwade/
gpg fingerprint: 2680 DBFD D968 3141 0115  5F1B D992 0E06 AD0E 0C41

[Dave Pawson]

At 19:39 17/06/2004, Karsten Wade wrote:


> It sounds as if you are trying to get part or all of the DocBook
> toolchain running under Windows.  While I won't say this is futile, it
> will definitely exercise the edges of your sanity. 
No it won't.
Its easy.
I can do it, so it must be.
I've just had to install jdk 1.4..... something
on Fedora core 1 (how to upgrade???)
Now that is hard!

Anyone like to document how slocate and locate work please?



> Instead, have you considered connecting from your Windows OS via
> PuTTY
> (http://www.chiark.greenend.org.uk/~sgtatham/putty/) to a Fedora Core
> server with the Authoring and Publishing package group installed (i.e.,
> docbook-*, tetex, xmlto, etc.)? 
Now that is hard :-) I do it for a wiki server I have at work.

>    You can edit using 'emacs -nw', 
Oh dear.
   Karsten, that is *really* hard,
when emacs runs on windows so well.

regards DaveP
(don't know why, but defending win32 :-)

[Karsten Wade]

On Thu, 2004-06-17 at 12:51, DaveP wrote:
>  At 19:39 17/06/2004, Karsten Wade wrote:
>  
>  
>  >It sounds as if you are trying to get part or all of the DocBook
>  >toolchain running under Windows.  While I won't say this is futile, it
>  >will definitely exercise the edges of your sanity.
>  
>  No it won't.
>  Its easy.
>  I can do it, so it must be. 
I'll take your word for it.  I don't have any way to try it out.

>  >Instead, have you considered connecting from your Windows OS via
> PuTTY
>  >(http://www.chiark.greenend.org.uk/~sgtatham/putty/) to a Fedora Core
>  >server with the Authoring and Publishing package group installed (i.e.,
>  >docbook-*, tetex, xmlto, etc.)?
>  
>  Now that is hard :-) I do it for a wiki server I have at work. 
What is hard about using PuTTY to run 'make html' at the shell?

>  >   You can edit using 'emacs -nw',
>  
>  Oh dear.
>     Karsten, that is *really* hard,
>  when emacs runs on windows so well. 
Okay, okay, that's fine if Emacs runs well under Windows.  Running Emacs
at the command line is a good thing for an Emacs user to know how to do,
for situations just like this.

I was thinking more about the toolchain.  If it were myself, with a good
running copy of Emacs under Windows, I would still use PuTTY to scp my
XML to the server.

My reasoning for keeping the Fedora docs toolchain running under Fedora
Core is that is where it is designed to run, best to troubleshoot, and
somewhat supportable/fixable.

>  (don't know why, but defending win32 :-) 
I don't either, and not from a value judgment about Windows OSes
position, but because this is not a discussion list about running
DocBook-based tools under Windows.  I didn't want to sound mean and
tyrannical to Brad or any other user who has to exist under Windows, I
just thought a solution that was thematic with the beginning and ending
(FIFO - Fedora in, Fedora out) might make more sense.

cheers - Karsten

-- 
Karsten Wade, RHCE, Tech Writer
this .signature subject to random changes
http://people.redhat.com/kwade/
gpg fingerprint: 2680 DBFD D968 3141 0115  5F1B D992 0E06 AD0E 0C41

[Dave Pawson]

At 00:36 18/06/2004, Karsten Wade wrote:

>  > >Instead, have you considered connecting from your Windows OS
> via PuTTY
>  > >(http://www.chiark.greenend.org.uk/~sgtatham/putty/) to a Fedora Core
>  > >server with the Authoring and Publishing package group installed (i.e.,
>  > >docbook-*, tetex, xmlto, etc.)?
>  >
>  > Now that is hard :-) I do it for a wiki server I have at work.
>
> What is hard about using PuTTY to run 'make html' at the shell? 
I thought you meant running emacs via putty.


> Okay, okay, that's fine if Emacs runs well under Windows. 
Just as well as it does on Linux.


> I was thinking more about the toolchain.  If it were myself, with a
> good
> running copy of Emacs under Windows, I would still use PuTTY to scp my
> XML to the server. 
I dont' know what scp is.
I generally use a local (to windows) tool chain to check that
what I've written is valid, that the resultant html is good etc.
   Final deliverable is XML, so I don't need to use dsssl.


> My reasoning for keeping the Fedora docs toolchain running under
> Fedora
> Core is that is where it is designed to run, best to troubleshoot, and
> somewhat supportable/fixable. 
Is it used only for interim viewing though?
The end result html is built by redhat staff isn't it?


>  > (don't know why, but defending win32 :-)
>
> I don't either, and not from a value judgment about Windows OSes
> position, but because this is not a discussion list about running
> DocBook-based tools under Windows.  I didn't want to sound mean and
> tyrannical to Brad or any other user who has to exist under Windows, I
> just thought a solution that was thematic with the beginning and ending
> (FIFO - Fedora in, Fedora out) might make more sense. 
I guess it depends why you want to style the xml?

regards DaveP