docbook-apps

Hi devs :

I tried to integrate DocBook-xsl sheets and XSLT-processor with "GNU Emacs
23.3.1" test editor in Ubuntu-11.10 .
First I installed "GNU Emacs"[0] by using Ubuntu Software Center in
Ubuntu-11.10.
Then I followed the steps that are given in "How to setup GNU Emacs/XEmacs
for DocBook editing and processing" [1].
According to steps which are provided, I installed "PSGML"[2] and XSLT
processor[3] via Ubuntu Software Center.
After placing "DocBook XSL" into /usr/local/share , I tried for the third
step.
But as mentioned in the document GNU Emacs editor doesn't ask for the
directory where the DocBook package is installed.
I don't know whether this tutorial is concern about "XEmacs". Can any one
help me to get out of this?.

Is there any text editor preferred by DocBook-devs ?.


[0]. http://www.gnu.org/software/emacs/
[1]. http://xslt-process.sourceforge.net/docbook.php
[2]. http://sourceforge.net/projects/psgml/
[3]. http://xmlsoft.org/xslt/

-- regards
Gihan Chanuka
University of Moratuwa
Sri Lanka

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi Gihan,
For writing DocBook 5.x, with emacs you want nxml mode [1]. PSGML mode
is for editing DTD-based DocBook 4.x docs.

I don't see a real need for connecting the xsls to emacs since there
are any number of ways to set up a build and in a continuous
integration scenario you don't want it tied to your editor anyway.

If you want a slick, IDE-like experience that has everything built in,
try the oXygen XML Editor [2].

Regards,
David

[1] http://www.thaiopensource.com/nxml-mode/
[2] http://www.oxygenxml.com/

On 03/19/2012 08:38 AM, gihan karunarathne wrote:
> Hi devs :
>
> I tried to integrate DocBook-xsl sheets and XSLT-processor with
> "GNU Emacs 23.3.1" test editor in Ubuntu-11.10 . First I installed
> "GNU Emacs"[0] by using Ubuntu Software Center in Ubuntu-11.10.
> Then I followed the steps that are given in "How to setup GNU
> Emacs/XEmacs for DocBook editing and processing"[1]. According to
> steps which are provided, I installed "PSGML"[2] and XSLT
> processor[3] via Ubuntu Software Center. After placing "DocBook
> XSL" into /usr/local/share , I tried for the third step. But as
> mentioned in the document GNU Emacs editor doesn't ask for the
> directory where the DocBook package is installed. I don't know
> whether this tutorial is concern about "XEmacs". Can any one help
> me to get out of this?.
>
> Is there any text editor preferred by DocBook-devs ?.
>
>
> [0]. http://www.gnu.org/software/emacs/ [1].
> http://xslt-process.sourceforge.net/docbook.php [2].
> http://sourceforge.net/projects/psgml/ [3].
> http://xmlsoft.org/xslt/
>
> -- regards Gihan Chanuka University of Moratuwa Sri Lanka
>

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJPZ/b5AAoJEMHeSXG7afUhTfIH/2pEDNjmI7+ueAGetjWRsG8+
K4pyjir661R4pW4fHGg65+lCS66euGYgrnXL0Sji2s7LZ7mwIyzJCdu+cnZFlvSh
eFSkdtZgYj8iB0BpAUFqvQHulM9dQkf+Xzqp16hr96Z1oITQNG7TXBD+pb0pcpRf
TurzUkarDYnnx6/dJ9e1qdLVB+AZtSjvdNSnexzav6+/FZZnKqfBXYFlnhWXSO0o
V/WDu8BZLF3pViFzHnmbgdsIZizsPdWO9n92tRujH1be7vOhZ0rken7NNpzLDK8l
PQhvtbQsmbejRSS98YYq2524VDKU74RjBT9eiQ58BCcSr96PkbL8+1P7/8/nojQ=
=UTv+
-----END PGP SIGNATURE-----

Hi David :

Thank you David !. I tried with oXygen XML Editor. But it is
a commercial version. I tried to integrate XSLs with XSLT processor because
of it mentioned in DocBook of Ubuntu community documentation [0]. Also it
give set of *DocBook Editors* [1]. I tried for one of them. I installed
JEdit text editor [2] instead of emacs and post a blog if any one
interesting about it [3].
I want to know about a text editor which helpful for end users to build
their DocBook documents and simply convert into given type of output format
just by clicking a button. Also developers can use it for test purposes.
I don't know whether that kind of idea is out of the vision of DocBook.

I mean, I have a simple idea about a DocBook editor like user can edit s/he
document with out using any tags of DocBook. That will improve the
usability of DocBook to the end users and also end users can do their
documentation with exposing to underline complexity of having tags and
other technical things.
As an example, every time I blogging with blogspot.com, this idea get into
my mind. In blogspot, the post editor allow bloggers(end users) to do their
documentation with two options.
One method is do the documentation with simply typing and add decorations
via tools (actually those add tags).
Second method is allowing to edit using XHTML tags. I hope that you get my
point.
Is there such kind of solution in DocBook project ?.

Thank you !.

[0] .https://help.ubuntu.com/community/DocBook
[1]. https://help.ubuntu.com/community/DocBookEditors
[2]. http://www.jedit.org/index.php?page=quickstart
[3].
http://resourceoptimism.blogspot.com/2012/03/how-to-installconfigure-jedit-text.html

On Tue, Mar 20, 2012 at 8:48 AM, David Cramer <david@thingbag.net> wrote:

> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> Hi Gihan,
> For writing DocBook 5.x, with emacs you want nxml mode [1]. PSGML mode
> is for editing DTD-based DocBook 4.x docs.
>
> I don't see a real need for connecting the xsls to emacs since there
> are any number of ways to set up a build and in a continuous
> integration scenario you don't want it tied to your editor anyway.
>
> If you want a slick, IDE-like experience that has everything built in,
> try the oXygen XML Editor [2].
>
> Regards,
> David
>
> [1] http://www.thaiopensource.com/nxml-mode/
> [2] http://www.oxygenxml.com/
>
> --
Regards

Gihan Chanuka Karunarathne
Department of Computer Science and Engineering

University of Moratuwa
Sri Lanka


Twitter: https://twitter.com/#!/gihanchanuka
LinkedIn: http://lk.linkedin.com/pub/gihan-karunarathne/25/ba3/993

Hi David :

I'm sorry for not considering about your recommendation.
When I'm going to download oXygen first time, in download page it says that
it a commercial software. Because of I want to get familiar with some thing
which can be used long period of time and I found some DocBook Editors[0]
then I tend to use one of them.
But after saw the reply that you sent to Visitha Baddegama's post about
'About DocBook webhelp project', I get attention towards oXygen and it also
provides a free trial. So, I download it and used to make .html
using integrated DocBook style sheet.

On Tue, Mar 20, 2012 at 8:48 AM, David Cramer <david@thingbag.net> wrote:

> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> Hi Gihan,
> For writing DocBook 5.x, with emacs you want nxml mode [1]. PSGML mode
> is for editing DTD-based DocBook 4.x docs.
>
> I don't see a real need for connecting the xsls to emacs since there
> are any number of ways to set up a build and in a continuous
> integration scenario you don't want it tied to your editor anyway.
>
> If you want a slick, IDE-like experience that has everything built in,
> try the oXygen XML Editor [2].
>

Actually that is a magnificent editor as you said. It already has the
features that I'm dreaming about.

Thank you very much !.

>
> Regards,
> David
>
> [1] http://www.thaiopensource.com/nxml-mode/
> [2] http://www.oxygenxml.com/


[0]. https://help.ubuntu.com/community/DocBookEditors

--
Regards

Gihan Chanuka Karunarathne
Department of Computer Science and Engineering

University of Moratuwa
Sri Lanka


Twitter: https://twitter.com/#!/gihanchanuka
LinkedIn: http://lk.linkedin.com/pub/gihan-karunarathne/25/ba3/993

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

No problem. I'm sure it's possible to get that xslt integration with
emacs working, but I haven't done it so I can't help you. Oxygen is a
good way to get the feel for things without much setup. In the long
term, you will find your own preferred way of working.

I tend to keep my build environment loosely coupled to the authoring
environment (maybe a button that launches an ant script or launches a
maven build). My feeling is that if you put your build logic in the
editor's scripting interface then it's more difficult to set builds
using a continuous integration server. Why would you want to have to
install an editor on your build machine just to build you docs?

David

On 03/21/2012 01:13 PM, gihan karunarathne wrote:
> Hi David :
>
> I'm sorry for not considering about your recommendation. When I'm
> going to download oXygen first time, in download page it says that
> it a commercial software. Because of I want to get familiar with
> some thing which can be used long period of time and I found some
> DocBook Editors[0] then I tend to use one of them. But after saw
> the reply that you sent to Visitha Baddegama's post about 'About
> DocBook webhelp project', I get attention towards oXygen and it
> also provides a free trial. So, I download it and used to make
> .html using integrated DocBook style sheet.
>
> On Tue, Mar 20, 2012 at 8:48 AM, David Cramer <david@thingbag.net
> <mailto:david@thingbag.net>> wrote:
>
> -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
>
> Hi Gihan, For writing DocBook 5.x, with emacs you want nxml mode
> [1]. PSGML mode is for editing DTD-based DocBook 4.x docs.
>
> I don't see a real need for connecting the xsls to emacs since
> there are any number of ways to set up a build and in a continuous
> integration scenario you don't want it tied to your editor
> anyway.
>
> If you want a slick, IDE-like experience that has everything built
> in, try the oXygen XML Editor [2].
>
>
> Actually that is a magnificent editor as you said. It already has
> the features that I'm dreaming about.
>
> Thank you very much !.
>
>
> Regards, David
>
> [1] http://www.thaiopensource.com/nxml-mode/ [2]
> http://www.oxygenxml.com/
>
>
> [0]. https://help.ubuntu.com/community/DocBookEditors
>
> -- Regards
>
> Gihan Chanuka Karunarathne Department of Computer Science and
> Engineering
>
> University of Moratuwa Sri Lanka
>
>
> Twitter: https://twitter.com/#!/gihanchanuka LinkedIn:
> http://lk.linkedin.com/pub/gihan-karunarathne/25/ba3/993
>
>

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJPai+2AAoJEMHeSXG7afUhQ5kH/jZfnfdJj6B1o5n6OY64wF/A
QuQW87xA3pLmDNhfRz3103CB9BOmME+dyygOLW7xRVCj8B8QFoxc11uNKv6BxSge
gID3bDWBK32nKq8A3sOcVcB+udYfLjGjMXvANAaDGQERZtklQBXXVQmw4krVYsbp
3jc4Ethw9oB+dp/cFluXiIOF6yHreLbVHMIt05d1EZhz+sRn5T2uBE27odgV7ieG
dr0064xugV/XzOT+/2opU6KtASSUVZxbYZoFH5ua48H0QvZJ6vVQZFCyf2QYas1b
eNVs2UIqzSTq46w4StDGr8tC0VmbLFYdah6A2wfHjNAOtbe7qG/xglzqE7HW+OM=
=sNFb
-----END PGP SIGNATURE-----