[FM Discuss] Strange problems with PDF of Spanish version of MYOSA

[James Simmons]

Ana,

I've looked at the book some more.  Some comments:

1).  Every image used in the book needs to be uploaded to that same
book.  You can't link to images outside the book.  It will *look* OK
when you're editing, but the book will not publish correctly, either
to the web or to PDF or EPUB.  I think the chapters you worked on did
this OK but some of your collaborators didn't realize this.

2).  There is extra style information in the pages probably caused by
editing in Word.  Some of this is harmless, but the only way you're
going to know is by creating a PDF with the default styles and looking
at each page.  Some of the style stuff is definitely harmful!

3).  There are no bios for you and your team in the "About The
Authors" chapter.  People want to know who you are!  Don't feel you
need to make your bio as silly as mine is, but put something there.

4).  When I post this to the Internet Archive and the Kindle Store I'm
going to want to have a Spanish description for the book.  Could you
please provide one?  Feel free to come up with your own description,
or if you don't want to do that translate what I'm using here:

http://www.amazon.com/Make-Your-Sugar-Activities-ebook/dp/B0050VAHKW/ref=sr_1_1?ie=UTF8&m=AG56TWVU5XWC2&s=digital-text&qid=1305432542&sr=1-1

I have fixed up some problems with the book and may continue to do
that as time permits, but since I don't know Spanish I can't be
trusted to do all the fix-ups.  The key thing is to put the editor in
HTML mode for each chapter and look for stuff that doesn't belong.

Thanks,

James Simmons


On Sat, Jun 18, 2011 at 12:49 AM, James Simmons <nicestep at gmail.com> wrote:
> Ana,
>
> I figured out some of the issues and attempted to make corrections.
> It looks like some of the chapters had extra tags in them.  For
> instance, chapter 4 had an extra <h1></h1> in front of the chapter
> title, so the chapter title came up as an empty string.  Other
> chapters had unnecessary <style> tags in them.  I would guess that
> these chapters might have been edited in Word and then pasted into
> Booki.  I've done that myself and it has caused similar problems.
>
> For the missing screenshots, I would guess that the URLs of the
> screenshots do not point to images contained within the project, but
> in fact point to images in the English version.  This *looks* OK when
> you're editing but does not work for publishing.
>
> I would recommend creating a PDF with the default style sheet and
> going through it looking for obvious problems like screwed up chapter
> headings, missing pictures, etc.  Look at the raw HTML view for
> chapters with problems and that should give you a pretty good idea of
> how to fix them.  It should not take that long, and I'll help if you
> get stuck.
>
> Thanks,
>
> James Simmons
>
>
> On Fri, Jun 17, 2011 at 7:30 PM, James Simmons <nicestep at gmail.com> wrote:
>> The Spanish version of "Make Your Own Sugar Activities!" is ready to
>> publish, but when I attempt to make a PDF to submit to the Internet
>> Archive I'm getting a weird problem with the TOC.  It looks like this:
>>
>> Table of Contents
>> Actividades Sugar
>>  1 Introducción
>>             2
>>  2 ¿Qué es Sugar?
>>             4
>>  3 ¿Qué es una Actividad Sugar?
>>             7
>>  4
>>             8
>> Programación
>>  5 Instalar el entorno de desarrollo.
>>  6 Crear tu primer Actividad Sugar
>>  7 Un programa Python autónomo para leer etexts
>>  8 Heredar una Actividad desde sugar.activity.Activity
>>  9 Empaquetar tu Actividad
>>  10 Agregar detalles
>>    h1 { margin-top: 0.78cm; margin-bottom: 0.11cm; color: rgb(0, 0, 0);
>>    background: none repeat scroll 0% 0% transparent; line-height: 100%; text-
>>    align: left; orphans: 2; page-break-after: auto; }h1.western { font-family:
>>  11
>>    "Liberation Sans"; font-size: 17pt; }h1.cjk { font-family: "DejaVu
>> Sans"; font-
>>    size: 12pt; font-weight: normal; }h1.ctl { font-family: "DejaVu Sans"; font-
>>    size: 12pt; font-weight: normal; }p { margin-bottom: 0.21cm; }
>>  12 Internacionalizarse con Pootle
>>  13 Distribuir tu Actividad
>>
>> Notice that chapter 4 has no title at all, and chapters 10 and 11 seem
>> to be displaying style information where the chapter titles should be.
>>  I thought this might be an issue with the custom style sheet I was
>> using, but it does the exact same thing with the default style sheet.
>>
>> Here is a link to the generated PDF using the default style sheet:
>>
>> http://objavi.flossmanuals.net/books/comohacerunaactividadsugar-en-2011.06.17-22.23.48.pdf
>>
>> This is the link to edit and publish the manual:
>>
>> http://booki.flossmanuals.net/como-hacer-una-actividad-sugar/edit/
>>
>> It looks like there are several problems with the PDF.  The section
>> contents for ACTIVIDADES SUGAR has no chapters listed in it.  Same
>> thing for PROGRAMACIÓN.  On page 22 a heading is overlaid on top of
>> the following paragraph.  Similar problem on page 30.  None of the
>> chapters in the body of the document have numbers.  Page 77 is missing
>> a screenshot.  Same for page 87 and 91 and 96.  (Maybe the links to
>> pictures point to the wrong place.  That might be a problem with the
>> translators using Booki incorrectly).
>>
>> I hope we can straighten this out quickly.  Ana and her team have done
>> what looks to be a terrific job.  They even put in footnotes
>> explaining my lousy jokes.  You can't ask for that kind of dedication.
>>
>> Thanks,
>>
>> James Simmons
>>
>