Re: [Audacity-manual] Draft Audacity2.2.0 Manual v02

[Steve t. F. <ste...@gm...>]

Good work James.
This is the best looking pdf version that I've seen to date.
The absence of clickable image links is possibly the main shortcoming
at the moment, but I'm sure that you'll overcome that :-)

I can't imagine many users reading this cover to cover, but we do
regularly see requests for a PDF version, and the "side pane" index is
very handy.

Steve

On 17 November 2017 at 12:21, James Crook <cr...@in...> wrote:
> Gale wanted a pdf version of the entire manual.  I have produced one, though
> currently minus the front-page with its clickable image.
>
>
> The main benefits of the pdf format are:
>
> - Table-of-contents tree that is clickable/browsable.
> - Thumbnail browser, that gives thumbnails of all 565 pages.
> - All in one file and more convenient for eReaders.
>
> I like the two column layout.  I think it works well once you get used to
> it.  The scale of it, 565 pages, gives an idea of just how much work has
> gone into the manual over the years!
>
>
> Of course the format conversion is not perfect.  Pages with tables and
> clickable images are not 'done' yet.  I'm probably aware of most of the
> systematic issues with my format conversion, e.g. hyperlinks to wikipedia
> don't work.  There are also many differences we'd probably like between text
> in an html and pdf manual, which would best be handled by adapted templates
> in the wiki.
>
>
> A dropbox download of the draft manual to try out is here:
>
> https://www.dropbox.com/s/o90lz7mnv6bn9sf/DraftAudacity2.2.0Manual_v02.pdf?dl=0
> (18Mb)
>
> We could offer this draft pdf as a download on our devel fosshub page, if
> people think that;'s a good idea, and see how much interest there is from
> the download figures.
>
> I think the main value of being able to do this conversion is for localised
> sections of the manual.  The script/pipeline that automates conversion from
> wiki format to pdf could be adapted to collect them.  We could in future
> offer pdf downloads of tutorials and FAQ that have been translated.  That is
> a project for the future.  It involves working with the translators too.
>
>
> Feedback welcome.
>
>
> --James
>
>
>
> ------------------------------------------------------------------------------
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> _______________________________________________
> Audacity-manual mailing list
> Aud...@li...
> https://lists.sourceforge.net/lists/listinfo/audacity-manual