[brailleblaster] Explanation of UTDML. was: Re: Re: Newdesign build broken...
- From: "John J. Boyer" <john.boyer@xxxxxxxxxxxxxxxxx>
- To: brailleblaster@xxxxxxxxxxxxx
- Date: Wed, 2 Jan 2013 10:59:50 -0600
Hi Keith,
Thanks for your explanations. I think the first communicationns poroblem
to be solved is the nature of UTDML .
In this design an xml document is first passed to liblouisutdml to get a
trial rendering. This rendering is contained in the UTDML which
liblouisutdml adds to the document. The rendering contains all the
layout information for Braille besides translations. Since the layout
information is already contained in the rendering (in the <brl>
subtrees) a Braille CSS is inappropriate. All that has to be done is to
use the information in the <newpage> and <newline> elements in the <brl>
subtrees. ViewPlus does this in their software.
John
On Wed, Jan 02, 2013 at 04:03:55PM +0000, Keith Creasy wrote:
> John.
>
> I'm not sure I think what you are outlining here is the best way to
> accomplish the braille view. What exactly is the difference between your
> semantic action files, as applied to an XML DOM, and what a style sheet does?
> The document being displayed is not UTDML, it's something else, XHTML or
> DTBook.
>
> In fact, the more I think about this process, I think a better approach would
> be to use a braille CSS and XSLT in an HTML editor.
>
> The communications problem probably are the result of a couple of things.
> First, I'm really not clear on how you expect all this to work; using any
> vocabulary of XML, directly editing print and braille on that document,
> styling in the views, and very confusing is how the semantic actions get
> applied, when, and where. The second problem is that, because I don't
> entirely follow it, I'm not certain it's even the best approach. I'm sure you
> know what you are doing but I'm not sure who else does. G
>
> About MVC architecture:
>
> M- Model. The data being used such as a database, XML document, or something
> else.
>
> V- View, seems self-explanatory except that in this design pattern the view
> only controlls how the data is rendered; i.e. displayed in a window. It has
> methods that perform actions on the data by calling the controller and
> recieves update events from the controller.
>
> C- Controller, Provides an interface to the data (Model), performs actions on
> the data based on actions from the views. Notifies the views when to update
> their data and what data to use. In many cases the controller has one dataset
> attached to it; i.e. an XML document and one or more views.
>
> Here is a simple scenario:
>
> 1. An XML document is opened and a DOM created. It is attached to the
> controller.
> 2. The controller creates a set of views and they are attached to the
> controller. For BB that might be the braille and print edit controls. The
> controller passes semantic actions to the view when it is created so that it
> can manage the XML data that gets passed in. I think this could also be done
> with CSS and XSLT.
> 3. Someone working in the print view adds a new paragraph, inserting a new
> line.
> 4. the view calls an "insert" method of the controller.
> 5. The controller changes the content, XML DOM, with the new paragraph.
> 6. The controller tells each attached view to update using the provided data.
> 7. Each view takes the modified content and renders it. The braille view and
> the print view would not do exactly the same thing because the rendering
> would be different in each view.
>
>
>
>
>
>
> Keith Creasy
> Software Developer
> American Printing House for the Blind
> KCreasy@xxxxxxx
> Phone: 502.895.2405
> Skype: keith537
>
>
> -----Original Message-----
> From: brailleblaster-bounce@xxxxxxxxxxxxx
> [mailto:brailleblaster-bounce@xxxxxxxxxxxxx] On Behalf Of John J. Boyer
> Sent: Wednesday, January 02, 2013 10:27 AM
> To: brailleblaster@xxxxxxxxxxxxx
> Subject: [brailleblaster] Re: Newdesign build broken...
>
> Hi Keith,
>
> We will have to give some attention to communicating clearly. I've been
> surprised at how difficult that can be, but maybe it isn't surprising.
>
> Everything needed for the Braille view is contained in the UTDML which is
> added to the document by liblouisutdml. Layout information is contained in
> the newpage and newline elements. The xy attribute of the latter gives the
> position of the line on the page and indentation. The UTDML part actually
> contains the rendering of the print document. It is handled by the UTD class
> in the wordprocessor. The only action required is the one for calling that
> class.
>
> Could you expand on the mvc model as it applies to BrailleBlaster?
>
> Thanks,
> John
>
> On Wed, Jan 02, 2013 at 03:04:22PM +0000, Keith Creasy wrote:
> > OK John. I'll continue on the public list.
> >
> > In my opinion this all needs to be done using an MVC architecture.
> >
> > The document model is an XML DOM, plain and simple. You are invisioning
> > that it can be any vocabulary/document type. We are planning to use XOM as
> > the interface to the DOM.
> >
> > The views are what we have planned on all along; braille, text(or print if
> > you prefer), and HTML. An XMLEditor using tree, attribute, text, and HTML
> > views on the same document.
> >
> > The 'C' or "controller" part of this is critical because it is what ties
> > the XML DOM to the views via the semantic actions.
> >
> > Possibly the semantic actions need to be tied in with the braille view?
> > They are responsible for the styling of the content, right? I think you are
> > trying to tie the semantic actions with the actual document but I think
> > it's more part of the view. Explain if that's not right.
> >
> >
> >
> >
> > Keith Creasy
> > Software Developer
> > American Printing House for the Blind
> > KCreasy@xxxxxxx
> > Phone: 502.895.2405
> > Skype: keith537
> >
> >
> > -----Original Message-----
> > From: John J. Boyer [mailto:john.boyer@xxxxxxxxxxxxxxxxx]
> > Sent: Wednesday, January 02, 2013 9:40 AM
> > To: Keith Creasy
> > Cc: Chuck Myers; brandon.r.roller@xxxxxxxxx
> > Subject: Re: Newdesign build broken...
> >
> > Hi Keith,
> >
> > This method was removed. It's been compiling for me. I wonder why. There
> > must be an old class around. In any case, this code is to be changed.
> > The DocumentManager class needs extensive rewriting.
> >
> > Let's start putting our messages on the BrailleBlaster list instead of
> > writing to each other. That will stimulate interest in a wider commuunity
> > and may give rise to some new ideas.
> >
> > Brandon, please subscribe to both the liblouisliblouisxml and
> > brailleblaster lists. Go to http://www.abilitiessoft.com . You will find
> > links to sites where you can subscribe. Do you have the command for
> > cloning the brailleblaster.newdesign repository?
> >
> > To all, I'm working on the documentmodel package. It's coming along rather
> > slowly, but I have confidence in it.
> >
> > Thanks,
> > John
> >
> > On Wed, Jan 02, 2013 at 02:01:50PM +0000, Keith Creasy wrote:
> > > John.
> > >
> > > The newdesign does not compile. Here is the error. I can make it build by
> > > commenting out the offending code block...
> > >
> > > [javac]
> > > D:\workspace\brailleblaster\src\main\org\brailleblaster\wordprocessor\SaveOptionsDialog.java:55:
> > > error: cannot find symbol
> > > [javac] if (BBIni.useUtd()) {
> > > [javac] ^
> > > [javac] symbol: method useUtd()
> > > [javac] location: class BBIni
> > > [javac] 1 error
> > > [javac] 1 warning
> > >
> > >
> > > I can probably fix it but need to be sure I understand what this is
> > > supposed to be doing.
> > >
> > > Keith Creasy
> > > Software Developer
> > > American Printing House for the Blind KCreasy@xxxxxxx
> > > Phone: 502.895.2405
> > > Skype: keith537
> > >
> >
> > --
> > John J. Boyer; President, Chief Software Developer Abilitiessoft, Inc.
> > http://www.abilitiessoft.com
> > Madison, Wisconsin USA
> > Developing software for people with disabilities
> >
>
> --
> John J. Boyer; President, Chief Software Developer Abilitiessoft, Inc.
> http://www.abilitiessoft.com
> Madison, Wisconsin USA
> Developing software for people with disabilities
>
>
--
John J. Boyer; President, Chief Software Developer
Abilitiessoft, Inc.
http://www.abilitiessoft.com
Madison, Wisconsin USA
Developing software for people with disabilities
Other related posts:
