docbook-apps

Expand all | Collapse all

WYSIWYG Editor for docbook

  • 1.  WYSIWYG Editor for docbook

    Posted 08-12-2012 22:06
    In a previous project I used docbook 4 to create help text for an
    application which I then used it to generate html and Javahelp. The
    generation worked very well but I found it very difficult writing the
    help text embedded within the docbook tags, it wasn't until the final
    output was generated that I could see my typos and generally bad english.

    So considering using docbook v5 for a new project but is there a WYSIWYG
    editor/plugin available, i.e create help text in word/open office type
    program but am able to save it in docbook format ?

    Paul



  • 2.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-12-2012 22:42
    Paul,

    There are a bunch of very good visual editors out there that will handle DocBook. The one I know best is Oxygen (http://www.oxygenxml.com/), which works very well with DocBook.

    Best Regards,
    Dick Hamilton
    -------
    XML Press
    XML for Technical Communicators
    http://xmlpress.net
    hamilton@xmlpress.net



    On Aug 12, 2012, at 3:05 PM, Paul Taylor wrote:

    > In a previous project I used docbook 4 to create help text for an application which I then used it to generate html and Javahelp. The generation worked very well but I found it very difficult writing the help text embedded within the docbook tags, it wasn't until the final output was generated that I could see my typos and generally bad english.
    >
    > So considering using docbook v5 for a new project but is there a WYSIWYG editor/plugin available, i.e create help text in word/open office type program but am able to save it in docbook format ?
    >
    > Paul
    >
    > ---------------------------------------------------------------------
    > To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
    > For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
    >




  • 3.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-12-2012 23:10
    On 12/08/2012 23:41, Richard Hamilton wrote:
    > Paul,
    >
    > There are a bunch of very good visual editors out there that will handle DocBook. The one I know best is Oxygen (http://www.oxygenxml.com/), which works very well with DocBook.
    >
    > Best Regards,
    > Dick Hamilton
    > -------
    > XML Press
    > XML for Technical Communicators
    > http://xmlpress.net
    > hamilton@xmlpress.net
    Goodness, this product is well overpriced

    http://www.oxygenxml.com/buy.html?utm_expid=4313807-0&utm_referrer=http%3A%2F%2Fwww.oxygenxml.com%2Fxml_developer.html

    Paul
    >
    >
    > On Aug 12, 2012, at 3:05 PM, Paul Taylor wrote:
    >
    >> In a previous project I used docbook 4 to create help text for an application which I then used it to generate html and Javahelp. The generation worked very well but I found it very difficult writing the help text embedded within the docbook tags, it wasn't until the final output was generated that I could see my typos and generally bad english.
    >>
    >> So considering using docbook v5 for a new project but is there a WYSIWYG editor/plugin available, i.e create help text in word/open office type program but am able to save it in docbook format ?
    >>
    >> Paul
    >>
    >> ---------------------------------------------------------------------
    >> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
    >> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
    >>
    >




  • 4.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-13-2012 17:05
    On 8/12/2012 5:10 PM, Paul Taylor wrote:
    > On 12/08/2012 23:41, Richard Hamilton wrote:
    >>
    >> There are a bunch of very good visual editors out there that will
    >> handle DocBook. The one I know best is Oxygen
    >> (http://www.oxygenxml.com/), which works very well with DocBook.
    >>
    > Goodness, this product is well overpriced

    If you're looking at it as a DocBook word processor, sure. But oXygen
    does quite a bit more than that. Check out the feature matrix:

    http://www.oxygenxml.com/feature_matrix.html

    oXygen Author is priced appropriately for what it is: a piece of a high
    end publication system.

    Not that I'm trying to arm-twist you into buying it. I, too, would be
    happy to see a plain "word processor for DocBook."

    That is, something without a lot of formatting power, which simply
    happened to use .dbx to store its data. The main difference between
    such a program and a "normal" word processor would flow from DocBook's
    content vs. presentation separation: it would do a lot more to force you
    toward styles rather than ad hoc formatting, and you wouldn't have the
    option of things like free-floating layout frames. I think to get a low
    price like you're looking for, you'd also have to give up on the ability
    to edit stylesheets.

    There's kind of a slippery slope here, the sort that caused the desktop
    databases most PC users had in the 80s to disappear:

    o People keep pushing the tool to do vastly more complicated things
    than the tool was designed for.

    o The developers add features to address the demand.

    o The tool becomes too complicated for normals to understand so
    demand from that quarter drops off.

    o The developer raises the prices and shoots for the high end market.

    What you get is a world where people believe Excel is a database, and
    {insert favorite text editor here} is a DocBook editor.



  • 5.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-13-2012 19:12
    On 13/08/2012 18:04, Warren Young wrote:
    > On 8/12/2012 5:10 PM, Paul Taylor wrote:
    >> On 12/08/2012 23:41, Richard Hamilton wrote:
    >>>
    >>> There are a bunch of very good visual editors out there that will
    >>> handle DocBook. The one I know best is Oxygen
    >>> (http://www.oxygenxml.com/), which works very well with DocBook.
    >>>
    >> Goodness, this product is well overpriced
    >
    > If you're looking at it as a DocBook word processor, sure. But oXygen
    > does quite a bit more than that. Check out the feature matrix:
    >
    > http://www.oxygenxml.com/feature_matrix.html
    >
    > oXygen Author is priced appropriately for what it is: a piece of a
    > high end publication system.
    Compared to top notch Java IDE (Jetbrains) or top-notch java profiler
    (YOurkit) I think the price is expensive. It may have a vast feature
    matrix, but it is essentially an Xml Editor/Processor I doubt many
    customers use the majority of features.
    But I guess this discussion is offtopic.

    Paul



  • 6.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-14-2012 11:39
    Hi Paul,

    Usually commercial WYSIWYG XML Editors are in a certain price range.
    We are at the lower bound of that range. We cannot go lower because we
    consider the editor is worth the price.

    For academic organizations (like universities) or for people who want to
    learn XML our price is very low: $64 for the XML Editor which includes
    both visual editing and XSLT and schema developing tools.

    Regards,
    Radu

    Radu Coravu
    <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
    http://www.oxygenxml.com

    On 8/13/2012 10:12 PM, Paul Taylor wrote:
    > On 13/08/2012 18:04, Warren Young wrote:
    >> On 8/12/2012 5:10 PM, Paul Taylor wrote:
    >>> On 12/08/2012 23:41, Richard Hamilton wrote:
    >>>>
    >>>> There are a bunch of very good visual editors out there that will
    >>>> handle DocBook. The one I know best is Oxygen
    >>>> (http://www.oxygenxml.com/), which works very well with DocBook.
    >>>>
    >>> Goodness, this product is well overpriced
    >>
    >> If you're looking at it as a DocBook word processor, sure. But oXygen
    >> does quite a bit more than that. Check out the feature matrix:
    >>
    >> http://www.oxygenxml.com/feature_matrix.html
    >>
    >> oXygen Author is priced appropriately for what it is: a piece of a
    >> high end publication system.
    > Compared to top notch Java IDE (Jetbrains) or top-notch java profiler
    > (YOurkit) I think the price is expensive. It may have a vast feature
    > matrix, but it is essentially an Xml Editor/Processor I doubt many
    > customers use the majority of features.
    > But I guess this discussion is offtopic.
    >
    > Paul
    >
    > ---------------------------------------------------------------------
    > To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
    > For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
    >




  • 7.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-13-2012 17:12
    On 8/12/2012 4:41 PM, Richard Hamilton wrote:
    >
    > There are a bunch of very good visual editors out there that will
    > handle DocBook. The one I know best is Oxygen
    > (http://www.oxygenxml.com/), which works very well with DocBook.

    The last time I tried opening one of my DocBook manuals with it (version
    9, maybe?) it didn't handle XML Includes gracefully.

    I like to have a top-level document that simply includes all the chapter
    files, which lets me edit the chapters individually. This keeps file
    sizes reasonable and (much more important) localizes VCS comments to the
    relevant section of the document.

    As I recall, oXygen sort of kind of attempted to open the top-level
    document, but didn't give me the seamless WYSIWYG view I expected: an
    editable version of the final PDF output. If instead I opened an
    individual chapter file, it got confused by the cross-references, since
    it didn't understand that it was looking at a tree in a forest.

    Have they fixed this limitation, or does it still push you toward
    putting the entire document in a single file?



  • 8.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-13-2012 17:42


    Kind of.

    If you like me use a master file with XInclude:s it takes
    a "trick" to get Oxygens to resolve all references and then it
    works
    really well. This "trick" has been available for quite some
    time/versions - but it is not obvious.

    You have to add all includes as
    files in the validation schema. Then assign the validation schema to all
    included modules.

    Having done that it will be possible to handle XML
    includes as expected, all ref:s in all moduels can be
    resolved by
    auto-completion. Unfortunately the recenet addition of master file in
    Oxygen (which I thought would handle this)
    does not seem to work this
    way for plain XML files (at least I didn't get it to work). It works
    fine for XSLT stylesheets though.

    In regards to the comments about
    price for Oxygen I would say that it is very reasonable priced given

    its capabilities and the speed up it will make in the writing of XML
    (and XSLT stylesheets). It would be very easy to motivate
    its cost in a
    business setting. Of course, for a hobbyist it would be harder but I
    believe Oxygen also has a very cheap
    "hobbyist not-for-profit" license
    that is less than US $100

    Just my 2c

    /J

    On 2012-08-13 19:11,
    Warren Young wrote:

    > On 8/12/2012 4:41 PM, Richard Hamilton wrote:
    >

    >> There are a bunch of very good visual editors out there that will
    handle DocBook. The one I know best is Oxygen (http://www.oxygenxml.com/
    [1]), which works very well with DocBook.
    >
    > The last time I tried
    opening one of my DocBook manuals with it (version
    > 9, maybe?) it
    didn't handle XML Includes gracefully.
    >
    > I like to have a top-level
    document that simply includes all the chapter
    > files, which lets me
    edit the chapters individually. This keeps file
    > sizes reasonable and
    (much more important) localizes VCS comments to the
    > relevant section
    of the document.
    >
    > As I recall, oXygen sort of kind of attempted to
    open the top-level
    > document, but didn't give me the seamless WYSIWYG
    view I expected: an
    > editable version of the final PDF output. If
    instead I opened an
    > individual chapter file, it got confused by the
    cross-references, since
    > it didn't understand that it was looking at a
    tree in a forest.
    >
    > Have they fixed this limitation, or does it still
    push you toward
    > putting the entire document in a single file?
    >
    >
    ---------------------------------------------------------------------
    >
    To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
    >
    For additional commands, e-mail:
    docbook-apps-help@lists.oasis-open.org



    Links:
    ------
    [1]
    http://www.oxygenxml.com/



  • 9.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-13-2012 20:39
    I don't understand this xinclude problem with oxygen. Oxygen has been
    handling my xincludes, and nested xincludes, seamlessly from versions
    around 7 or 8 at least. There was a base problem with the earlier
    versions (back to v.2 in my experience) - see this list about 5 or 6
    years ago which gave trouble with xinclude nesting, but as far as I know
    that has been sorted out. I don't use any 'tricks'. I just loaded v.14
    on a new machine and it all worked straight out of the box on nested
    xincludes.

    On 13/08/2012 12:42, Johan Persson wrote:
    > Kind of.
    >
    > If you like me use a master file with XInclude:s it takes a "trick" to
    > get Oxygens to resolve all references and then it works
    > really well. This "trick" has been available for quite some
    > time/versions - but it is not obvious.
    >
    > You have to add all includes as files in the validation schema. Then
    > assign the validation schema to all included modules.
    >
    > Having done that it will be possible to handle XML includes as expected,
    > all ref:s in all moduels can be
    > resolved by auto-completion. Unfortunately the recenet addition
    > of master file in Oxygen (which I thought would handle this)
    > does not seem to work this way for plain XML files (at least I didn't
    > get it to work). It works fine for XSLT stylesheets though.
    >
    > In regards to the comments about price for Oxygen I would say that it is
    > very reasonable priced given
    > its capabilities and the speed up it will make in the writing of XML
    > (and XSLT stylesheets). It would be very easy to motivate
    > its cost in a business setting. Of course, for a hobbyist it would be
    > harder but I believe Oxygen also has a very cheap
    > "hobbyist not-for-profit" license that is less than US $100
    >
    > Just my 2c
    >
    > /J
    >
    > On 2012-08-13 19:11, Warren Young wrote:
    >
    >> On 8/12/2012 4:41 PM, Richard Hamilton wrote:
    >>> There are a bunch of very good visual editors out there that will
    >>> handle DocBook. The one I know best is Oxygen
    >>> (http://www.oxygenxml.com/), which works very well with DocBook.
    >> The last time I tried opening one of my DocBook manuals with it (version
    >> 9, maybe?) it didn't handle XML Includes gracefully.
    >>
    >> I like to have a top-level document that simply includes all the chapter
    >> files, which lets me edit the chapters individually. This keeps file
    >> sizes reasonable and (much more important) localizes VCS comments to the
    >> relevant section of the document.
    >>
    >> As I recall, oXygen sort of kind of attempted to open the top-level
    >> document, but didn't give me the seamless WYSIWYG view I expected: an
    >> editable version of the final PDF output. If instead I opened an
    >> individual chapter file, it got confused by the cross-references, since
    >> it didn't understand that it was looking at a tree in a forest.
    >>
    >> Have they fixed this limitation, or does it still push you toward
    >> putting the entire document in a single file?
    >>
    >> ---------------------------------------------------------------------
    >> To unsubscribe, e-mail:docbook-apps-unsubscribe@lists.oasis-open.org <mailto:docbook-apps-unsubscribe@lists.oasis-open.org>
    >> For additional commands, e-mail:docbook-apps-help@lists.oasis-open.org <mailto:docbook-apps-help@lists.oasis-open.org>
    >>

    --
    ron@catterall.net



  • 10.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-15-2012 05:24


    (This is a bit off-topic but I'm staying in thread since it might be
    of interest to the docbook community)

    Now I'm curious :-)

    If you
    create a master document which (x)includes a bunch of files, say
    chapters, in Oxygen it will
    work in the Author view, i.e. showing the
    complete document allowing you to navigate around.

    However, the
    problem is that if you are in say, "Chapter 1" then the auto-completion
    (in the
    attribute view) for say "xlink:href" will not (at least not for
    me) populate the dropdown list in the
    attribute view with "xml:id" that
    has been defined outside the current file, say in "Chapter 2".

    The
    only way I found to fix this is to add all files in the project as files
    in the validation configuration then
    the autocompletiong will find all
    defined "xml:id"'s in all files.

    /J

    On 2012-08-13 22:38, Ron
    Catterall wrote:

    > I don't understand this xinclude problem with
    oxygen. Oxygen has been
    > handling my xincludes, and nested xincludes,
    seamlessly from versions
    > around 7 or 8 at least. There was a base
    problem with the earlier
    > versions (back to v.2 in my experience) -
    see this list about 5 or 6
    > years ago which gave trouble with xinclude
    nesting, but as far as I know
    > that has been sorted out. I don't use
    any 'tricks'. I just loaded v.14
    > on a new machine and it all worked
    straight out of the box on nested
    > xincludes.
    >
    > On 13/08/2012
    12:42, Johan Persson wrote:
    >
    >> Kind of. If you like me use a master
    file with XInclude:s it takes a "trick" to get Oxygens to resolve all
    references and then it works really well. This "trick" has been
    available for quite some time/versions - but it is not obvious. You have
    to add all includes as files in the validation schema. Then assign the
    validation schema to all included modules. Having done that it will be
    possible to handle XML includes as expected, all ref:s in all moduels
    can be resolved by auto-completion. Unfortunately the recenet addition
    of master file in Oxygen (which I thought would handle this) does not
    seem to work this way for plain XML files (at least I didn't get it to
    work). It works fine for XSLT stylesheets though. In regards to the
    comments about price for Oxygen I would say that it is very reasonable
    priced given its capabilities and the speed up it will make in the
    writing of XML (and XSLT stylesheets). It would be very easy to motivate
    its cost in a business setting. Of course, for a hobbyist it would be
    harder but I believe Oxygen also has a very cheap "hobbyist
    not-for-profit" license that is less than US $100 Just my 2c /J On
    2012-08-13 19:11, Warren Young wrote:
    >>
    >>> On 8/12/2012 4:41 PM,
    Richard Hamilton wrote:
    >>>
    >>>> There are a bunch of very good visual
    editors out there that will handle DocBook. The one I know best is
    Oxygen (http://www.oxygenxml.com/ [1]), which works very well with
    DocBook.
    >>> The last time I tried opening one of my DocBook manuals
    with it (version 9, maybe?) it didn't handle XML Includes gracefully. I
    like to have a top-level document that simply includes all the chapter
    files, which lets me edit the chapters individually. This keeps file
    sizes reasonable and (much more important) localizes VCS comments to the
    relevant section of the document. As I recall, oXygen sort of kind of
    attempted to open the top-level document, but didn't give me the
    seamless WYSIWYG view I expected: an editable version of the final PDF
    output. If instead I opened an individual chapter file, it got confused
    by the cross-references, since it didn't understand that it was looking
    at a tree in a forest. Have they fixed this limitation, or does it still
    push you toward putting the entire document in a single file?
    --------------------------------------------------------------------- To
    unsubscribe, e-mail:docbook-apps-unsubscribe@lists.oasis-open.org [2]
    docbook-apps-unsubscribe@lists.oasis-open.org> For additional commands,
    e-mail:docbook-apps-help@lists.oasis-open.org
    [3]docbook-apps-help@lists.oasis-open.org>
    >
    > -- ron@catterall.net




    Links:
    ------
    [1] http://www.oxygenxml.com/
    [2]
    mailto:docbook-apps-unsubscribe@lists.oasis-open.org
    [3]
    mailto:docbook-apps-help@lists.oasis-open.org



  • 11.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-15-2012 07:20
      |   view attached
    Hi Johan,

    You are using Docbook 5 (as you were mentioning xml:ids).

    If it is Relax NG or XML Schema based:

    Basically in order to propose you the entire list of IDREFs Oxygen needs
    to validate the master document (which xi:includes all modules) instead
    of the module which is opened.
    So when working on the module (chapter) you can create a validation
    scenario which validates the master XML document with the default engine.
    This should be enough for the content completion to propose you all IDs.

    But if you are using Docbook 5 DTD-based (and you probably are):
    Oxygen uses Xerces for validation and when parsing XML files with
    associated DTD schemas Xerces will parse and validate the XML document
    before the xi:include's are resolved. Because of this the gathered IDs
    will also be incomplete, even if the master file is validated instead.
    So this is probably your case, you had to add validation units for each
    of the module in order to parse them all and gather IDs.
    We know about this limitation and we'll try to remove it in a future
    version.

    Bu the way, good new, in Oxygen 14.1 the actions for inserting xrefs and
    links in the Author page will be more evolved, they will show a dialog
    which will allow you to quick find a reference ID. Please see the
    attached image.
    And yes, if you choose to insert from the master file, all IDs from all
    xi:includes will be collected and presented for intertion.

    Regards,
    Radu

    Radu Coravu
    <oxygen></oxygen> XML Editor, Schema Editor and XSLT Editor/Debugger
    http://www.oxygenxml.com

    On 8/15/2012 8:24 AM, Johan Persson wrote:
    > (This is a bit off-topic but I'm staying in thread since it might be of
    > interest to the docbook community)
    >
    > Now I'm curious :-)
    >
    > If you create a master document which (x)includes a bunch of files, say
    > chapters, in Oxygen it will
    > work in the Author view, i.e. showing the complete document allowing you
    > to navigate around.
    >
    > However, the problem is that if you are in say, "Chapter 1" then the
    > auto-completion (in the
    > attribute view) for say "xlink:href" will not (at least not for
    > me) populate the dropdown list in the
    > attribute view with "xml:id" that has been defined outside the current
    > file, say in "Chapter 2".
    >
    > The only way I found to fix this is to add all files in the project as
    > files in the validation configuration then
    > the autocompletiong will find all defined "xml:id"'s in all files.
    >
    > /J
    >
    > On 2012-08-13 22:38, Ron Catterall wrote:
    >
    >> I don't understand this xinclude problem with oxygen. Oxygen has been
    >> handling my xincludes, and nested xincludes, seamlessly from versions
    >> around 7 or 8 at least. There was a base problem with the earlier
    >> versions (back to v.2 in my experience) - see this list about 5 or 6
    >> years ago which gave trouble with xinclude nesting, but as far as I know
    >> that has been sorted out. I don't use any 'tricks'. I just loaded v.14
    >> on a new machine and it all worked straight out of the box on nested
    >> xincludes.
    >>
    >> On 13/08/2012 12:42, Johan Persson wrote:
    >>> Kind of. If you like me use a master file with XInclude:s it takes a
    >>> "trick" to get Oxygens to resolve all references and then it works
    >>> really well. This "trick" has been available for quite some
    >>> time/versions - but it is not obvious. You have to add all includes
    >>> as files in the validation schema. Then assign the validation schema
    >>> to all included modules. Having done that it will be possible to
    >>> handle XML includes as expected, all ref:s in all moduels can be
    >>> resolved by auto-completion. Unfortunately the recenet addition of
    >>> master file in Oxygen (which I thought would handle this) does not
    >>> seem to work this way for plain XML files (at least I didn't get it
    >>> to work). It works fine for XSLT stylesheets though. In regards to
    >>> the comments about price for Oxygen I would say that it is very
    >>> reasonable priced given its capabilities and the speed up it will
    >>> make in the writing of XML (and XSLT stylesheets). It would be very
    >>> easy to motivate its cost in a business setting. Of course, for a
    >>> hobbyist it would be harder but I believe Oxygen also has a very
    >>> cheap "hobbyist not-for-profit" license that is less than US $100
    >>> Just my 2c /J On 2012-08-13 19:11, Warren Young wrote:
    >>>> On 8/12/2012 4:41 PM, Richard Hamilton wrote:
    >>>>> There are a bunch of very good visual editors out there that will
    >>>>> handle DocBook. The one I know best is Oxygen
    >>>>> (http://www.oxygenxml.com/), which works very well with DocBook.
    >>>> The last time I tried opening one of my DocBook manuals with it
    >>>> (version 9, maybe?) it didn't handle XML Includes gracefully. I like
    >>>> to have a top-level document that simply includes all the chapter
    >>>> files, which lets me edit the chapters individually. This keeps file
    >>>> sizes reasonable and (much more important) localizes VCS comments to
    >>>> the relevant section of the document. As I recall, oXygen sort of
    >>>> kind of attempted to open the top-level document, but didn't give me
    >>>> the seamless WYSIWYG view I expected: an editable version of the
    >>>> final PDF output. If instead I opened an individual chapter file, it
    >>>> got confused by the cross-references, since it didn't understand
    >>>> that it was looking at a tree in a forest. Have they fixed this
    >>>> limitation, or does it still push you toward putting the entire
    >>>> document in a single file?
    >>>> --------------------------------------------------------------------- To
    >>>> unsubscribe, e-mail:docbook-apps-unsubscribe@lists.oasis-open.org
    >>>> <mailto:docbook-apps-unsubscribe@lists.oasis-open.org>
    >>>> docbook-apps-unsubscribe@lists.oasis-open.org> For additional
    >>>> commands, e-mail:docbook-apps-help@lists.oasis-open.org
    >>>> <mailto:docbook-apps-help@lists.oasis-open.org>docbook-apps-help@lists.oasis-open.org>
    >> -- ron@catterall.net <mailto:ron@catterall.net>
    >



    </mailto:ron@catterall.net></mailto:docbook-apps-help@lists.oasis-open.org></mailto:docbook-apps-unsubscribe@lists.oasis-open.org>


  • 12.  RE: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-15-2012 08:14
    > But if you are using Docbook 5 DTD-based (and you probably are):
    > Oxygen uses Xerces for validation and when parsing XML files with
    > associated DTD schemas Xerces will parse and validate the XML document
    > before the xi:include's are resolved. Because of this the gathered IDs
    > will also be incomplete, even if the master file is validated instead.
    > So this is probably your case, you had to add validation units for each
    > of the module in order to parse them all and gather IDs.

    Some details of this are also discussed in my 3 years old post:
    http://www.oxygenxml.com/forum/topic4079.html




  • 13.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-15-2012 16:56
    On 08/15/2012 02:20 AM, Radu Coravu wrote:
    > Bu the way, good new, in Oxygen 14.1 the actions for inserting xrefs and
    > links in the Author page will be more evolved, they will show a dialog
    > which will allow you to quick find a reference ID. Please see the
    > attached image.
    > And yes, if you choose to insert from the master file, all IDs from all
    > xi:includes will be collected and presented for intertion.

    This looks very cool. So if you pick a
    from the list I'm
    guessing you'll see the title in the window the right? Could it be
    configured to show in the left pane:

    elementname - title or info/title (if available) - [id value]

    Really what people want is the same functionality of the current olink
    dialog (where you pick from a list of titles) but without the effort of
    setting up olink support.

    Of course you're trying to implement this generically so it's useful for
    arbitrary schemas where the olink dialog can rely on elements used in
    DocBook.

    Anyway, I'm looking forward to seeing it.

    Thanks,
    David



  • 14.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-16-2012 06:13
    Hi David,

    Thanks for the suggestions, valuable as usual.

    Indeed if the target element has some sort of a title it would be useful
    to show it in the left part. This would make also the quick find work on
    the title content as well.

    If you want to test an Oxygen 14.1 beta kit, just contact us directly by
    email.

    Regards,
    Radu

    Radu Coravu
    <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
    http://www.oxygenxml.com

    On 8/15/2012 7:56 PM, David Cramer wrote:
    > On 08/15/2012 02:20 AM, Radu Coravu wrote:
    >> Bu the way, good new, in Oxygen 14.1 the actions for inserting xrefs and
    >> links in the Author page will be more evolved, they will show a dialog
    >> which will allow you to quick find a reference ID. Please see the
    >> attached image.
    >> And yes, if you choose to insert from the master file, all IDs from all
    >> xi:includes will be collected and presented for intertion.
    >
    > This looks very cool. So if you pick a
    from the list I'm
    > guessing you'll see the title in the window the right? Could it be
    > configured to show in the left pane:
    >
    > elementname - title or info/title (if available) - [id value]
    >
    > Really what people want is the same functionality of the current olink
    > dialog (where you pick from a list of titles) but without the effort of
    > setting up olink support.
    >
    > Of course you're trying to implement this generically so it's useful for
    > arbitrary schemas where the olink dialog can rely on elements used in
    > DocBook.
    >
    > Anyway, I'm looking forward to seeing it.
    >
    > Thanks,
    > David
    >





  • 15.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-14-2012 13:04
    Hi Johan,

    Just one small remark:

    > Unfortunately the recenet addition of master file in Oxygen (which I thought would handle this)
    > does not seem to work this way for plain XML files (at least I didn't get it to work). It works fine for XSLT stylesheets though.

    You are right, we will try to make this new master files support also
    work for XML-type files.

    Regards,
    Radu

    Radu Coravu
    <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
    http://www.oxygenxml.com

    On 8/13/2012 8:42 PM, Johan Persson wrote:
    > Kind of.
    >
    > If you like me use a master file with XInclude:s it takes a "trick" to
    > get Oxygens to resolve all references and then it works
    > really well. This "trick" has been available for quite some
    > time/versions - but it is not obvious.
    >
    > You have to add all includes as files in the validation schema. Then
    > assign the validation schema to all included modules.
    >
    > Having done that it will be possible to handle XML includes as expected,
    > all ref:s in all moduels can be
    > resolved by auto-completion. Unfortunately the recenet addition
    > of master file in Oxygen (which I thought would handle this)
    > does not seem to work this way for plain XML files (at least I didn't
    > get it to work). It works fine for XSLT stylesheets though.
    >
    > In regards to the comments about price for Oxygen I would say that it is
    > very reasonable priced given
    > its capabilities and the speed up it will make in the writing of XML
    > (and XSLT stylesheets). It would be very easy to motivate
    > its cost in a business setting. Of course, for a hobbyist it would be
    > harder but I believe Oxygen also has a very cheap
    > "hobbyist not-for-profit" license that is less than US $100
    >
    > Just my 2c
    >
    > /J
    >
    > On 2012-08-13 19:11, Warren Young wrote:
    >
    >> On 8/12/2012 4:41 PM, Richard Hamilton wrote:
    >>> There are a bunch of very good visual editors out there that will
    >>> handle DocBook. The one I know best is Oxygen
    >>> (http://www.oxygenxml.com/), which works very well with DocBook.
    >> The last time I tried opening one of my DocBook manuals with it (version
    >> 9, maybe?) it didn't handle XML Includes gracefully.
    >>
    >> I like to have a top-level document that simply includes all the chapter
    >> files, which lets me edit the chapters individually. This keeps file
    >> sizes reasonable and (much more important) localizes VCS comments to the
    >> relevant section of the document.
    >>
    >> As I recall, oXygen sort of kind of attempted to open the top-level
    >> document, but didn't give me the seamless WYSIWYG view I expected: an
    >> editable version of the final PDF output. If instead I opened an
    >> individual chapter file, it got confused by the cross-references, since
    >> it didn't understand that it was looking at a tree in a forest.
    >>
    >> Have they fixed this limitation, or does it still push you toward
    >> putting the entire document in a single file?
    >>
    >> ---------------------------------------------------------------------
    >> To unsubscribe, e-mail:docbook-apps-unsubscribe@lists.oasis-open.org <mailto:docbook-apps-unsubscribe@lists.oasis-open.org>
    >> For additional commands, e-mail:docbook-apps-help@lists.oasis-open.org <mailto:docbook-apps-help@lists.oasis-open.org>
    >>





  • 16.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-13-2012 10:49
    Hi Paul,

    On Sun, 12 Aug 2012 23:05:41 +0100
    Paul Taylor <paul_t100@fastmail.fm> wrote:

    > In a previous project I used docbook 4 to create help text for an
    > application which I then used it to generate html and Javahelp. The
    > generation worked very well but I found it very difficult writing the
    > help text embedded within the docbook tags, it wasn't until the final
    > output was generated that I could see my typos and generally bad
    > english.

    Which editor did you use?
    Some of your troubles can be cured by activating syntax highlighting. :)


    > So considering using docbook v5 for a new project but is there a
    > WYSIWYG editor/plugin available, i.e create help text in word/open
    > office type program but am able to save it in docbook format ?

    Oxygen XML was already mentioned.

    Do you know Serna? It is also an XML editor and has both a normal text
    mode and a WYSIWYG mode:

    http://www.syntext.com/products/serna-free/

    Actually, it's licensed under GPL.


    --
    Gruß/Regards,
    Thomas Schraitle



  • 17.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-13-2012 11:03
    Besides the ones already mentioned:

    XMLMind: http://www.xmlmind.com/xmleditor/

    Haven't used it myself, though.

    -Christian




  • 18.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-13-2012 11:13
    AFAIK, OpenOffice 3.3.0 can save your documents in docbook format.

    On 13 ??? 2012, at 1:05 , Paul Taylor <paul_t100@fastmail.fm> wrote:

    > In a previous project I used docbook 4 to create help text for an application which I then used it to generate html and Javahelp. The generation worked very well but I found it very difficult writing the help text embedded within the docbook tags, it wasn't until the final output was generated that I could see my typos and generally bad english.
    >
    > So considering using docbook v5 for a new project but is there a WYSIWYG editor/plugin available, i.e create help text in word/open office type program but am able to save it in docbook format ?
    >
    > Paul
    >
    > ---------------------------------------------------------------------
    > To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
    > For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
    >




  • 19.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-13-2012 11:31
    Am Mon, 13 Aug 2012, Gregory Papangeles schrieb
    > AFAIK, OpenOffice 3.3.0 can save your documents in docbook format.

    But it is not valid :-((

    Heinz

    --

    Buchsatz für Autoren. Vom Manuskript zum Buch www.pahlke-online.de
    Bücher abseits des Mainstreams www.buchentdeckungen.de
    Barrierefreies Webdesign www.Pahlke-KunstWebDesign.de



  • 20.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-13-2012 12:02
    On 13/08/2012 12:31, Heinz W. Pahlke wrote:
    > Am Mon, 13 Aug 2012, Gregory Papangeles schrieb
    >> AFAIK, OpenOffice 3.3.0 can save your documents in docbook format.
    > But it is not valid :-((
    >
    > Heinz
    >
    Just tried it, and its Docbook 4 rather than Docbook 5 :(
    But not sure its invalid.

    Paul



  • 21.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-13-2012 17:08
    I have been using the free version of Serna. It is the only app which
    support XInclude AFAIK.

    I used then the docboox 4.x -> docbook 5 converter since serna only
    support docbook 4.x

    http://www.syntext.com/products/serna-free/

    HTH

    On Mon, Aug 13, 2012 at 12:05 AM, Paul Taylor <paul_t100@fastmail.fm> wrote:
    > In a previous project I used docbook 4 to create help text for an
    > application which I then used it to generate html and Javahelp. The
    > generation worked very well but I found it very difficult writing the help
    > text embedded within the docbook tags, it wasn't until the final output was
    > generated that I could see my typos and generally bad english.
    >
    > So considering using docbook v5 for a new project but is there a WYSIWYG
    > editor/plugin available, i.e create help text in word/open office type
    > program but am able to save it in docbook format ?
    >
    > Paul
    >
    > ---------------------------------------------------------------------
    > To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
    > For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
    >



    --
    Mathieu



  • 22.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-13-2012 18:37
    On 08/13/2012 12:07 PM, Mathieu Malaterre wrote:
    > I have been using the free version of Serna. It is the only app which
    > support XInclude AFAIK.
    >
    > I used then the docboox 4.x -> docbook 5 converter since serna only
    > support docbook 4.x
    >
    > http://www.syntext.com/products/serna-free/

    There's a DocBook 5 xsd now, so it should be possible to make Serna
    support DocBook 5.x if someone had the inclination and time:

    http://www.docbook.org/xml/5.0/xsd/

    David



  • 23.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-13-2012 19:01
    On 8/12/12, Paul Taylor <paul_t100@fastmail.fm> wrote:
    > In a previous project I used docbook 4 to create help text for an
    > application which I then used it to generate html and Javahelp. The
    > generation worked very well but I found it very difficult writing the
    > help text embedded within the docbook tags, it wasn't until the final
    > output was generated that I could see my typos and generally bad english.
    >
    > So considering using docbook v5 for a new project but is there a WYSIWYG
    > editor/plugin available, i.e create help text in word/open office type
    > program but am able to save it in docbook format ?
    >
    > Paul

    Not exactly the answer you're looking for, but to hijack the thead -
    have HTML 5 + CSS3 sufficiently advanced the art that WYSIWYGness can
    be achieved?

    Personally, I think the answer is yes, esp. with something like Google
    Web Toolkit as the development platform. That would deliver a
    browser-based solution; a web server would still be required to
    deliver and maintain the document storage.

    Comments? Brickbats?

    Cheers,
    jec



  • 24.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-13-2012 21:05
    On 13.8.2012 21:00, Jeff Chimene wrote:

    > Not exactly the answer you're looking for, but to hijack the thead -
    > have HTML 5 + CSS3 sufficiently advanced the art that WYSIWYGness can
    > be achieved?

    Sure, for example http://xopus.com/

    --
    ------------------------------------------------------------------
    Jirka Kosek e-mail: jirka@kosek.cz http://xmlguru.cz
    ------------------------------------------------------------------
    Professional XML consulting and training services
    DocBook customization, custom XSLT/XSL-FO document processing
    ------------------------------------------------------------------
    OASIS DocBook TC member, W3C Invited Expert, ISO JTC1/SC34 member
    ------------------------------------------------------------------




  • 25.  Re: [docbook-apps] WYSIWYG Editor for docbook

    Posted 08-13-2012 21:42
    On Mon, 13 Aug 2012 23:05:29 +0200, Jirka Kosek <jirka@kosek.cz> wrote:
    > On 13.8.2012 21:00, Jeff Chimene wrote:
    >
    >> Not exactly the answer you're looking for, but to hijack the thead -
    >> have HTML 5 + CSS3 sufficiently advanced the art that WYSIWYGness can
    >> be achieved?
    >
    > Sure, for example http://xopus.com/

    I don't know enough about how these things work, but what happens if you
    resize your browser window--does the HTML change width to fit, or do you
    get a scroll bar if the window is narrower than the the anticipated text
    pane width? (I personally hate websites that do that, I'd much prefer that
    they wrap, but ymmv.)

    Mike Maxwell