[brailleblaster] Re: Explanation of UTDML. was: Re: Re: Newdesign build broken...
- From: Keith Creasy <kcreasy@xxxxxxx>
- To: "brailleblaster@xxxxxxxxxxxxx" <brailleblaster@xxxxxxxxxxxxx>
- Date: Wed, 2 Jan 2013 19:40:00 +0000
John.
I'm looking through the "documentmodel" code and I see that "Styles" applies to
rendering print and "Semantics" applies to rendering braille.
Again, I'm not sure I understand all this fully but it seems to me that this is
what should happen:
1. Document builds an XML DOM from an input stream.
2. Based on the document type a semantic action file and styles file are
selected and the appropriate objects are created.
3. The views, for now we assume just braille and print, are updated with the
DOM or some representation of the content. We could also just pass in the
document type and let the view choose the semantic and style objects.
From here changes made in either view call a method in the document interface
that changes the content and then the document class updates the views with the
modified content. The views use the semantic and style objects they have to
re-render the content.
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 12:00 PM
To: brailleblaster@xxxxxxxxxxxxx
Subject: [brailleblaster] Explanation of UTDML. was: Re: Re: Newdesign build
broken...
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:
