docbook-apps

  • 1.  CSS based docbook editor

    Posted 03-31-2010 07:32

    http://bit.ly/cQiKV2 Vex

    Vex is a Visual Editor for XML that hides the raw XML tags from the
    user, providing instead a word processor like interface. Vex uses
    standard DTD files to define document types and CSS stylesheets to
    define document layout. Vex contains definitions for DocBook and DITA.
    To edit other XML formats only a DTD and a CSS are needed.




    regards

    --
    Dave Pawson
    XSLT XSL-FO docbook FAQ.
    http://www.dpawson.co.uk


    --

    regards

    --
    Dave Pawson
    XSLT XSL-FO FAQ.
    http://www.dpawson.co.uk



  • 2.  Re: [docbook-apps] CSS based docbook editor

    Posted 04-02-2010 11:51
    Thank you for the link!

    As far as I understood, this editor is made for developers, and would
    have too much unnecessary overhead for simpler needs?

    I am currently looking for a docBook editor that is directed towards end
    users, with the following requirements:
    - preferably an easy to use word processor interface
    - can validate document structure against docBook in general and check
    for required elements within the specific library project
    - And especially:
    ability to import and transform rtf documents preformatted in a
    specified way by contributing authors (or at least open them and
    reformat, instead of having to cut and paste single text blocks, which
    seems to be the necessary procedure e.g. in XMLmind?)

    I have begun looking around what's available (authoring tools on docBook
    Wiki) but as a non-expert just learning the basics of docBook would be
    VERY grateful for further tips to get me going in the right direction!
    Thanks in advance,

    Nathalie

    --
    Nathalie Sequeira
    ************************
    web *n* languages
    www.n-faktor.net

    Türingstr. 6
    6020 Innsbruck
    Mobil: 0650 224 3336
    n@n-faktor.net




  • 3.  Re: [docbook-apps] CSS based docbook editor

    Posted 04-02-2010 18:45
    On Fri, 02 Apr 2010 13:51:05 +0200, Nathalie Sequeira <n@n-faktor.net>
    wrote:
    > I am currently looking for a docBook editor that is directed towards end

    > users
    > ...
    > - And especially:
    > ability to import and transform rtf documents preformatted in a
    > specified way by contributing authors (or at least open them and
    > reformat, instead of having to cut and paste single text blocks, which
    > seems to be the necessary procedure e.g. in XMLmind?)

    Three or four years ago, we had to start our project with MsWord. Once we
    had XMLMind, we imported the Word doc into XXE (= XMLMind Editor) using a
    tool which I have long since forgotten. The tool worked reasonably well,
    and we were able to import the doc as a whole; I think we had to do some
    clean-up after we got it into XXE. Unless you're doing this conversion on
    multiple documents, I would consider that a one-time cost, and a small one.

    I haven't looked at tools to convert Word to DocBook since then, but I
    would guess that they have gotten better. I don't know whether there are
    tools that do both the import and allow editing; conceptually, those are
    rather different tasks.

    There was a slight learning curve for XXE, but we have now at least half a
    dozen people who have learned it and are reasonably happy with it. (Some
    are happier in XXE than in Word 2007, but your mileage may vary.)

    I do have a few minor gripes about XXE:
    1) It doesn't handle right-to-left text well (that's probably not an issue
    for most people!)
    2) It doesn't do "track changes" (yet; that's on their list, and there are
    work-arounds if you don't mind having the changes flagged only in your
    PDFs)
    3) It mungs the XML code by adding newlines in places no human would add
    them (but that's only an issue if you want to hand-edit the XML in a
    programmer's editor; it has no practical effect otherwise)

    I will also mention that they have an active mailing list for users, and
    they are *very* responsive to reasonable requests.

    Unless you are lucky, you will need someone who can figure out how to
    modify the standard configurations for XXE, and for DocBook as a whole, to
    do what you want. Our own setup is decidedly non-vanilla, and it does take
    some work to keep on top of things.

    In sum, we are satisfied customers of XXE. (We have gladly paid for the
    Professional version.)

    Mike Maxwell



  • 4.  Re: [docbook-apps] CSS based docbook editor

    Posted 04-02-2010 16:39

    On Mar 31, 2010, at 12:31 AM, Dave Pawson wrote:

    >
    > http://bit.ly/cQiKV2 Vex
    >
    > Vex is a Visual Editor for XML that hides the raw XML tags from the
    > user, providing instead a word processor like interface. Vex uses
    > standard DTD files to define document types and CSS stylesheets to
    > define document layout. Vex contains definitions for DocBook and DITA.
    > To edit other XML formats only a DTD and a CSS are needed.

    Do you have advice for installing Vex as an eclipse plugin? Or, is that not yet ready since the move? I'm having a difficult time deciphering this information, and me being fairly unfamiliar with eclipse doesn't help.

    Regards,
    Philip




  • 5.  Re: [docbook-apps] CSS based docbook editor

    Posted 04-03-2010 06:32
    On Fri, 2 Apr 2010 09:39:03 -0700
    Philip Olson <philip@roshambo.org> wrote:

    >
    > On Mar 31, 2010, at 12:31 AM, Dave Pawson wrote:
    >
    > >
    > > http://bit.ly/cQiKV2 Vex
    > >
    > > Vex is a Visual Editor for XML that hides the raw XML tags from the
    > > user, providing instead a word processor like interface. Vex uses
    > > standard DTD files to define document types and CSS stylesheets to
    > > define document layout. Vex contains definitions for DocBook and
    > > DITA. To edit other XML formats only a DTD and a CSS are needed.
    >
    > Do you have advice for installing Vex as an eclipse plugin? Or, is
    > that not yet ready since the move? I'm having a difficult time
    > deciphering this information, and me being fairly unfamiliar with
    > eclipse doesn't help.
    >
    > Regards,
    > Philip

    I'm not an Eclipse user either. AFAIK it has a 'plugins' directory, into
    which the plugin is unzipped/installed. Then its just a case of finding
    the plugin in the menu system.

    Ask on the Eclipse list perhaps

    HTH

    --

    regards

    --
    Dave Pawson
    XSLT XSL-FO FAQ.
    http://www.dpawson.co.uk