HowTo Series Now Available...

Gang:

After much pain and suffering, the long awaited (AREA51) project -- the
HowTo series -- are now (partly -- more coming soon) available.

Currently, you can read HowTos on the following topics (.pdf):

How-to Set up Web Application Support in IntelliJ IDEA

How-to Manage JSP files in IntelliJ IDEA

How-to Create Servlets in IntelliJ IDEA

More HowTos are in the pipeline and will be available in the coming weeks /
months.

In the meantime, if you read them, PLEASE give us feedback (in the forums,
please)-- criticism or compliments welcome!!!!!!!! Suggestions on how to
improve them, AND, on new topics is much appreciated!!!!!!!!!!

David
JetBrains, Inc.
"Develop with pleasure."



24 comments

Sorry, please find the link here:

http://www.intellij.com/docs/

"David Stennett" <david@intellij.com> wrote in message
news:b7hdmn$367$1@is.intellij.net...

Gang:

>

After much pain and suffering, the long awaited (AREA51) project -- the
HowTo series -- are now (partly -- more coming soon) available.

>

Currently, you can read HowTos on the following topics (.pdf):

>

How-to Set up Web Application Support in IntelliJ IDEA

>

How-to Manage JSP files in IntelliJ IDEA

>

How-to Create Servlets in IntelliJ IDEA

>

More HowTos are in the pipeline and will be available in the coming weeks

/

months.

>

In the meantime, if you read them, PLEASE give us feedback (in the forums,
please)-- criticism or compliments welcome!!!!!!!! Suggestions on how to
improve them, AND, on new topics is much appreciated!!!!!!!!!!

>

David
JetBrains, Inc.
"Develop with pleasure."

>
>
>


0

Hi David,

What tool(s) you are using to generate these documents?

Tom

0

PDF factory.... why?

David


"Thomas Singer" <fake@fake.com> wrote in message
news:a8vp9v8eg0vb62rt827q687e8q3ueijje1@4ax.com...

Hi David,

>

What tool(s) you are using to generate these documents?

>

Tom



0

I've thought, you used DocBook and therefore had the hope to share
some experiences.

Tom


"David Stennett" <david@intellij.com> schrieb:

>PDF factory.... why?
>
>David
>
>
>"Thomas Singer" <fake@fake.com> wrote in message
>news:a8vp9v8eg0vb62rt827q687e8q3ueijje1@4ax.com...
>> Hi David,
>>
>> What tool(s) you are using to generate these documents?
>>
>> Tom
>

0

Positive or negative experience? :)
If it's about good tips we would probably consider switching to DocBook...

So, you are welcome :)

Ann Oreshnikova.


"Thomas Singer" <fake@fake.com> wrote in message
news:qfdq9vc7o28ei8kcsdt4dg28q3mj38ijfo@4ax.com...

I've thought, you used DocBook and therefore had the hope to share
some experiences.

>

Tom

>
>

"David Stennett" <david@intellij.com> schrieb:

>

>PDF factory.... why?
>
>David
>
>
>"Thomas Singer" <fake@fake.com> wrote in message
>news:a8vp9v8eg0vb62rt827q687e8q3ueijje1@4ax.com...
>> Hi David,
>>
>> What tool(s) you are using to generate these documents?
>>
>> Tom
>

>


0

Hi Ann,

>Positive or negative experience? :)

Both, but more positive.

>If it's about good tips we would probably consider switching to DocBook...

We are using DocBook for a tutorial (SmartCVS) and ordinary
documentation for approx. 5 month now, so don't call us DocBook
experts.

We've created a DocBook-ANT-framework, so it is simple for developers
to work with it (Ann and David, you aren't developers, isn't it?). If
somebody is interested, I'd like to share it.

Our major reasons, why we had choosen DocBook:
- text based storage: you can read the texts in 5 or 10 years,
- graphics are separated from the text,
- separation of content and appeareance,
- ability to generate pdf (printable) and html documentation,
- platform independence.

We are using the DocBook XML version, because SGML will be history in
a short time and XML is much better supported everywhere. With the
help of free available tools (DocBook XSL and FOP) we are able to
generate html or pdf output. The pdf output is not as good as
expected, because FOP is still in an early state. But one can use
either a commercial FO-renderer or try to go the FO-LaTeX-pdf-way
using DB2LaTeX.

Tom


"Ann Oreshnikova" <pti@intellij.com> schrieb:

>Positive or negative experience? :)
>If it's about good tips we would probably consider switching to DocBook...
>
>So, you are welcome :)
>
>Ann Oreshnikova.
>
>
>"Thomas Singer" <fake@fake.com> wrote in message
>news:qfdq9vc7o28ei8kcsdt4dg28q3mj38ijfo@4ax.com...
>> I've thought, you used DocBook and therefore had the hope to share
>> some experiences.
>>
>> Tom
>>
>>
>> "David Stennett" <david@intellij.com> schrieb:
>>
>> >PDF factory.... why?
>> >
>> >David
>> >
>> >
>> >"Thomas Singer" <fake@fake.com> wrote in message
>> >news:a8vp9v8eg0vb62rt827q687e8q3ueijje1@4ax.com...
>> >> Hi David,
>> >>
>> >> What tool(s) you are using to generate these documents?
>> >>
>> >> Tom
>> >
>>
>

