Re: [Denemo-devel] Denemo User Manual (draft PDF)

[Cantor Stuart Binder]

Yes, "delete temporarily" is exactly right. For some reason, the LyX HTML
converter passes unimplemented commands through as text. Useful for
debugging, perhaps, but ugly. It's nice in the PDF (restarts the page
numbering and switches from roman to Arabic numerals), but doesn't affect
the HTML (which has no page numbers). It would be great if LyX would ignore
this command when generating HTML, but for now, it has to be deleted before
exporting.

Stuart

-----Original Message-----
From: address@hidden
[mailto:address@hidden On Behalf Of
Richard Shann
Sent: Saturday, June 13, 2015 6:56 AM
To: address@hidden
Subject: Re: [Denemo-devel] Denemo User Manual (draft PDF)

I forgot to add the mailing list to this email.
A further point I meant to mention is that we should generate the PDF
without (large or any) margins.
This is because the vast majority of uses of it are viewed on a screen, not
paper. The margins are not useful and make the text more difficult to read.

On Sat, 2015-06-13 at 06:38 -0400, Cantor Stuart Binder wrote:
> Richard,
> 
> Attached is the newer version of denemo.css. All I have done for now is
add a little breathing room around the "note" boxes. 



I've put this in git now.


> The version of denemo-manual.html in git looks good, but the one currently
posted on the denemo.org website has some problems (poor formatting and
strange characters). Were these from different exports?



Under Documentation->Manual is a link to the current denemo-manual.html file
in the source repository, this will display without finding denemo.css nor
the images. I don't have write permission to that, so I have asked Eloi or
Jeremiah to change it to point to the denemomanual.pdf file which will
display properly.

I have also changed the link on the Tutorials page to point to the pdf.


> Also, please don't forget to pull out

that is "delete temporarily"? I have deleted (temporarily) that numbering
box thing, generated the html and checked that into git. I didn't spot the
problem before but I hope it is fixed now.



>  the \pagenumbering command before doing the HTML export. The LyX HTML
exporter doesn't handle it properly (I haven't reported that to the LyX team
yet, but I will). There's a bit yellow note just above the command (at the
top of the Introduction section).
> 
> Stuart
> 
> -----Original Message-----
> From: Richard Shann [mailto:address@hidden
> Sent: Friday, June 12, 2015 7:35 AM
> To: Cantor Stuart Binder
> Subject: Re: Denemo User Manual (draft PDF)
> 
> Oh - another thing, I see that Jeremiah has just fixed the denemo.css
installation thing (I presume so it is found at run time), did you want to
suggest an improved version of this file?
> 
> Richard
> 
> 
> On Thu, 2015-06-11 at 13:11 -0400, Cantor Stuart Binder wrote:
> > Richard,
> > 
> > See if this works.
> > 
> > Stuart
> > 
> > -----Original Message-----
> > From: Richard Shann [mailto:address@hidden
> > Sent: Thursday, June 11, 2015 4:54 AM
> > To: Cantor Stuart Binder
> > Subject: Re: Denemo User Manual (draft PDF)
> > 
> > On Wed, 2015-06-10 at 23:03 -0400, Cantor Stuart Binder wrote:
> > > Yes, I am doing a hand edit for now,
> > 
> > that's just fine then - can you send me your clean exported-to-lyx 2.0
version so I can start editing with confidence?
> > 
> > Richard
> > 
> > 
> > 
> > 
> > >  but what I'm doing is so simple (basically substituting a custom 
> > > local CSS file for the remote one referenced in the HTML) that I 
> > > could probably create a script to do it. That might even eliminate 
> > > the need to remove the page numbering commands before generating 
> > > the HTML (I could have the script pull out the offending text 
> > > after the HTML file is exported).
> > > 
> > > 
> > > Stuart
> > > 
> > > 
> > > Sent from my Verizon Wireless 4G LTE smartphone
> > > 
> > > 
> > > -------- Original message --------
> > > From: Richard Shann <address@hidden>
> > > Date: 06/10/2015 2:15 PM (GMT-05:00)
> > > To: Cantor Stuart Binder <address@hidden>
> > > Subject: Re: Denemo User Manual (draft PDF)
> > > 
> > > On Wed, 2015-06-10 at 13:59 -0400, Cantor Stuart Binder wrote:
> > > > Richard,
> > > > 
> > > > Sorry... I didn't know you were using an older version. I have 
> > > > an
> > > option to export to LyX 2.0 format, so exchanging the file 
> > > shouldn't be a problem in the future.
> > > > 
> > > 
> > > Oh, that sounds good - can you send me such a version, so that we 
> > > can be sure I haven't introduced anything bad by my dodgy import?
> > > I'll then do some editing and put it in the git repository.
> > > 
> > > > I noticed the doubling up of images on HTML export as well. Not 
> > > > sure
> > > why that happens, but (as you noticed) the original image 
> > > references still work. The images in the document root directory 
> > > aren't used by the HTML, only the images in the "images" directory.
> > > 
> > > > I was planning on eventually replacing many of the images with 
> > > > newer
> > > screenshots.
> > > 
> > > >  This will only be an issue for images we add to the document - 
> > > > so
> > > at some point, we'll have to figure out how we're going to handle 
> > > the addition of new images.
> > > 
> > > I think it is enough just to add them to the images directory, I
> > > *think*
> > > the makefile rules mean everything there is exported.
> > > 
> > > > 
> > > > Again, if you want me to generate the final HTML and CSS for you
> > > once you've edited the LyX file,
> > > 
> > > > I can add the extra bit of formatting to the final HTML.
> > > 
> > > That sounds good - is that some hand editing? (I'm thinking about 
> > > the quibbling that might arise if we generate something which 
> > > can't practically be done by people with free software - I 
> > > included the program that generated the source code for that piano 
> > > brace that now appears in the display(*) to avoid that sort of issue).
> > > 
> > > Richard
> > > (*) Have you had a chance to see this? The latest version 
> > > http://denemo.org/~jjbenham/gub/uploads/denemo-mingw-0.0.0.zip
> > > should work perfectly for you - including simultaneous typesetting.
> > > 
> > > > Stuart
> > > > 
> > > > -----Original Message-----
> > > > From: Richard Shann [mailto:address@hidden
> > > > Sent: Wednesday, June 10, 2015 6:57 AM
> > > > To: Cantor Stuart Binder
> > > > Subject: Re: Denemo User Manual (draft PDF)
> > > > 
> > > > I've been playing around with the .lyx file and I now understand 
> > > > a
> > > bit better what will be involved. On exporting HTML it has to 
> > > create a directory full of files for the images as well as the 
> > > .html file itself.
> > > > On the face of it, that would mean re-working the makefile system.
> > > > However, the html file generated can be moved up into the 
> > > > original
> > > docs directory where it picks up the original copies from the 
> > > images directory. (I wonder, is that the intended procedure - I 
> > > notice there is a further copy of the images directory in the 
> > > lyx-generated html directory, and that the file sizes differ..., I 
> > > guess that generally the lyx source can specify scaling etc to be 
> > > performed on the original images ...) I won't do any serious work 
> > > on this until we are sure how we can proceed though...
> > > > 
> > > > Richard
> > > > 
> > > > 
> > > > 
> > > > 
> > > > On Tue, 2015-06-09 at 16:58 -0400, Cantor Stuart Binder wrote:
> > > > > I am attaching the latest version of denemomanual.lyx. There's
> > > plenty more I'd like to do, but I wanted to get this to you early 
> > > so we have time to work out any kinks before the release. There 
> > > are a few things to note:
> > > > > 1. The Lyx notes (in yellow) are internal notes - they will 
> > > > > not be
> > > included in the HTML or PDF output.
> > > > > 2. You can do the export to HTML and PDF yourself if you want, 
> > > > > but
> > > I have a few formatting tweaks I've been using to make the HTML 
> > > look a little better. If you prefer, I can generate and patch the 
> > > HTML version for you once you post the final Lyx file in the source
repo.
> > > > > 3. As you'll see in the file, I've tried to use the Typewriter
> > > text style for all keyboard input (the first time you do it, 
> > > select
> > > Edit->Type Style->Customized from the menu and set the Family to
> > > Typewriter. Thereafter, you can just highlight text you want to 
> > > format and use the "Apply Last" button on the toolbar). I'm sure I 
> > > missed at least a few. Ideally, I'd like to have a different style 
> > > for menu options, and possibly another for note names.
> > > > > 
> > > > > Stuart
> > > > > 
> > > > > -----Original Message-----
> > > > > From: Richard Shann [mailto:address@hidden
> > > > > Sent: Monday, June 8, 2015 4:49 AM
> > > > > To: Cantor Stuart Binder
> > > > > Subject: Re: Denemo User Manual (draft PDF)
> > > > > 
> > > > > On Sun, 2015-06-07 at 19:03 -0400, Cantor Stuart Binder wrote:
> > > > > > 
> > > > > > 
> > > > > > Absolutely. When do you need it? I've been working on the 
> > > > > > Lyx
> > > file -
> > > > > > mostly formatting, and a little editing for clarity.
> > > > > > 
> > > > > Well, I just sent the denemo.pot file off for the translators 
> > > > > to
> > > work on it. I think there are only two or three really active ones 
> > > at the moment, but I want to encourage them by giving them time to 
> > > bring their translations up to date before the release. If you 
> > > could send me your LyX file in a week's time say, I'll work on it 
> > > for a couple of days (*) and put it in the source repository. At 
> > > that point our timetable will be dominated by the success or 
> > > otherwise of Jeremiah's building of binaries (we have made 
> > > releases without binaries before now, but I think it causes 
> > > problems to sites that re-distribute the binaries).
> > > > > It *is* somewhat urgent that we make a release - it looks like 
> > > > > the
> > > previous release had threading bugs which can be very 
> > > unpredictable (on my system the worst thing was hanging on exit, 
> > > but you reported it crashing with continuous typeset turned on). 
> > > So, on mature consideration, I don't propose that we make this the 
> > > major version
> > > 1.3 with the re-written manual that the roadmap suggests, but just 
> > > whatever improvements we can make in the time available.
> > > > > (BTW, the closest windows binary to what the release will look
> > > like is at http://www.denemo.org/~rshann/denemo-1.2.3.zip this is 
> > > a portable, no-install version: it only lacks the sytem-brace-rework).
> > > > > 
> > > > > Richard
> > > > > 
> > > > > 
> > > > > (*) I will need to add a description of the new interface for
> > > system
> > > > > braces for example
> > > > > > 
> > > > > > Stuart
> > > > > > 
> > > > > > 
> > > > > > 
> > > > > > 
> > > > > > Sent from my Verizon Wireless 4G LTE smartphone
> > > > > > 
> > > > > > 
> > > > > > -------- Original message --------
> > > > > > From: Richard Shann <address@hidden>
> > > > > > Date: 06/07/2015 4:58 AM (GMT-05:00)
> > > > > > To: Cantor Stuart Binder <address@hidden>
> > > > > > Subject: Re: Denemo User Manual (draft PDF)
> > > > > > 
> > > > > > On Sun, 2015-05-10 at 22:17 -0400, Cantor Stuart Binder wrote:
> > > > > > > Richard,
> > > > > > > 
> > > > > > > I'm sending this privately so as not to clog up everyone's
> > > inbox. 
> > > > > > > I still have some formatting to do, and I'm not really 
> > > > > > > happy
> > > with
> > > > > > > the overall organization yet, but I have the whole thing 
> > > > > > > in
> > > LyX now.
> > > > > > 
> > > > > > 
> > > > > > I started the ball rolling towards this release - I was
> > > wondering if
> > > > > > we could include the LyX file you generated (and consequent
> > > PDF)
> > > > > > with it?
> > > > > > I realise you may be busy right now, but if you send me a 
> > > > > > copy
> > > I'll
> > > > > > do something with it.
> > > > > > Best wishes,
> > > > > > 
> > > > > > Richard
> > > > > > 
> > > > > > 
> > > > > > 
> > > > > 
> > > > > 
> > > > 
> > > > 
> > > > 
> > > 
> > > 
> > 
> > 
> 
> 




_______________________________________________
Denemo-devel mailing list
address@hidden
https://lists.gnu.org/mailman/listinfo/denemo-devel