Opened 6 years ago

Last modified 6 years ago

#7898 reopened defect

Sugar Activity handbook should not be in PDF

Reported by: skierpage Owned by: ChristophD
Priority: low Milestone: 8.2.0 (was Update.2)
Component: library Version: not specified
Keywords: joyride-2273:- csafor8.2 Cc: morgs, holt, sj, cscott, brian, isforinsects
Blocked By: Blocking:
Deployments affected: Action Needed: never set
Verified: no

Description

Browse > OLPC Library > activities > find activities > "Making your own activities" has a link to "Sugar Activity Handbook"

This should be an HTML document. A partial list of the problems (this is Read 49 on joyride-2273):

  • The Browse-download-Journal-run-Read dance is irritating, and until #6729 is fixed it saves multiple copies of the PDF in the journal
  • The many blank even pages (2, 4, 8, 16, 26 ...) are silly in an e-book.
  • The acres of whitespace on chapter pages are wasted; clicking the arrow to advance to a chapter page puts me at a blank screen with part of a number in the lower left corner.
  • The uneven left-right page gutters are distracting
  • It breaks concentration to have a page break in the middle of a paragraph
  • The page margins are arbitrary. Every third PgDn leaves me showing the bottom of one page and the top of the next, i.e. a lot of white.
  • The hyperlinks e.g.QEMU on Windows p 18 don't work, and even if they did you'd leave Read and lose back-forward.
  • Unless each "page" is exactly one XO screen (as in a presentation or flash card), the "page 13" metaphor is mismatched with e-book reading. If you use the prominent Back Forward arrows, you skip over most of the content!

etc. The margins and blank pages might be fixable by tweaking the generation process, but a PDF in Read on an XO of an electronic document doesn't have anything going for it besides embedded fonts. In HTML in Browse is MUCH better. There are samples on the Web that show book-like high-quality display done with HTML and CSS, e.g. http://www.alistapart.com/articles/boom

Change History (12)

comment:1 Changed 6 years ago by morgs

  • Cc morgs added

comment:2 Changed 6 years ago by sj

  • Cc holt added
  • Owner changed from sj to ChristophD

sensible comments... let's see if we can get an html version out of the docsprint!

comment:3 follow-up: Changed 6 years ago by ChristophD

  • Priority changed from normal to low

As a short-term fix the handbook is also available as a pdf-download without the alternating margins (which is meant for print-purposes only) and the current state of things has also been wikified on olpc.at:

Also tried producing a DjVu version but failed to finish it due to lack of resources.

If anyone wants to go ahead and run with it then I'd be more than happy to provide them with the DocBook / XML files. Realistically I won't be able to take care of this in the weeks ahead.

@holt: It would be awesome to do all this at the BookSprint but I'd suggest to not overstretch our limited time-resources.

comment:4 in reply to: ↑ 3 ; follow-up: Changed 6 years ago by skierpage

Replying to ChristophD:

The version at that URL (2008-05-19 595kB) seems way better than the 2007-11-02 2.1MB sugar-handbook.pdf that ships with the software in /usr/share/activities/bundle-archive/ ! Not only does it fix the margin and blank pages, but it's smaller while having extra chapters 4-7. It works fine in Read on 8.2-757.

In the absence of the re-generated docbook HTML I see no reason not to update sugar-handbook.pdf. Should I file a separate bug?

comment:5 in reply to: ↑ 4 Changed 6 years ago by ChristophD

Replying to skierpage:

In the absence of the re-generated docbook HTML I see no reason not to update sugar-handbook.pdf. Should I file a separate bug?

Yes, I think that would make a lot of sense. Not sure who is responsible for maintaining the library but I assume it SJ.

comment:6 Changed 6 years ago by cscott

  • Cc sj cscott added
  • Keywords csafor8.2 added

Can we get a new .xol built for this, please?

comment:7 Changed 6 years ago by holt

  • Cc brian isforinsects added

comment:8 Changed 6 years ago by isforinsects

  • Resolution set to fixed
  • Status changed from new to closed

This has been depreciated in the latest release. The PDF will not be included.

See Help-5.xo

comment:9 Changed 6 years ago by cscott

  • Resolution fixed deleted
  • Status changed from closed to reopened

The activity handbook is not the same thing as the help activity.

Quoting Christoph from mail:

Why is the Activity Handbook depreciated? And what's the connection to
the help activity? The Activity Handbook (just like the Sugar Almanac)
is targeted at people who are interested in developing activities for
the Sugar platform ("learning C# in 21 days") while the Help-activitiy
is all about being a user's manual.

What am I missing?

Christoph

comment:10 Changed 6 years ago by cscott

  • Summary changed from Sugar handbook should not be in PDF to Sugar Activity handbook should not be in PDF

comment:11 follow-up: Changed 6 years ago by ChristophD

So am I getting this right, the core issue here is the Activity Handbook being a .pdf which means it can't be included in the builds?

I think a more reasonable approach is following skierpage's latest comment: "In the absence of the re-generated docbook HTML I see no reason not to update sugar-handbook.pdf."

As previously mentioned a quick'n'dirty wikified version of the Activity Handbook is also available at but it ain't as pretty or useable as the .pdf version.

comment:12 in reply to: ↑ 11 Changed 6 years ago by skierpage

Replying to ChristophD:

So am I getting this right, the core issue here is the Activity Handbook being a .pdf which means it can't be included in the builds?

sugar-handbook.pdf was in /usr/share/activities/bundle-archive along with obsolete .xo bundles, all linked from its "Activity and Library Bundles" index web page. I believe as part of fixing bug #8029 the entire /usr/share/activities/ directory is gone, which resolves some other content bugs but means all library content is gone from the build. No more "Les jeux de plage" music from Ehma either :-)

I believe that you can package a PDF in a .xol content bundle, list it at http://wiki.laptop.org/go/Collections aka "Library Grid" for download, and even nominate it in response to Greg Smith's message "G1G1v2 Activities" that requested nominations for "activities we ship with 8.2 when its manufactured for G1G1 users". But I'm just a dog on the Internet.

Note: See TracTickets for help on using tickets.