0

Thomas:

Thanks for the info. Actally, those "HowTos" were first written into XML &
XSL, and then converted into Word and HTML and then into .PDF -- we're still
trying to find the "super tool" to work with, so we'll have to check out
DocBook.

You're right, we aren't really "developers" per se, but we can develop (I'm
the least compentent of the docs group in coding Java, JSP, & XML) -- so, if
you've got some special, super-secret methods to pass along, go for it. I
guess it depends on how "good" we gotta be. ;)

We're trying everything, and will soon be deciding on what tool(s) we'll be
sticking with.

Best,

David
JetBrains, Inc.
"Develop with pleasure!"


"Thomas Singer" <fake@fake.com> wrote in message
news:bljq9vgjunrh6n5itqndi0jdrh91fa9t3t@4ax.com...

Hi Ann,

>

>Positive or negative experience? :)

>

Both, but more positive.

>

>If it's about good tips we would probably consider switching to

DocBook...
>

We are using DocBook for a tutorial (SmartCVS) and ordinary
documentation for approx. 5 month now, so don't call us DocBook
experts.

>

We've created a DocBook-ANT-framework, so it is simple for developers
to work with it (Ann and David, you aren't developers, isn't it?). If
somebody is interested, I'd like to share it.

>

Our major reasons, why we had choosen DocBook:
- text based storage: you can read the texts in 5 or 10 years,
- graphics are separated from the text,
- separation of content and appeareance,
- ability to generate pdf (printable) and html documentation,
- platform independence.

>

We are using the DocBook XML version, because SGML will be history in
a short time and XML is much better supported everywhere. With the
help of free available tools (DocBook XSL and FOP) we are able to
generate html or pdf output. The pdf output is not as good as
expected, because FOP is still in an early state. But one can use
either a commercial FO-renderer or try to go the FO-LaTeX-pdf-way
using DB2LaTeX.

>

Tom

>
>

"Ann Oreshnikova" <pti@intellij.com> schrieb:

>

>Positive or negative experience? :)
>If it's about good tips we would probably consider switching to

DocBook...

>
>So, you are welcome :)
>
>Ann Oreshnikova.
>
>
>"Thomas Singer" <fake@fake.com> wrote in message
>news:qfdq9vc7o28ei8kcsdt4dg28q3mj38ijfo@4ax.com...
>> I've thought, you used DocBook and therefore had the hope to share
>> some experiences.
>>
>> Tom
>>
>>
>> "David Stennett" <david@intellij.com> schrieb:
>>
>> >PDF factory.... why?
>> >
>> >David
>> >
>> >
>> >"Thomas Singer" <fake@fake.com> wrote in message
>> >news:a8vp9v8eg0vb62rt827q687e8q3ueijje1@4ax.com...
>> >> Hi David,
>> >>
>> >> What tool(s) you are using to generate these documents?
>> >>
>> >> Tom
>> >
>>
>

>


0

On Wed, 16 Apr 2003 15:00:43 +0400, Ann Oreshnikova wrote:

Positive or negative experience? :) If it's about good tips we would
probably consider switching to DocBook...

So, you are welcome :)


DocBook is the bomb ;) And if you use XXE to edit your documents, even a
clueless tech-writer can be happy :) ( www.xmlmind.com/xmleditor ).

Mark

0

On Thu, 17 Apr 2003 06:50:08 +1200, Mark Derricutt wrote:

DocBook is the bomb ;) And if you use XXE to edit your documents, even a
clueless tech-writer can be happy :) ( www.xmlmind.com/xmleditor ).


Speaking of DocBook - heres an excellent tutorial:

http://supportweb.cs.bham.ac.uk/documentation/tutorials/docsystem/build/tutorials/docbooksys/docbooksyshome.html

0

Are you sure you're not on DocBook's payroll? ;) Will check it out.

D.

"Mark Derricutt" <pinhead@satinism.org> wrote in message
news:pan.2003.04.16.18.50.08.530336@satinism.org...

On Wed, 16 Apr 2003 15:00:43 +0400, Ann Oreshnikova wrote:

>

Positive or negative experience? :) If it's about good tips we would
probably consider switching to DocBook...

>

So, you are welcome :)

>

DocBook is the bomb ;) And if you use XXE to edit your documents, even a
clueless tech-writer can be happy :) ( www.xmlmind.com/xmleditor ).

>

Mark

>


0

Are there any reasonable alternatives to DocBook?

Tom


"David Stennett" <david@intellij.com> schrieb:

>Are you sure you're not on DocBook's payroll? ;) Will check it out.
>
>D.
>
>"Mark Derricutt" <pinhead@satinism.org> wrote in message
>news:pan.2003.04.16.18.50.08.530336@satinism.org...
>> On Wed, 16 Apr 2003 15:00:43 +0400, Ann Oreshnikova wrote:
>>
>> > Positive or negative experience? :) If it's about good tips we would
>> > probably consider switching to DocBook...
>> >
>> > So, you are welcome :)
>>
>> DocBook is the bomb ;) And if you use XXE to edit your documents, even a
>> clueless tech-writer can be happy :) ( www.xmlmind.com/xmleditor ).
>>
>> Mark
>>
>

0

XMLmind rocks the boat. ;) I'm test running it now... pretty impressive.

D.


"Mark Derricutt" <pinhead@satinism.org> wrote in message
news:pan.2003.04.16.18.50.08.530336@satinism.org...

On Wed, 16 Apr 2003 15:00:43 +0400, Ann Oreshnikova wrote:

>

Positive or negative experience? :) If it's about good tips we would
probably consider switching to DocBook...

>

So, you are welcome :)

>

DocBook is the bomb ;) And if you use XXE to edit your documents, even a
clueless tech-writer can be happy :) ( www.xmlmind.com/xmleditor ).

>

Mark

>


0

On Thu, 17 Apr 2003 12:37:32 +0400, David Stennett wrote:

Are you sure you're not on DocBook's payroll? ;) Will check it out.


No ;) Just a rapid advocate ;) I've had enough people complain to me
about the yeckyness of MS Word when dealing with large documents to know
there was something better. Latex was that, but dayam - DocBook is just
nicer.

0

On Thu, 17 Apr 2003 10:46:35 +0200, Thomas Singer wrote:

Are there any reasonable alternatives to DocBook?


Simplified Docbook :)

Or probably Latex.


0

On Thu, 17 Apr 2003 14:11:17 +0400, David Stennett wrote:

XMLmind rocks the boat. ;) I'm test running it now... pretty impressive.


Definitelly. There some 'odd' things you have to get used to thou, as it
IS an XML editor, not a word processor, and not a DocBook editor.

Now, when Idea supports custom editors in the main window, imagine
embedding XMLMind inside... whee ;)

0

On Fri, 18 Apr 2003 13:05:28 +1200, Mark Derricutt wrote:

No ;) Just a rapid advocate ;) I've had enough people complain to me


rabid even :P

0

Is DocBook an editor or a spec. ... I'm a bit confused now... after looking
at Docbook.org...

D.

"Mark Derricutt" <pinhead@satinism.org> wrote in message
news:pan.2003.04.18.01.08.43.431489@satinism.org...

On Thu, 17 Apr 2003 14:11:17 +0400, David Stennett wrote:

>

XMLmind rocks the boat. ;) I'm test running it now... pretty

impressive.
>

Definitelly. There some 'odd' things you have to get used to thou, as it
IS an XML editor, not a word processor, and not a DocBook editor.

>

Now, when Idea supports custom editors in the main window, imagine
embedding XMLMind inside... whee ;)

>


0

On Fri, 18 Apr 2003 14:08:31 +0400, David Stennett wrote:

Is DocBook an editor or a spec. ... I'm a bit confused now... after
looking at Docbook.org...


DocBook is just a set of DTDs and XSLT stylesheets, the DTDs define the
layout of the XML or SGML files that make up your documents/articles. And
there are various tools that work with those files, like the DocBook XSLT
files, which will generate HTML or FO ( to then be used by say Apache FOP
to create a PDF ). Other tools convert the XML sources in LaTeX, which
can then also be turned into PDF.

0

DocBook itself is only a DTD. But DocBook-XSL are the stylesheets to
transform a valid DocBook-document to html, chunked-html, fo (to be
transformed to pdf later), java-help or any other format you want.

XXE is just an XML editor, that it able to handle DocBook-XML files in
a nearly-WYSIWYG way. And, you get it for free.

And the best is, everything can be done with JAVA.

Tom

0

>Simplified Docbook :)

;)

>Or probably Latex.

I used LaTeX to write my diploma, but it does not have separation
between structure and layout.

Tom

0

On Tue, 22 Apr 2003 09:01:09 +0200, Thomas Singer wrote:

I used LaTeX to write my diploma, but it does not have separation between
structure and layout.


I've used LaTeX a little bit, but not terribly much - enough to know I
didn't really like it. At least, not compared to Docbook.

Mark

0

On Tue, 22 Apr 2003 09:01:09 +0200, Thomas Singer wrote:

And the best is, everything can be done with JAVA.


Yep - and tomorrow I should have it integrated into our Anthill build
process for the documents I've started at work.

Anthill rocks, DocBook rocks, IntelliJ rocks :)

0

>... IntelliJ rocks :)

If you mean IDEA instead of IntelliJ, than there is a drop of
bitterness with DocBook: due to issue 7882 you cannot use IDEA to edit
the DocBook XML file.

Tom

0

On Tue, 22 Apr 2003 10:10:24 +0200, Thomas Singer wrote:

If you mean IDEA instead of IntelliJ, than there is a drop of
bitterness with DocBook: due to issue 7882 you cannot use IDEA to edit
the DocBook XML file.


Well - as I use XMLMind's XMLEditor for DocBook that doesn't matter much,
but I'll have to check what the issue actually is :p I see 813's now out
too - yay

Mark

0

Please sign in to leave a comment.