[prev in list] [next in list] [prev in thread] [next in thread]
List: olpc-library
Subject: Re: [OLPC library] new bugs, old bugs,
From: "Anne Gentle | Just Write Click" <annegentle () justwriteclick ! com>
Date: 2008-11-30 20:08:59
Message-ID: 1a4c3e670811301208o2317ba89ne342ed21d2ab5b4e () mail ! gmail ! com
[Download RAW message or body]
[Attachment #2 (multipart/alternative)]
>
>
> http://en.flossmanuals.net/OLPC_simple aka "Introducing the XO" is a
> fine manual that describes the 7.1.0 software. According to
> http://wiki.laptop.org/go/Manuals :
> This is the manual for the 7.1.0 or "ship.2" release (builds
> 650-653) that most G1G1 2007 users received on their XO laptops.
>
> Is there some way to put this information on each page, or at least at
> the start of it?
>
That manual is deprecated so the best action would probably be to remove
links to
http://en.flossmanuals.net/OLPC_simple or perhaps have it redirect. Or Adam
Hyde, do you have a better idea?
> I clicked [Edit this page] and I go to an oops URL that displays just
> "Attention". But maybe there's some other Flossmanuals interface to put
> a header or footer on each page, or to change the title to "Simple
> introduction to the XO for Release 7.1.0"
>
Yep, same for me - due to our attempt to "hide" the old manual content.
>
> Also, the _VIEW ALL & PRINT_ link takes you to
> http://en.flossmanuals.net/OLPC_simple/print , in which half the images
> are broken links.
>
> Thanks for any suggestions,
> --
> =S Page
>
My preference would be to go through wiki.laptop.org and remove references
to that manual, but I'm open to suggestions as well.
>
>
> ------------------------------
>
> Message: 2
> Date: Sun, 30 Nov 2008 02:07:30 -0800
> From: S Page <info@skierpage.com>
> Subject: [OLPC library] new bugs, old bugs in the manual/PDF
> To: OLPC Library <library@lists.laptop.org>
> Message-ID: <493265E2.5090506@skierpage.com>
> Content-Type: text/plain; charset=ISO-8859-1; format=flowed
>
> quoth Anne Gentle:
>
> > I'd personally prefer that you use the FLOSS Manuals wiki system to
> > either go ahead and make the changes yourself, or comment on the
> > chapter that you have suggestions for, or email your comments to
> > either me or this list.
>
> Taking the lastest, easiest way first,
>
> In http://www.laptop.org/8.2.0/manual/Sugar_InstallingActivities.html
> and in the Help version 10 activity (but not in
> http://en.flossmanuals.net/publish/PDF/g1g1_2.pdf [**]) , step 7 is:
> "In the Frame, click the Journal to launch the Journal Activity.
> <
> http://www.laptop.org/8.2.0/manual/Sugar/Journal/resized_300x19_journal_launch.jpg
> >
> "
> BUG: this .jpg file exists, but it's zero-length so you only see its name.
>
Ah, okay, good catch. There's a new non-G1G1 titled PDF - Adam Hyde, can you
replace that g1g1_2.pdf
<http://en.flossmanuals.net/publish/PDF/g1g1_2.pdf>with the newer
revision of the manual's pretty print PDF (or tell me how to
do it?) :)
>
> [**] I thought this PDF was the same as the online manual/Help activity,
> but the text of this chapter is quite different in the PDF! The HTML
> page says "r1.12 - 17 Sep 2008", the PDF says Created 11/11/2008". If
> the PDF is a more recent version, will laptop.org/manual and the Help
> activity be re-released? If the PDF is a different document, can
> someone please update http://wiki.laptop.org/go/Manuals with the truth
> of the matter?
>
So, the truth, the whole truth is, that the laptop.org/manual and PDF and
Help Activity should be synchronized. The PDF is likely the latest and
greatest since I just did a rebuild (and bought a new proof and had to have
my neighbor receive the shipment since I was travelling, etc etc etc.).
The single-source process is something like this: Someone makes an edit in
the FM source. I judge whether the edit is worth re-publishing for, and
which outputs need republishing to pick up the edits. I won't be
republishing the PDF until we need a new edition of the book. I will
republish for the Help Activity and laptop.org/manual though.
>
> I asked earlier:
> > --> Is the Help activity is the same as http://www.laptop.org/manual/ ?
> I think it is.
Yes, as long as they have been updated at nearly the same time.
>
> > --> is there a version number hidden in the manual?
> The source of the HTML/Help has a useful DOCNUMBER meta tag. The PDF
> document properties has only a Created date.
>
This sounds accurate to me.
>
> > --> what's the title of this manual?
> Nobody answered. In the wiki I'm calling it "the OLPC Manual / Help
> activity for Release 8.2.0". The PDF first page says "G1G1" in big
> letters.
>
The latest pretty-print PDF title now says OLPC LAPTOP USERS GUIDE. The PDF
with G1G1 on it should be considered out-dated.
>
> BUG: All the HTML pages are untitled because they have two <title> tags
> and the first one is blank.
>
I'll log this as a bug in trac.flossmanuals.net to have dev investigate
further. Thanks for pointing it out.
>
> BUG: The PDF's Title in document properties is "Untitled"
I'll log this as a request for enhancement at trac.flossmanuals.net.
>
>
> In the September thread "FLOSS Manuals visual presentation" I mentioned
> a bunch of issues, they're all still present. In
> http://dev.laptop.org/ticket/8513 I provided CSS that addressed some of
> them. Is there anything else I should do to ensure they and this new
> feedback is not forgotten? I'll transfer it to Trac bugs or
> Flossmanuals if it'll help.
>
Oh thanks for taking care of CSS work - hmm. Next action? I will use that
CSS in the next "publish" to the Help Activity. Do you, Seth or Mel have any
bandwidth to show me how to use git to "check in" the new HTML files (with
your new CSS?) Or if I attach new HTML to that ticket (8513), could you
re-package for the Help Activity.
Thanks so much for being another pair of eyes on all this repurposed
content. I always appreciate good quality checks on doc especially when
there are three outputs from the source.
Anne
>
>
> This is all minor stuff compared with the great content. E.g. this
> "Installing Activities" is far better than anything on the wiki, a lot
> of wiki pages should just refer and link to it.
>
> Regards,
> --
> =S Page
>
>
> ------------------------------
>
> _______________________________________________
> Library mailing list
> Library@lists.laptop.org
> http://lists.laptop.org/listinfo/library
>
>
> End of Library Digest, Vol 20, Issue 11
> ***************************************
>
--
Anne Gentle
email: annegentle@justwriteclick.com
blog: www.justwriteclick.com
[Attachment #5 (text/html)]
<div class="gmail_quote"><blockquote class="gmail_quote" style="border-left: 1px \
solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><br> <a \
href="http://en.flossmanuals.net/OLPC_simple" \
target="_blank">http://en.flossmanuals.net/OLPC_simple</a> aka "Introducing the \
XO" is a<br> fine manual that describes the 7.1.0 software. According \
to<br> <a href="http://wiki.laptop.org/go/Manuals" \
target="_blank">http://wiki.laptop.org/go/Manuals</a> :<br> This is the \
manual for the 7.1.0 or "ship.2" release (builds<br> 650-653) that most \
G1G1 2007 users received on their XO laptops.<br> <br>
Is there some way to put this information on each page, or at least at<br>
the start of it?<br>
</blockquote><div><br>That manual is deprecated so the best action would probably be \
to remove links to <br> <a href="http://en.flossmanuals.net/OLPC_simple" \
target="_blank">http://en.flossmanuals.net/OLPC_simple</a> or perhaps have it \
redirect. Or Adam Hyde, do you have a better idea? <br><br></div><blockquote \
class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt \
0pt 0.8ex; padding-left: 1ex;"> <br>
I clicked [Edit this page] and I go to an oops URL that displays just<br>
"Attention". But maybe there's some other Flossmanuals interface \
to put<br> a header or footer on each page, or to change the title to \
"Simple<br> introduction to the XO for Release 7.1.0"<br>
</blockquote><div><br>Yep, same for me - due to our attempt to "hide" the \
old manual content.<br> </div><blockquote class="gmail_quote" \
style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; \
padding-left: 1ex;"> <br>
Also, the _VIEW ALL & PRINT_ link takes you to<br>
<a href="http://en.flossmanuals.net/OLPC_simple/print" \
target="_blank">http://en.flossmanuals.net/OLPC_simple/print</a> , in which half the \
images<br> are broken links.<br>
<br>
Thanks for any suggestions,<br>
--<br>
=S Page<br>
</blockquote><div><br>My preference would be to go through <a \
href="http://wiki.laptop.org">wiki.laptop.org</a> and remove references to that \
manual, but I'm open to suggestions as well. <br> </div><blockquote \
class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt \
0pt 0.8ex; padding-left: 1ex;"> <br>
<br>
------------------------------<br>
<br>
Message: 2<br>
Date: Sun, 30 Nov 2008 02:07:30 -0800<br>
From: S Page <<a href="mailto:info@skierpage.com">info@skierpage.com</a>><br>
Subject: [OLPC library] new bugs, old bugs in the manual/PDF<br>
To: OLPC Library <<a \
href="mailto:library@lists.laptop.org">library@lists.laptop.org</a>><br>
Message-ID: <<a href="mailto:493265E2.5090506@skierpage.com">493265E2.5090506@skierpage.com</a>><br>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed<br>
<br>
quoth Anne Gentle:<br>
<br>
> I'd personally prefer that you use the FLOSS Manuals wiki system to<br>
> either go ahead and make the changes yourself, or comment on the<br>
> chapter that you have suggestions for, or email your comments to<br>
> either me or this list.<br>
<br>
Taking the lastest, easiest way first,<br>
<br>
In <a href="http://www.laptop.org/8.2.0/manual/Sugar_InstallingActivities.html" \
target="_blank">http://www.laptop.org/8.2.0/manual/Sugar_InstallingActivities.html</a><br>
and in the Help version 10 activity (but not in<br>
<a href="http://en.flossmanuals.net/publish/PDF/g1g1_2.pdf" \
target="_blank">http://en.flossmanuals.net/publish/PDF/g1g1_2.pdf</a> [**]) , step 7 \
is:<br> "In the Frame, click the Journal to launch the Journal Activity.<br>
<<a href="http://www.laptop.org/8.2.0/manual/Sugar/Journal/resized_300x19_journal_launch.jpg" \
target="_blank">http://www.laptop.org/8.2.0/manual/Sugar/Journal/resized_300x19_journal_launch.jpg</a>><br>
"<br>
BUG: this .jpg file exists, but it's zero-length so you only see its name.<br>
</blockquote><div><br>Ah, okay, good catch. There's a new non-G1G1 titled PDF - \
Adam Hyde, can you replace that <a \
href="http://en.flossmanuals.net/publish/PDF/g1g1_2.pdf" \
target="_blank">g1g1_2.pdf</a> with the newer revision of the manual's pretty \
print PDF (or tell me how to do it?) :)<br> </div><blockquote \
class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt \
0pt 0.8ex; padding-left: 1ex;"><br> [**] I thought this PDF was the same as the \
online manual/Help activity,<br> but the text of this chapter is quite different in \
the PDF! The HTML<br> page says "r1.12 - 17 Sep 2008", the PDF says \
Created 11/11/2008". If<br> the PDF is a more recent version, will <a \
href="http://laptop.org/manual" target="_blank">laptop.org/manual</a> and the \
Help<br> activity be re-released? If the PDF is a different document, can<br>
someone please update <a href="http://wiki.laptop.org/go/Manuals" \
target="_blank">http://wiki.laptop.org/go/Manuals</a> with the truth<br> of the \
matter?<br> </blockquote><div><br>So, the truth, the whole truth is, that the <a \
href="http://laptop.org/manual">laptop.org/manual</a> and PDF and Help Activity \
should be synchronized. The PDF is likely the latest and greatest since I just did a \
rebuild (and bought a new proof and had to have my neighbor receive the shipment \
since I was travelling, etc etc etc.). <br> <br>The single-source process is \
something like this: Someone makes an edit in the FM source. I judge whether the edit \
is worth re-publishing for, and which outputs need republishing to pick up the edits. \
I won't be republishing the PDF until we need a new edition of the book. I will \
republish for the Help Activity and <a \
href="http://laptop.org/manual">laptop.org/manual</a> though. <br> \
</div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, \
204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><br> I asked earlier:<br>
> --> Is the Help activity is the same as <a \
href="http://www.laptop.org/manual/" \
target="_blank">http://www.laptop.org/manual/</a> ?<br> I think it \
is.</blockquote><div><br>Yes, as long as they have been updated at nearly the same \
time.<br><br></div><blockquote class="gmail_quote" style="border-left: 1px solid \
rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"> <br>
<br>
> --> is there a version number hidden in the manual?<br>
The source of the HTML/Help has a useful DOCNUMBER meta tag. The PDF<br>
document properties has only a Created date.<br>
</blockquote><div><br>This sounds accurate to me. <br> </div><blockquote \
class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt \
0pt 0.8ex; padding-left: 1ex;"><br> > --> what's the title of this \
manual?<br> Nobody answered. In the wiki I'm calling it "the OLPC \
Manual / Help<br> activity for Release 8.2.0". The PDF first page says \
"G1G1" in big letters.<br> </blockquote><div><br>The latest pretty-print \
PDF title now says OLPC LAPTOP USERS GUIDE. The PDF with G1G1 on it should be \
considered out-dated.<br> </div><blockquote class="gmail_quote" \
style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; \
padding-left: 1ex;"> <br>
BUG: All the HTML pages are untitled because they have two <title> tags<br>
and the first one is blank.<br>
</blockquote><div><br>I'll log this as a bug in <a \
href="http://trac.flossmanuals.net">trac.flossmanuals.net</a> to have dev investigate \
further. Thanks for pointing it out. <br> </div><blockquote class="gmail_quote" \
style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; \
padding-left: 1ex;"> <br>
BUG: The PDF's Title in document properties is \
"Untitled"</blockquote><div><br>I'll log this as a request for \
enhancement at <a href="http://trac.flossmanuals.net">trac.flossmanuals.net</a>. \
<br> </div> <blockquote class="gmail_quote" style="border-left: 1px solid \
rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><br> <br>
In the September thread "FLOSS Manuals visual presentation" I mentioned<br>
a bunch of issues, they're all still present. In<br>
<a href="http://dev.laptop.org/ticket/8513" \
target="_blank">http://dev.laptop.org/ticket/8513</a> I provided CSS that addressed \
some of<br> them. Is there anything else I should do to ensure they and this \
new<br> feedback is not forgotten? I'll transfer it to Trac bugs or<br>
Flossmanuals if it'll help.<br>
</blockquote><div><br>Oh thanks for taking care of CSS work - hmm. Next action? I \
will use that CSS in the next "publish" to the Help Activity. Do you, Seth \
or Mel have any bandwidth to show me how to use git to "check in" the new \
HTML files (with your new CSS?) Or if I attach new HTML to that ticket (8513), could \
you re-package for the Help Activity. <br> <br>Thanks so much for being another pair \
of eyes on all this repurposed content. I always appreciate good quality checks on \
doc especially when there are three outputs from the source. \
<br><br>Anne<br> <br></div><blockquote class="gmail_quote" style="border-left: \
1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"> <br>
<br>
This is all minor stuff compared with the great content. E.g. this<br>
"Installing Activities" is far better than anything on the wiki, a lot<br>
of wiki pages should just refer and link to it.<br>
<br>
Regards,<br>
--<br>
=S Page<br>
<br>
<br>
------------------------------<br>
<br>
_______________________________________________<br>
Library mailing list<br>
<a href="mailto:Library@lists.laptop.org">Library@lists.laptop.org</a><br>
<a href="http://lists.laptop.org/listinfo/library" \
target="_blank">http://lists.laptop.org/listinfo/library</a><br> <br>
<br>
End of Library Digest, Vol 20, Issue 11<br>
***************************************<br>
</blockquote></div><br><br clear="all"><br>-- <br>Anne Gentle<br>email: <a \
href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a><br>blog: \
<a href="http://www.justwriteclick.com">www.justwriteclick.com</a><br>
_______________________________________________
Library mailing list
Library@lists.laptop.org
http://lists.laptop.org/listinfo/library
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic