Re: [Denemo-devel] Denemo User Manual

[Cantor Stuart Binder]

Richard,

Everything looks good. The Music Snippets section went right in without issue. 
Currently it's section 7 (7.1 Overview and 7.2 Basic Use), but that's because I 
only have sections 1-6 finished. 

It's been a while, but I have used git before. I will await further 
instructions from Jeremiah.

Stuart



-----Original Message-----
From: address@hidden [mailto:address@hidden On Behalf Of Richard Shann
Sent: Friday, May 08, 2015 12:01 PM
To: address@hidden
Subject: Re: [Denemo-devel] Denemo User Manual

On Fri, 2015-05-08 at 11:14 -0400, Cantor Stuart Binder wrote:
> Richard,
> 
> Glad you like the idea!
> 
> Translating the XML document into LyX is going to be a slow process (I 
> have completed up to the main toolbar section) but the results are 
> pretty spectacular. If we're serious about going forward with LyX, it 
> makes sense to write new material directly in its native format (plus, 
> it will save you from having to type all the XML tags). All you have 
> to do is mark the title as a section. Then I'll be able to just copy & 
> paste it into the main document and it will appear correctly in the table of 
> contents.

I've made a short trial of this (so we can gain confidence that this will all 
work), attached is the start of a documentation for the Snippets Toolbar. 
Perhaps you can try out how to add this to the document you have?

>  I guess
> we'll have to find a way to collaborate on the LyX document once I 
> have more of it converted.

Are you familiar with our source repository software (git)? If so perhaps 
Jeremiah can give you write access to the docs directory.
(Well, even if not, it is easy enough to pick up the two or three commands 
needed).

Oh - and please reply to the list, just in case anyone has any cautionary tales 
to tell! (I never even heard of LyX despite it being nearly as old as Denemo 
(?))

Richard


> 
> Stuart
> 
> -----Original Message-----
> From: address@hidden
> [mailto:address@hidden On Behalf 
> Of Richard Shann
> Sent: Friday, May 08, 2015 10:51 AM
> To: address@hidden
> Subject: Re: [Denemo-devel] Denemo User Manual
> 
> On Thu, 2015-05-07 at 15:53 -0400, Cantor Stuart Binder wrote:
> > Richard,
> > 
> > I have been evaluating different ways forward for the documentation, 
> > but
> it seems that there are no easy roads. I had a similar experience 
> trying to convert the denemomanual.xml file to other formats. It 
> appears that in order to get decent results, the conversion will have to be 
> done largely by hand.
> > 
> > I have looked at DocBook, Texinfo and LyX. Docbook and Texinfo are 
> > very
> similar (docbook uses XML <tag></tag> pairs for its markup, and 
> texinfo uses @tag and @end tag for the same purpose). All three 
> programs provide automatic tables of contents (and can generate a 
> subject index as well). All three can output documentation in a 
> variety of formats (including HTML). I'm really liking LyX, as it 
> provides an editor which will make working on the manual MUCH easier. 
> The editor not only generates a table of contents as you go, but 
> allows you to use it for navigation while you're working on the 
> document. I haven't done extensive testing yet, but the HTML markup it 
> generates looks like it will be easier to style than the DocBook output.
> > 
> > I'm going to do some more testing and play with it a bit. Will let 
> > you
> know what I find.
> 
> I've just installed and tried out LyX - it seems to be the Denemo of 
> the document typesetting world! A great improvement over what we have. 
> And I see that it has been around a long time and is actively 
> maintained, altogether very promising.
> 
> I have just been extending the capabilities of the music snippets, and 
> was about to document them - does it make any difference whether I do 
> that in the current denemomanual.xml?
> 
> 
> Richard
> 
> 
> 
> _______________________________________________
> Denemo-devel mailing list
> address@hidden
> https://lists.gnu.org/mailman/listinfo/denemo-devel
>