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

[Richard Shann]

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
> > > > > > 
> > > > > > 
> > > > > > 
> > > > > 
> > > > > 
> > > > 
> > > > 
> > > > 
> > > 
> > > 
> > 
> > 
> 
>